天枢 · Tianshu

天枢是一个可治理、可验证、持续成长的自进化 Agent OS。

A governable, verifiable Agent OS designed to learn and evolve continuously.

English · 当前实现 · 快速开始 · 能力事实矩阵

产品一览

天枢把任务执行、协同决策、知识联络、实验成长和系统治理放进同一个可审计工作区。 以下页面均来自当前真实实现；成熟度标记描述当前支持边界，不代表发布承诺。 查看完整功能图鉴 → · 查看当前实现与验证状态 →

中枢总览 · 可用
_{以真实运行数、待裁决与证据闭环呈现治理态势，并直达四项独特能力。}

任务与治理

御书房 · 可用 集中查看立即、定时、长程、对话与客卿任务，以及最近执行事实对应的进度。	颁发敕令 · 可用 选择任务类型、执行方式、承办官员与预算，在一个表单中下达任务。
长程任务治理 · 可用·有限边界 用验收条件、检查点、暂停与恢复、运行中指引和人工裁决管理长任务。	钦天监 · 可用 管理单次、Cron 与间隔排期，查看下次执行、状态和运行历史。
都察院 · 可用 汇总审计、失败归因、策略与网络记录，让任务行为和证据可追溯。

协同与知识

百官阁 · 可用 配置官员职责、部门、路由、委派、工具权限、技能与模型。	廷议与内阁 · 可用 廷议组织多官员会商；内阁以只读视图呈现规划分派与协同历史。
翰林院与通政体系 · 可用·有限边界 翰林院管理知识记忆，鸿胪寺承载外部联络，通政司统一消息与通知。

天工院〔实验〕

天工院以「位面」呈现实验空间；演化司、考功司与客卿馆分别承载演化治理、评测和外部 Agent 试验。

位面 · 实验 通过位面谱系隔离实验分支、代码候选、评测、归档与恢复。	演化司 · 实验 以只读视图查看技能候选、证据门禁、灰度分流、晋升与回滚状态。
考功司 · 试行 管理评测集并比较得分、成功率、失败分布与历史差异。	客卿馆 · 实验 从当前环境探测 Pi 等外部编码 Agent 的版本、能力、可用性与治理状态。

系统与成本

藏兵阁与权印司 · 可用·管理能力 集中管理模型、工具、Skills、插件和凭证，并配置可复用的会话授权规则。

户部账房 · 可用·有限边界 查看 Token、Provider 成本、缓存用量和预算，并维护价格口径。

架构总览

天枢把一次任务组织为一条可审计的核心闭环：下旨（Edict）→ 排期（Scheduler）→ 规划 （Planner）→ 执行（Agent/DAG/Outer Loop）→ 审计（Auditor）→ 通知（Notifier）→ 记忆与 成长（Memory/Profile/Skill）。敕令可通过 Web、API、CLI、飞书或 Telegram 下达，系统把 目标转成可调度、可审计、可裁决、可复盘的执行链路。长程任务不依赖 LLM「一次输出即 终态」，而由外层循环反复 actor→checks→critic→completion audit，直到验收通过或预算 耗尽。架构设计、领域模型与各子系统文档见文档导航。

能力成熟度

天枢把「敕令（Edict）→ 裁决（Decision）→ 运行 → Evidence → 技能候选 → 门禁 → 分流 → 回滚」组织成一条可复验的本地链路。当前代码与阶段证据覆盖以下能力：

• 可治理：受管 Native 路径使用持久 Decision、RunState、attempt lease/fencing 和 effect intent/receipt；已声明且进入账本的恢复边界可耐单节点重启。
• 可验证：SystemAudit 防篡改链、内容寻址 ArtifactStore 与 Evidence Bundle v1 记录行为、裁决、产物和边界；严格 verifier 会重算 hash 并核对源码与 exact Wheel。
• 持续成长：技能候选经过证据绑定的门禁、真实 canary assignment 和 effective overlay，再由受控回滚把新流量归零；完整的自进化闭环仍属实验能力。
• 真实桌面产品：默认导航为中枢、御书房、朝堂、百司、天工院〔实验〕、内府六个 一级入口。 御书房以“全部敕令 / 颁发敕令 / 钦天监 / 都察院”统一承载任务、定时调度与审计； 朝堂包含吏部、廷议、内阁，百司包含翰林院、鸿胪寺、通政司。天工院集中展示演化司、 诸界台、考功司、客卿馆，其中演化司、诸界台与客卿馆标记“实验”，考功司标记 “试行”；内府保留藏兵阁、权印司、户部账房。御书房默认展示当前主体可见且未归档的 全部任务，以可叠加标签区分立即、定时、长程、对话和客卿任务，并显示最新执行事实 对应的当前进度；旧 /edicts 地址兼容跳转到御书房。中枢以四张“独特能力”卡展示 长程治理、自进化、平行位面和客卿，其中自进化状态来自后端 evolution_status 的真实 投影，不以 mock 数字冒充能力。

