4.7 KiB
Agent Note: 将具名会话模式收敛为 plan mode
Status: implemented
English | 中文
问题
产品只交付了 plan，首个 plan mode 实现却引入了通用的具名模式注册表。ModeConfig.modes、定义名称校验、ctx.modes.list()、已退役定义的回退逻辑，以及测试中合成的 review 模式，都只为支持假想中的未来协作模式而存在。plan 引导、/plan 和 exit_plan_mode 这些生产专用行为仍位于同一个包（package）内，因此通用 API 并未将可复用机制与 plan 策略隔离开来。
「mode」一词还横跨互不相关的领域。沙箱模式是由 ctx.sandboxPolicy 拥有、以 sandbox/mode 记录日志的强制执行策略；plan mode 则是一种协作方式，会贡献引导内容和经评审的退出路径。若把两者都视为同一个具名模式抽象的实例，就会掩盖二者各自独立的归属关系。传输协议的通用词汇并不能证明 harness 需要通用模式领域。
决策
Plan mode 拥有一个 plan 专用产品包：位于 packages/plan/plan-mode/ 的 @deepseek-ai/dsh-plan-mode。持久化事实为 plan/mode: { active: boolean }，由 foldPlanMode(events) 折叠，空日志值为 false。ctx.planMode.get(agent) 返回 { active, pending? }，set(agent, active) 则记录在边界生效的选择。现有的提示词提交、continuation、重试、追加失败和 dispose（资源释放）栅栏在语义上保持不变。
配置严格为 { section: string }。该包自行注册固定的 plan:policy 段、/plan [message]、精确匹配的 /plan off 主动退出形式，以及 exit_plan_mode。不带参数的 /plan 选择激活；其他非空参数则先选择激活，再通过 agent.steer() 发送去除首尾空白后的文本，使该文本在受影响的步骤中成为一条记录到日志的普通用户消息。/plan off 选择未激活，不产生模型输入，并可取消仍待在边界生效的进入选择。即使 plan mode 未激活，退出工具仍保持注册，以确保请求工具目录稳定。
面向人类的组合拥有 plan 选择与评审。ACP 自动化组合既不挂载 plan mode，也不提供模式选择协议，因此其传输层不会扩大这套产品专用词汇。
沙箱模式与审批策略仍是彼此独立的强制约束轴。Plan mode 既不读取也不写入二者；此次简化也没有为这些概念引入共享基类型、注册表或预设抽象。
删除的接口
- 任意定义映射、模式名正则表达式、保留名称规则以及逐定义命令循环。
ModeDefinition、解析后的定义映射、ctx.modes.list()、字符串值的 get/set 状态，以及未知或已退役模式处理。- 仅用于测试的
review模式用例，以及可通过配置添加其他模式的表述。 - 通用的
mode/set与mode:policy名称；plan 包拥有plan/mode与plan:policy。
考虑过的替代方案
保留私有的通用注册表，目前只暴露 plan。 不予采纳，因为没有第二个生产消费方时，仍需维护和测试未使用的名称与配置机制。未来若出现另一种协作状态，可以从两个具体案例出发建立合适的共享 seam。
将沙箱模式折叠进同一服务。 不予采纳，因为协作引导与执行约束有不同的归属方、生命周期语义和消费方。二者的英文名称都含「mode」，不代表存在领域关系。
让一种呈现传输拥有 plan 状态。 不予采纳，因为 TUI、Web、恢复、fork、提示词组装和退出工具都需要独立于任何单一传输使用同一项已记录事实。呈现适配器只拥有各自的投影。
验证
- 包测试通过布尔服务继续覆盖边界顺序、重试、追加失败、HMR（热模块替换）资源释放、提示词组装、稳定的原生 schema 与 Code Mode schema、评审结果和不变式。
- 命令测试覆盖不带参数的
/plan、/plan <message>、激活状态下的/plan off、取消待生效的进入选择、未激活状态下的幂等性、不存在/mode和/review，以及随 effect 作用域移除。 - 无密钥 TUI 场景通过
/plan <message>进入、通过/plan off退出，并证明每个已提交的plan/mode都先于其所改变的请求头，进入消息在 plan 引导下记录到日志，且退出后的请求不含该引导。
后果
该实现只用一套词汇描述一项已交付功能。若要添加另一种协作方式，必须显式作出设计决策，而不能只增加配置项；自动化客户端不会通过 ACP 获得面向人类的模式控制。根据仓库的预发布格式策略，本次迁移有意拒绝旧的 mode/set 日志与 modes.plan.section 配置。