天枢 Tianshu Harness：终端编程智能体运行时

项目简介

天枢（Tianshu Harness）是一个用 TypeScript 编写的编程智能体运行时，终端 TUI、桌面端和 VS Code 插件共用同一个内核。它关注的核心问题是：模型何以稳定地交付——目标不漂移、完成有证据、验证有闭环，而不是最后留下一句「应该修好了」。

为此它在模型与真实世界之间加了一层认知执行环境 CVM（Cognitive Virtual Machine），把目标、状态、证据、权限和终止条件从对话历史中外部化，交给运行时持续管理。官方称其对 DeepSeek V4 做了极度优化。开发代号为 Rivet，CLI 主命令是 tianshu，rivet 是同一入口的兼容别名。

主要功能

• 任务契约：每个任务有独立的 TaskContract，记录目标、范围、约束和成功标准，长会话中的目标由运行时持有，不依赖模型「记得」。
• 交付门：deliver_task 只做归属限定的安全提交，所有权、跨会话冲突、版本一致性不合格会被拦下；定向验证用 run_tests，独立审查用 review_changes 或 /review。
• 确定性监督外环：75 个运行时 hook 模块分布在 preTurn、afterPerception、postTool、postTurn、postSession 五个阶段，配合 Sensorium 状态感知、收敛与空转检测做观测和纠偏。
• 驾驶舱 /cockpit：8 面板运行时仪表，可看验证与交付、提醒台账、缓存命中与成本、风险与空转。
• 前缀缓存优先：会话内冻结前缀、只追加增量，官方给出 5 个真实长会话 99.3–99.6% 缓存命中率的实测数据。
• 星域：十六星域各有自己的信念块与勇气阈值，用来改变同一个模型的工作倾向。
• 无头模式：支持 -p 单次提示、--stream-json NDJSON 事件流、--goal 目标驱动续跑，可接入脚本与 CI。
• 内置 25 项模型服务商预设，另支持 OpenAI 兼容端点。

安装与使用

终端 CLI 需要 Node.js 24.x ≥ 24.22.1 或 26.x ≥ 26.12.1：

npm install -g tianshu-harness
tianshu

看到 〉 提示符即就绪，首次启动会自动打开 /connect 向导，选择服务商并粘贴 API Key。

桌面端可从 Releases 下载，自带运行时、无需安装 Node：macOS 11+ 的 .dmg（Apple Silicon / Intel）、Windows 10 1809+ / 11 的 -setup.exe、Linux x86_64 / aarch64 的 .AppImage。

常用示例：

tianshu -p "解释 src/agent/loop.ts"
tianshu --goal "修复所有类型错误" --budget 50

注意事项

• CLI 有 Node.js 版本硬门槛，Node 22 / 23 / 25 / 27 会在启动时被安全闸门拒绝，安装前先运行 node -v。
• macOS 桌面端暂未 Apple 公证，首次打开提示「已损坏」时，把应用拖入「应用程序」后执行 xattr -cr /Applications/Tianshu.app。
• Windows 桌面端界面依赖 WebView2，安装器自带离线包；Linux 需要 glibc 2.35+、libwebkit2gtk-4.1 与 libgtk-3，推荐 X11 会话。
• 默认权限档为自动：低风险动作直接执行，高风险动作会停下来询问。
• 许可证为 Apache-2.0。

本作品整理自 GitHub 开源项目 huiliyi37/Tianshu-harness，原作者 @huiliyi37，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。