开源编程智能体,可在终端、桌面、浏览器或编辑器中读取项目、编辑文件并运行测试。
- Star
- 1,145
- Fork
- 86
- 未关闭 Issue
- 19
- 最近提交
- 13小时前
这是什么?
天枢 Harness 是一个用 TypeScript 编写的编程智能体运行时,终端 TUI、桌面端和 VS Code 插件共用同一个内核。它在模型与项目之间加入一层名为 CVM(认知虚拟机)的执行环境,把任务目标、状态、证据、权限和终止条件交由运行时管理,而不只依赖对话历史。
核心流程围绕每个任务的契约和名为 deliver_task 的交付门展开:只有测试结果、代码差异或验证命令作为证据时才会判定完成,否则交付会被拦下。运行时在每个回合的五个阶段挂接检测逻辑,用于识别循环、空转的工具调用和编辑失败;`/cockpit` 驾驶舱则展示验证、成本与缓存命中等指标。
项目内置 25 个模型服务商预设,也支持任意 OpenAI 兼容端点。此外还提供子代理命令、前缀缓存引擎、计划模式、MCP 与 Skills 支持,以及带沙箱写边界和路径穿越防护的权限系统。
核心功能
- 01每个任务有独立契约,记录目标、范围与成功标准,不依赖对话记忆。
- 02交付门根据测试、代码差异和验证证据给出 GREEN、YELLOW 或 RED 状态。
- 03运行时在每个回合检测收敛问题、空转循环与编辑失败。
- 04内置 25 个模型服务商预设,并支持 OpenAI 兼容端点。
- 05终端 TUI、桌面端和 VS Code 插件共用同一个智能体内核。
- 06提供三档权限模式、沙箱写边界,并保护敏感文件与破坏性命令。
适用场景
- 在代码仓库中执行多步编程任务,并要求以测试结果作为交付依据。
- 在终端编程流程中接入 DeepSeek 或其他 OpenAI 兼容模型。
- 通过脚本或 CI 以无头模式运行智能体,获取 NDJSON 事件流。
- 监控长时间编程会话的 token 成本与前缀缓存命中率。
快速上手
- 1
使用 npm 全局安装终端 CLI(需要 Node.js 24+)
npm install -g tianshu-harness - 2
运行 tianshu 启动 CLI,等待提示符出现;首次启动会打开 /connect 配置向导
tianshu
使用前须知
- 桌面端在 macOS 上尚未完成 Apple 公证,首次打开可能需要手动执行 xattr 命令。
- Linux 桌面端需要 glibc 2.35+ 和 WebKit2GTK,Wayland 尚未验证。
- 缓存与成本的实测数据仅来自 DeepSeek 的真实会话,行为对照只是 5 个任务的小样本试点。
收录于专题
标签
常见问题
- Tianshu-harness 是什么?
- 面向编程智能体的认知运行时,终端与桌面端共用内核,通过证据门控交付任务。 天枢 Harness 是一个用 TypeScript 编写的编程智能体运行时,终端 TUI、桌面端和 VS Code 插件共用同一个内核。它在模型与项目之间加入一层名为 CVM(认知虚拟机)的执行环境,把任务目标、状态、证据、权限和终止条件交由运行时管理,而不只依赖对话历史。
- Tianshu-harness 可以免费使用吗?用的什么许可证?
- Tianshu-harness 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
- Tianshu-harness 还在维护吗?
- 活跃维护中。Tianshu-harness 最近一次提交是在 2026年10月22日。
- Tianshu-harness 适合用来做什么?
- 在代码仓库中执行多步编程任务,并要求以测试结果作为交付依据。 在终端编程流程中接入 DeepSeek 或其他 OpenAI 兼容模型。 通过脚本或 CI 以无头模式运行智能体,获取 NDJSON 事件流。 监控长时间编程会话的 token 成本与前缀缓存命中率。
- Tianshu-harness 怎么安装和运行?
- 使用 npm 全局安装终端 CLI(需要 Node.js 24+): npm install -g tianshu-harness 运行 tianshu 启动 CLI,等待提示符出现;首次启动会打开 /connect 配置向导: tianshu
- 在哪里获取 Tianshu-harness?
- 源代码和安装说明在 GitHub 上:https://github.com/huiliyi37/Tianshu-harness
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一款命令行工具,可直接打开 OpenCode、Claude Code 等编程智能体,并自动接入指定的托管或本地开源模型。
一个极简、可扩展的 AI Agent 框架,包含统一的多厂商 LLM API、Agent 运行时、终端 UI 和编程 Agent 命令行工具。
一款开源的终端 AI 编程智能体,并提供桌面端、Web、编辑器和即时通讯等入口。
Pi 编程智能体的提前编译版本,编译为原生代码,启动更快、CPU 占用更低。
专为 DeepSeek 模型优化的终端 AI 编码助手,支持深度思考、推理强度控制与 MCP 集成。