Repolode
huiliyi37

huiliyi37/Tianshu-harness

面向编程智能体的认知运行时,终端与桌面端共用内核,通过证据门控交付任务。

可替代:Claude Code

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. 1

    使用 npm 全局安装终端 CLI(需要 Node.js 24+)

    npm install -g tianshu-harness
  2. 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 数据每日更新。

相关项目