以上能力均已在本地完成逐页、逐操作的网页功能点验与现场修复；逐项点击路径与 未验证边界见Web 全功能点验与修复报告。 历史阶段的完整验证流程与不可变证据归档于 docs/cc-fable-v1/； 逐项能力的成熟度结论见能力事实矩阵与 当前实现。

当前支持边界

• 首个正式目标：Ubuntu + Python 3.12，本地 desktop Web only；不提供移动端产品承诺。
• 已有本地证据：最近一次 exact-Wheel 完整验证运行于 Darwin/arm64/Python 3.12.12。这证明本机验证环境，不替代尚待执行的 Ubuntu 外部复验。
• 部署模型：单机、单节点 SQLite。宿主机管理员可读取数据库、主密钥和进程内明文， 因而不在当前威胁模型的防护对象内。
• 正式安装路径：PyPI（发行名 tianshu-agent-os）、源码 checkout 与同一 checkout 构建的 exact Wheel。PyPI 发布链路已就绪（tag 触发 Trusted Publishing），首个版本以 实际发布为准。官方容器、GHCR、签名和正式供应链 provenance 仍为 deferred。
• MCP：持久 env/header secret mapping 已密文落库；remote MCP 与 open stdio MCP 在当前支持面内保持 disabled，完整开放安全工作为 deferred。
• 演化边界：managed OpenHands、执行器兼容套件、ROI 与 cost calibration 均为 external_pending；更完整的自动化演化门禁为 deferred。

安装

一行安装（推荐）

pipx install tianshu-agent-os
tianshu serve

只想试一下、不在系统里留安装痕迹：

uvx --from tianshu-agent-os tianshu serve

打开命令提示的 http://127.0.0.1:8000 即可使用 Web UI——wheel 自带前端载荷，这条路径 不需要 Node.js。首次使用前给一个 LLM 凭证（如 export TIANSHU_LLM_API_KEY=sk-...）， tianshu doctor 可自检配置是否齐备。

发行名是 tianshu-agent-os：PyPI 上 tianshu 已被无关的第三方包占用。import tianshu 与 tianshu 命令均不受影响。推荐 pipx/uvx 而非 pip install——天枢是应用不是库，pipx 会把它装进独立环境并把 tianshu 挂上 PATH，不与其他包争抢 litellm/pydantic 版本；且较 新的 Ubuntu/Debian/Homebrew Python 是 externally-managed 环境（PEP 668），直接 pip install 会被拒绝。

从源码安装（开发者）

git clone https://github.com/MJ-CJM/tianshu.git
cd tianshu
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e .
cp .env.example .env   # 编辑 .env，填写 TIANSHU_LLM_API_KEY 等
cd web && npm install && npm run build && cd ..
tianshu serve

源码路径需要自行构建前端，因而要 Node.js >= 20。日常开发推荐一键脚本 ./scripts/local.sh start --dev（热重载 + 进程托管）；开发模式、环境变量 与部署说明见快速开始。 需要严格复验路径（exact Wheel 安装、黄金 Demo 与 provenance 校验）时，参见 Lean Developer Preview 使用指南。

能力状态

公开文档严格区分：

• implemented：已实现且有命名证据；
• disabled：当前支持面明确关闭并 fail closed；
• deferred：已记录恢复条件，本轮不交付；
• experimental：可试用，但协议或支持承诺尚未冻结；
• external_pending：缺少指定外部环境或时间窗证据。

当前工作树的功能结论和验证快照先看 当前实现；逐项默认值、保证、非保证和证据见 能力事实矩阵。延期工作的恢复条件见 延期路线图。

品牌与产品壳层

• 品牌资产：生产 desktop Web 使用 web/public/brand.png， SHA-256 为 3f2bb6cfdcac70092fce3a9b8b534c4a0627f444cb9db38a9651087688ace799。
• 格言：“成功只有一个——按照自己的方式，去度过人生。”
• 右上五项：“彩蛋 / 通用 / English / 实时 / 通政”。
• 一级导航：“中枢 / 御书房 / 朝堂 / 百司 / 天工院〔实验〕 / 内府”六个入口。
• 二级结构：
  • 御书房——全部敕令、颁发敕令、钦天监、都察院；
  • 朝堂——吏部、廷议、内阁；
  • 百司——翰林院、鸿胪寺、通政司；
  • 天工院——演化司〔实验〕、诸界台〔实验〕、考功司〔试行〕、客卿馆〔实验〕；
  • 内府——藏兵阁、权印司、户部账房。
• 任务入口：御书房统一承载全部任务、任务进度与待人工介入事项，/edicts 仅作 兼容跳转。

该产品结构已在当前版本落地；原 审批提案保留为决策过程记录，当前状态以 当前实现为准。

贡献与安全

贡献前请阅读 CONTRIBUTING.md 与 CODE_OF_CONDUCT.md；漏洞报告与单节点/宿主机管理员边界见 SECURITY.md。用户可见术语统一使用“敕令 / 裁决”；代码、API 与数据库为 兼容保留 Edict / Decree。

License

MIT License；所含或改编第三方材料的来源与许可证见 THIRD_PARTY_NOTICES.md。