文档
核心概念
FSM 编排、人审门禁、沙箱执行与产物契约。
FSM 编排
Approving 把 coding agent 变成工作流里的步骤。你在有限状态机上编排:
- 节点即状态(agent / react / gate / …)
- 边即转移,可配置成功、失败、回滚路径
- 可用
when守卫、检查点,把风险步骤显式化
不再是无法撤销的一次性 Agent 跑法:先设计路径,再门禁关键步骤。
人审门禁(gate)
当某一步需要人做决定时,运行会停在 gate,直到有人批准或拒绝。
批准时刻是一等公民,而不是事后补丁。产品名 Approving 的赌注是:Agent 可以很快,但关键决策仍由人拥有。
真实 Docker 沙箱
Agent 不是在笔记本上跑的黑盒 prompt。它们通过仓库内嵌的 sandbox-gateway 在 Docker 容器中执行,经 ACP 通信。
支持 Cursor、Claude Code、CodeBuddy、Trae。按 Agent 配置 acpBackend;密钥放在 Agent meta env。
产物契约与 MCP
每个 run 有隔离的 artifact MCP。Agent 调用例如:
write_artifactset_*node_complete
按 run token 隔离,留下可检查的纸面轨迹。
单仓自托管
sandbox-gateway 与通用沙箱镜像源码在本仓库。一次克隆即可自托管。