fix(acp): tighten automation-only contracts

2026-07-24 01:51:20 +08:00
parent e819a586b0
commit 331e959c97
8 changed files with 17 additions and 25 deletions
@@ -26,11 +26,7 @@ ACP 仍有一个有用的职责：另一个 agent（智能体）或自动化控

 ## 快照边界

-ACP 快照套件保留面向后端的场景，并继续启动组装后的 ACP 示例。该重构保留 53 个场景，覆盖循环、工具、钩子、压缩（compaction）、subagent、文件系统、PTY、Code Mode、权限提升与持久化行为。原本描述已删除展示层的名称改为面向后端的名称（`bash-tool-turn` 和 `todo-write`）。
-
-删除七个场景，因为其脚本覆盖的是已删除的 ACP UI 控件：配置通告、模式通告、模型选择、权限预设选择、命令状态，以及通过选择器与询问流程实现的 plan mode 评审。它们所属的包仍保留专门的无密钥覆盖。语义检查点场景改用 headless `stream-json` 示例，不再使用 ACP。
-
-[`examples/acp-agent/tests/acp.snapshot.ts`](../../../../examples/acp-agent/tests/acp.snapshot.ts) 中的 FIXME 记录了明确的后续工作：将余下的后端测试集转移到 headless `stream-json` 套件，使 ACP 快照只负责自动化协议。该迁移独立实施，因为在本次变更中重写共享快照 harness 与每个 fixture（测试前置数据），会模糊本次协议精简的主线。
+ACP 快照套件仍会启动组装后的 ACP 示例，并保留用于锁定后端行为的场景。从该套件移出的只有通过已删除的 UI 方法驱动的场景；由于 ACP 不再加载会话，语义检查点恢复通过 headless `stream-json` 示例执行。

 ## 考虑过的替代方案

@@ -48,4 +44,4 @@ ACP 具有适合 agent 与自动化的精简契约，而 TUI 和 Web 拥有面

 自动化客户端收到完整的已提交文本，而不是 token 增量或结构化工具 UI。当它们需要推理、工具跟踪信息、标题或更丰富的状态时，需要查看持久日志或其他 API。只支持全新会话也意味着，需要浏览持久会话或恢复会话的调用方必须使用 host API，而不是 ACP。

-过渡期间仍可使用后端快照覆盖，但其传输方式暂时只是附带选择。FIXME 明确记录了这项技术债，又不会将本 PR（Pull Request）扩展为全仓库快照迁移。
+因此，后端快照覆盖仍与 ACP 传输层耦合，尽管对于受测行为而言，该传输层只是附带因素。