/acp-prune config 写路径在 DSH 0.2.0 上失效（SettingsForms 迁移）

[ranxianglei]

来源: #192 (#192) 分析 引擎移植到 DSH 0.2.0 seam 线 时发现

问题

DSH 0.2.0 把 settings 服务更名为 SettingsForms 并移除了 installSection，引擎无法再注册设置段。因此在 peer 下限（0.2.0-rc.2）之上的所有受支持宿主上，/acp-prune config set/reset 降级为只读 + 指引文本（启动时一次性 warn），六个标量旋钮的热更新（经 ~/.dsh/settings.yaml）不可用。读取面（list / status）不受影响，仍对组合值保持实时。

影响

• 用户无法在运行时调整 nudge 阈值 / 窗口旋钮，需要改 cordis.patch.yml 里的插件配置行并重启。
• 相对 v0.2.26（0.1.5 线上写路径可用）是一次功能降级——有意为之的临时状态，不是目标形态。

建议修复

让引擎声明自己的 static Config schema（SettingsForms 依此构建设置段），经新入口重新注册六个标量键；现有能力探测保留为旧服务形状的兜底。动手前先对已发布的 dsh-settings 0.2.0 tarball 核实 SettingsForms 的段构建公开形状（API 名称、键约束、写回语义），再按 §4 SOP 落地并补回归测试。

[ranxianglei]

🤖 Powered by ework

[bot] 🏷 收到。方向已核实:这正是 PR #191(peer 区间放宽到 >=0.1.5-alpha.1 <0.2.1-0,devDep 基线重基到 0.2.0-rc.2,CI 全绿、review 判定可合)正文里留的「Full SettingsForms port tracked as a separate issue」。执行计划:

