文档

核心概念

FSM 编排、人审门禁、沙箱执行与产物契约。

FSM 编排

Approving 把 coding agent 变成工作流里的步骤。你在有限状态机上编排:

  • 节点即状态(agent / react / gate / …)
  • 即转移,可配置成功、失败、回滚路径
  • 可用 when 守卫、检查点,把风险步骤显式化

不再是无法撤销的一次性 Agent 跑法:先设计路径,再门禁关键步骤。

人审门禁(gate)

当某一步需要人做决定时,运行会停在 gate,直到有人批准或拒绝。

批准时刻是一等公民,而不是事后补丁。产品名 Approving 的赌注是:Agent 可以很快,但关键决策仍由人拥有。

真实 Docker 沙箱

Agent 不是在笔记本上跑的黑盒 prompt。它们通过仓库内嵌的 sandbox-gateway 在 Docker 容器中执行,经 ACP 通信。

支持 CursorClaude CodeCodeBuddyTrae。按 Agent 配置 acpBackend;密钥放在 Agent meta env。

产物契约与 MCP

每个 run 有隔离的 artifact MCP。Agent 调用例如:

  • write_artifact
  • set_*
  • node_complete

按 run token 隔离,留下可检查的纸面轨迹。

单仓自托管

sandbox-gateway 与通用沙箱镜像源码在本仓库。一次克隆即可自托管。