plan-mode 文案不一致

[democard]

[Bug 报告] plan-mode 指令文案在 base 层与 agent preset 间不一致："keep the request shape stable" vs "keep the tool catalog unchanged"

概述

同一段 plan-mode 指令（plan-mode 插件的 section 配置）在两个配置层中各自维护了一份拷贝，且其中一句已经漂移。逐字对比后确认：除下面这一句外，两段指令完全相同。

• dsh-base 层（cordis.patch.yml:272）：

  "…those tools remain listed only to keep the request shape stable."

• standard / code / cordis 三个 agent preset（config/agent-presets/*/agent.cordis.yml）：

  "…those tools remain listed to keep the tool catalog unchanged."

由于 Web 表面实际挂载 standard preset（web-app 补丁将 base 层的 plan-mode 行 disabled: true），而 headless 表面使用 base 层的版本，同一个模型在不同启动模式下会读到两个措辞不同的 plan-mode 指令。

影响面

• 行为差异：两句话表达的是同一意图（plan mode 下工具目录保持不变、规则优先于工具描述），但措辞不同——"request shape stable"偏请求形状（更贴缓存），"tool catalog unchanged"偏目录内容。模型对哪个更易遵循可能产生实际差异。
• 维护风险：这是同一逻辑两处复制粘贴维护的典型漂移点。本次是形容词差异，下一次可能是行为性差异；两处没有机制保证同步（没有 TODO/注释互相指向）。
• 实际影响：低-中。不是功能性 bug，但属于"同一产品不同入口给模型不同指令"的一致性问题，且影响 plan-mode 下所有会话的提示词前缀（与本仓库关注的 request-cache stability 直接相关）。

证据

四份文件中包含此句的精确位置（安装版本 @deepseek-ai/dsh@0.1.0-rc.6）：

文件	行	措辞
packages/boot/base/cordis.patch.yml（base 层）	272	…remain listed only to keep the request shape stable.
packages/agent-presets/config/agent-presets/standard/agent.cordis.yml	117	…remain listed to keep the tool catalog unchanged.
packages/agent-presets/config/agent-presets/code/agent.cordis.yml	125	…remain listed to keep the tool catalog unchanged.
packages/agent-presets/config/agent-presets/cordis/agent.cordis.yml	106	…remain listed to keep the tool catalog unchanged.

注：上表行号为本地安装包内位置，源码仓库中行号可能略有偏移，但文件路径与措辞差异可直接复现。

建议修复（供参考）

1. 统一为同一句（首选）：三处 preset 与 base 层统一措辞。保留哪句由维护者决定；若以"请求缓存稳定性"为设计动机，建议保留 base 层的 "only to keep the request shape stable"（更精确）；若以"工具目录不变"为用户可见语义，则统一为 preset 版。关键是四个文件必须逐字一致。
2. 消除复制粘贴（根治）：把 plan-mode section 文案提升为共享常量或从同一来源注入（例如由 plan-mode 插件提供默认 section，preset 只在需要覆盖时声明），避免两处手工同步。
3. 测试：可加一条"所有 agent preset 与 base 层 plan-mode section 文案一致性"的静态检查或单测，防止未来再次漂移。

补充说明

• 这是我在扫描 dsh-base 与 config/agent-presets/ 时逐字对比发现的，两处均无 TODO/注释提及此差异，属于"同一逻辑两处维护导致的无声漂移"。
• 与该差异直接相关的本仓库既有设计：plan-mode section 本身强调 "The tool catalog stays the same across modes for request-cache stability"——说明文案一致性对缓存前缀稳定性是有意为之的，此漂移与该设计目标相悖。