1. 基线选择:直接在 PR (fix) install on DSH 0.1.6-0.2.0 hosts by widening the seam peer range to all verified lines #191 分支(2026-10-01_widen-dsh-peer-range @ d54508e)之上开工——0.1.5 基线上存在 installSection,SettingsForms 路径无法被验证;(fix) install on DSH 0.1.6-0.2.0 hosts by widening the seam peer range to all verified lines #191 合并后本 PR rebase 到 main 即可。
2. 先核实契约:按 issue 要求,先取已发布的 dsh-settings 0.2.0-rc.2(对照 0.1.7 线)npm tarball,核实 SettingsForms 段构建的公开形状——API 名称、键约束(volatile 注解)、写回语义(update/replace 的 revision 冲突处理),证据记入 docs/dsh-porting-verification.md。
3. 实现:引擎声明自己的 static Config schema(六个标量键 + volatile 注解,SettingsForms 依此构建设置段);双方言能力探测——installSection 存在 → ≤0.1.6 旧路径(逐字保留);describe/update/replace 存在 → ≥0.1.7 forms 路径;两者皆无 → 维持 [bug] DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError（启动 error） #173 单次 warn 降级。热更新驱动:forms 写入提交进 fiber config 的 volatile ref 且不发事件,引擎在 agent/pre-step 重读(resync)。
4. 验证与交付:回归测试(真实 seam 形状 fixture,两方言都钉住)+ 文档同步 + 全量 typecheck/test/build,然后开 PR(Closes /acp-prune config 写路径在 DSH 0.2.0 上失效（SettingsForms 迁移） #193)。

完成后在此给出结构化结论。

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 已完成 —— PR #195: https://github.com/Tyan66666/billion-context-dsh/pull/195（`Closes #193`，构建于 #191 之上——合并顺序无所谓，分支线性；同时取代 PR #180 的 settings 部分：同设计、仅 0.1.7 带、从未合并）。

结构化七问

1. 是什么问题：DSH ≥0.1.7 宿主（当前受支持线）上 /acp-prune config set/reset 失效——启动一条 warn、六个标量旋钮锁死在组合行、只剩 list/status 可用。这是 [bug] DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError（启动 error） #173 留下的"临时降级"，被 (fix) install on DSH 0.1.6-0.2.0 hosts by widening the seam peer range to all verified lines #191 的 peer 区间放宽变成了全体当前用户的常态。
2. 什么原因导致的：DSH 0.1.7 线把 settings 服务更名 SettingsForms 并移除 installSection，引擎在该线上没有注册入口。根因分层：表面是"写不了"，实际是宿主的注册机制跨线变更（方法式段注册 → profile entry id 寻址的表单段 + volatile 字段 ref），[bug] DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError（启动 error） #173 以干净降级止血但未实现新形状。
3. 怎么修复的：双轨能力探测——≤0.1.6 仍走 installSection（原路径逐字保留）；≥0.1.7 走 describe/update/replace（bound wrapper——宿主方法经 this 读实例状态，裸引用会丢 receiver；按 profile entry id compaction-acp 寻址）。引擎声明自己的静态 Config schema（AcpPluginConfigSchema，六键各标 .volatile()、故意不设默认值——schema 默认会遮蔽 preset 填充的 base），SettingsForms 依此构建设置段。热应用语义：loader 挂载期把每个 volatile 键包成 ref cell，表单写入在步间提交进同一批 ref 且不发任何引擎可见事件 → 旋钮 getter live 读 ref（提交即下次读取可见）+ 每 pre-step 顶部 resyncSettings() 重解快照基线、触发 diff 诊断（min/max 倒挂告警）。命令面零改动。
4. 是否有回归问题：无。逐项清点既有行为：≤0.1.6 线路径逐字保留、行为零变化；provider-less 纯 npm 组合维持指引文案降级；neither-API 宿主保留单条 warn + 干净降级（仅文案改为点名两种形状）；list/set/reset 输出格式与窗口键清缓存语义不变。高危模式逐项过：无语义漂移（写语义对 tarball 逐行核实——非 volatile 键如 prompts/coreOverrides 写后原样保留，不会被 replace 冲掉）、无 fail-fast 变吞错（revision 冲突以宿主真 SettingsConflictError 抛出 → 映射为指引文案；命令面每次写前刷新 token，单写者流不会误冲突）、无阈值/时序/输出格式漂移。验证（0.2.0-rc.2 基线）：typecheck 绿、全量单元 386（375 过 / 11 skip = legacy-seam 设计性跳过）、build 绿、e2e 五场景全过（含 overflow-recovery wire 字节稳定）。
5. 是否破坏缓存：不涉及。窗口探测缓存、搜索 doc 缓存、ledger memoization 均未被触碰；forms 线的快照基线每步 resyncSettings() 重解属既有机制的正常运转（未变时是廉价 no-op），不是缓存策略失效。
6. 是否改了设计方向：没有转向。settings 层仍是组合之上的 LAYER（rule 17 三条铁律保持：filtered base、live-source gating、reset 不删用户数据）；本 PR 是在既有框架内补全第二条宿主 seam。forms 线热应用时机为"下次读取可见"而非事件驱动——这是宿主提交机制决定的（步间提交不发事件），不是方向选择。
7. 是否引入了新的配置：无新 env/config/默认值。AcpPluginConfigSchema 是引擎内部声明（供 SettingsForms 构建表单用），不是用户配置项；六键的名字、默认值、preset 填充语义全部不变。

行为变更披露（旧 → 新）：DSH ≥0.1.7 宿主上 /acp-prune config set/reset：旧 = 启动一条 warn + 只读（六键只能改组合行 config: 后重启）→ 新 = 完全可用（写入经 SettingsForms 提交，值自下一次读取生效，诊断在下一步触发）。原因：#193 要求恢复受支持线上的写路径；≤0.1.6 宿主与 provider-less 组合不受影响。

契约核实证据（动手前按 issue 要求对已发布 tarball 完成，记录于 docs/dsh-porting-verification.md）：dsh-settings 0.1.7-rc.2 与 0.2.0-rc.2 的 lib/index.js 字节相同——一次核实覆盖两条线；写机制（update/replace 的 mergeLayers 构成、非 volatile 键保留）、per-entry revision map（从 0 起、raw 变化 +1、未传 expectedRevision 跳过检查）、cordis-plugin-loader volatile 接线（ref 包装 + 步间 updateVolatile 提交 + loader/volatile-update 事件——本引擎不订阅该事件）均逐字确认。

文档同 PR 同步：AGENTS.md rule 17(d) + module map、docs/settings-integration-design.md §4.9（+修订记录 v5）、README.md / README.en.md 设置段。回归钉：tests/settings.test.ts forms 五用例（静态 schema 契约 / 热应用 next-read / config 往返 / 服务级陈旧 revision / 倒挂恰好一警）。

判定：可合并（等 CI + 人工合并）。