[feat] 支持 DSH 0.1.7 接缝线：settings 集成从 installSection 迁移到 SettingsForms

[ranxianglei]

来源: Tyan66666/billion-context-dsh#173（DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError）分析该问题时发现：#173 的修复只做优雅降级（能力探测 + warn），把 0.1.7 线纳入支持范围是独立的接缝线移植任务。

背景

• dsh-settings 0.1.7 全线（alpha.1 / alpha.2 / rc.1 已逐一核验 npm 产物）：服务类 SettingsProvider → SettingsForms，installSection(owner, ns, schema, entry, hooks) 被移除。新公开 API：configure / describe / update / replace / mutate，按 profile entry id 寻址，可编辑字段由 schema 上的 meta.volatile 决定；~/.dsh/settings.yaml 不再存在（启动时改名 .imported，经 LEGACY_SECTION_ENTRIES 映射导入 profile entries——映射表只含 ui-developer-tools / ui-onboarding / shell，compaction-acp 落回同名 entry id）。
• SettingsConflictError 在 0.1.7 仍导出（lib/index.js:163），revision 冲突路径可沿用。
• 我们的 peer 区间 >=0.1.5-alpha.1 <0.1.6-0 排除 0.1.7；[bug] DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError（启动 error） #173 修复后超区间安装干净降级（一条 warn，六键走组合行）。本 issue 是把 0.1.7 线正式纳入支持。

工作项

1. 按 house rule 逐缝核验 0.1.7 线的其余四个接缝（dsh-compaction / dsh-session / dsh-llm / dsh-tools）——先验证再拓宽区间（docs/dsh-porting-verification.md 流程），重钉 tests/peer-range.test.ts。
2. settings 集成移植到 SettingsForms 语义：section 以 profile entry id（compaction-acp，即 bundle patch 行）为键而非插件注册 namespace；六个键需要 meta.volatile schema 标注才会出现在表单；读写走 describe()/update()/replace() + revision 冲突处理。
3. 决定六个键在 0.1.7 下的组合行承载方式（settings.yaml 已消失；legacy import 对未知 section 名落回 entry id 同名键）。
4. 显式区间拓宽 peer range（永不 caret）、移动 devDep 基线、跑全量测试 + e2e。

不做的影响

DSH 升到 0.1.7 的用户引擎本体与四个工具正常可用，但失去六键运行时热调（只能改组合行 + 重启），启动日志有一条 warn 说明现状（#173 修复提供）。

[ranxianglei]

🤖 Powered by ework

[bot] 🏷 收到，开始做。先报查重与计划（未动手写码）：

查重：本条目与现有 0.1.7 相关条目无重复——#163/#165（V4 producer source kind 写入侧）、#166/#170（checkpoint 读侧形状）、#169/#171（direct-kind 分类器）都是 0.1.7 下具体缺陷的修复；本条是接缝线整体纳入支持 + settings 集成移植，范围不同，保持打开进入实现。

npm 现状核验（五个 seam 包版本线完全一致，均为纯预发布、无最终版）：

• 0.1.5: alpha.1 / alpha.2 / rc.1 / rc.2 / rc.3
• 0.1.6: alpha.1 / alpha.2
• 0.1.7: alpha.1 / alpha.2 / rc.1（dist-tag next）

按 house rule「验证过的线才进区间」，拓宽到 0.1.7 意味着 0.1.6 线也要一并核验（区间是连续的；若核验不过则用复合区间跳过它）。目标区间形态：>=0.1.5-alpha.1 <0.1.8-0（显式上界，永不 caret）。

依赖关系（重要）：devDep 基线移到 0.1.7 后，全量测试/e2e 跑在真实 0.1.7 会话格式上——而 #163（V4 admission 拒绝 kind:"plugin"）、#166（checkpoint 读侧仍读 source.plugin === 'compact'）、#169（direct-kind 行分类）这三个已知破坏点目前只有未合并的修复 PR（#165 / #170 / #171）。所以本 PR 会叠在 #165、#170、#171、#175 之上开发：PR 描述里会写明合并顺序（那四个先合，本 PR rebase 后 diff 收敛为纯增量）。这样既满足工作项 4 的「移动 devDep 基线 + 跑全量测试 + e2e」，又不把别人的修复混进本 PR。

实施顺序：

1. 五接缝 × 三条线逐一核验 npm 产物（dsh-settings 已由 [bug] DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError（启动 error） #173 核验过 ServiceForms 表面，我复核其余四缝 + 0.1.6 线），证据记入 docs/dsh-porting-verification.md；
2. settings 集成移植到 SettingsForms 语义（entry id compaction-acp 寻址、六键 meta.volatile 标注、describe()/update()/replace() + revision 冲突沿用 SettingsConflictError），保留 0.1.5/0.1.6 的 installSection 路径做双轨；
3. 定六个键在 0.1.7 下的组合行承载方式；
4. 拓宽 peer range、移 devDep 基线、重钉 tests/peer-range.test.ts、全量测试 + e2e、文档同步（README 中英文 / AGENTS.md / design doc）。

进展会持续回帖。

[Tyan66666]

前置已全部落地，可以开工。

前置状态（截至 2026-09-24，全部已合并进 main）

• [bug] DSH 0.1.7 V4 admission rejects kind:"plugin" — nudge/prune rows wedge the write batch and the next turn fails with "format v4 message requires a producer-owned source kind" #163 V4 producer source kind → PR (fix) write durable nudge/prune rows with the V4 producer source kind so DSH 0.1.7 accepts them #165 ✅
• [bug] DSH 0.1.7 checkpoint read-side gap: isCheckpointNode/summarySeqIndex still read source.plugin === 'compact', but 0.1.7 emits { kind: 'compact-checkpoint' } #166 checkpoint 读侧形状 → PR (fix) recognize the 0.1.7 checkpoint source shape on the read side — checkpoint rows stay checkpoints in every consumer #172 ✅（(fix) recognize 0.1.7 compact-checkpoint rows on the read side #170 已关闭，与 (fix) recognize the 0.1.7 checkpoint source shape on the read side — checkpoint rows stay checkpoints in every consumer #172 重复）
• [bug] 0.1.7 宿主内容行改名直接 kind（runtime-context/ptc-mode）后 isRealUserTurn 的 plugin 白名单漏检，可能赢走 last-real-user 保护窗 #169 direct-kind 行分类 → PR (fix) match DSH 0.1.7 direct-kind host rows in the surface classifier (issue #169) #171 ✅
• [bug] DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError（启动 error） #173 缺 installSection 时启动 TypeError → PR (fix) stop the startup TypeError when the host settings service has no installSection — probe first and degrade the section instead #175 ✅
• 计划里没写到的额外已合并项：[bug] preset 阈值被 live 设置快照遮蔽：preset-only 组合下内核读到引擎默认 0.70/0.85 而非 preset 值 #176 preset 阈值被 live 快照遮蔽 → PR (fix) seed the live settings snapshot from the preset-resolved thresholds (issue #176) #177 ✅

所以不必再叠在未合并分支上：直接以当前 main（1498490，含 dist-bot 刷新）为基线开发，本 issue 的 diff 就是纯增量。

开工前提

1. 接缝核验先做再拓区间：0.1.5 / 0.1.6 / 0.1.7 三条线 × 五个 seam（dsh-settings / dsh-compaction / dsh-session / dsh-llm / dsh-tools）逐一核验 npm 产物，证据记入 docs/dsh-porting-verification.md。0.1.6 若核验不过就用复合区间跳过它；区间一律显式上界、永不 caret，并重钉 tests/peer-range.test.ts。
2. SettingsForms 移植保留 0.1.5/0.1.6 的 installSection 双轨（现有降级分支在 src/index.ts:490）。寻址键是 profile entry id，即 bundle patch 里的 compaction-acp 行；六键 schema 需要 meta.volatile 标注才会出现在表单；读写走 describe()/update()/replace()，revision 冲突沿用 SettingsConflictError。
3. ~/.dsh/settings.yaml 在 0.1.7 已消失（legacy import 对未映射的 section 落回同名 entry id），请在本 PR 里写明六键在该线下的承载方式。
4. 移植时别踩已经踩过的坑（AGENTS.md rule 17）：注册进 settings 层的 base 必须是过滤后的条目（filterSettingsEntry），否则没写过的键会被报成 source: base；所有自动探测闸门必须读 live 快照而不是 this.config；reset 只删目标键、其余原样带回，避免删掉手写条目。
5. 验收面：0.1.7 上位不再出现 has no installSection 那条 warn，六键可运行时热调；devDep 基线移到验证通过的那条线，全量测试 + e2e 全绿；dist/ 不要手工提交（合并后 dist-bot 刷）。
6. PR 标题用 (feat) …（CI 会校验），并同步 README 中英文 / AGENTS.md / design doc。

有阻塞随时回帖。

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 进度报告：代码与测试全部完成并全绿，剩 3 条文档记录 + 提交/PR；本会话上下文耗尽，先停在这里。

已完成（工作区分支 2026-09-24_dsh-017-seam-line，基线 main 192f00e，纯增量）

1. 接缝核验（先验证后拓区间）：0.1.5 / 0.1.6 / 0.1.7 三条线 × 五个 seam（dsh-settings / dsh-compaction / dsh-session / dsh-llm / dsh-tools）逐一核验已发布 npm 产物。结论：0.1.6 相对 0.1.5 无协议漂移、干净纳入；0.1.7 两处破坏性变化——dsh-settings 服务重构（本 issue 主体）与 deepseek 适配器协议切换（OpenAI chat-completions SSE → DeepSeek Messages 类型化 SSE，旧帧在 dsh-llm-deepseek/lib/index.js:1531 抛 MALFORMED_RESPONSE，影响 e2e fake LLM）。
2. peer 区间显式拓宽：>=0.1.5-alpha.1 <0.1.8-0（永不 caret；0.1.8-0 排序在任何 0.1.8-x 预发布之前，下一线验证前保持拒绝），devDep 基线移到 0.1.7-rc.1（当前 43 个 dsh-* 包全钉该线），tests/peer-range.test.ts 重钉三条线 accept/reject。
3. SettingsForms 双轨移植（src/index.ts 注入回调）：先探 installSection（≤0.1.6 legacy 分支逐字保留）→ 再探 describe/update/replace（≥0.1.7 forms 分支，按 profile entry id compaction-acp 寻址，revision 冲突沿用 SettingsConflictError）→ 皆无则保留 [bug] DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError（启动 error） #173 的单条 warn 降级。六键经 .volatile() schema 标注进表单；非严格校验保留未声明行；schema 不设默认值（preset 层负责）。热应用驱动：forms 写入在步骤间提交进 volatile 引用且不发事件，引擎在每个 agent/pre-step 顶部 resyncSettings() 主动重读。
4. 六键承载方式（settings.yaml 消失问题）：0.1.7 下由组合行 + volatile 引用承载——启动时 ~/.dsh/settings.yaml 改名 .imported，LEGACY_SECTION_ENTRIES 只映射 ui-developer-tools / ui-onboarding / shell，未映射 section 落回同名 entry id。
5. 测试：tests/settings.test.ts 新增 FormsSettingsService fixture（复用传入 volatile 引用而非再包一层，standalone 21/21）；checkpoint-span / region 测试适配 0.1.7 checkpoint 形状；全量 367/367 绿。
6. e2e：fake LLM 重写为 DeepSeek Messages 协议帧；run-e2e.mjs 线协议断言改按 Messages 语义（顶层 system 字段做前缀稳定检查、配对检查适配）；nudge-rhythm filler 第 5 轮 80→300（越过 acp-kernel 0.0.63 的压力收益下限）。4 场景全绿。
7. 文档同步：AGENTS.md（模块图 + rule 13/17 + §4 两条）、README 中英文、docs/INSTALL.md、docs/settings-integration-design.md（§4.8 待办指针 + 新增 §4.9 完整设计记录）均已更新。

行为变更披露（旧 → 新）

• 0.1.7 宿主：「启动一条 warn + 六键只能改组合行 + 重启」（[bug] DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError（启动 error） #173 降级）→ 完整支持、无 warn、六键经 /acp-prune config 运行时热调。
• 0.1.5 / 0.1.6 宿主：零变化（installSection 分支代码路径逐字保留）。
• 区间外宿主：零变化（单条 warn 降级保留）。

尚未完成（交接清单，约 30 分钟工作量）

• 补 3 条文档记录：① docs/e2e-harness-design.md 加 2026-09-24 日志条目（fake LLM 协议重写 + wirePairing/前缀检查适配 + nudge-rhythm filler 80→300）；② docs/dsh-porting-verification.md 追加 2026-09-24 三线×五缝核验记录；③ docs/settings-integration-design.md 修订记录加 v5（issue [feat] 支持 DSH 0.1.7 接缝线：settings 集成从 installSection 迁移到 SettingsForms #174）条目（插在 v4 条目之前）
• git checkout -- dist/（本地构建弄脏了 dist/，绝不手工提交）
• 最终门禁：npm run typecheck && npm test && npm run build
• 提交（(feat) 前缀标题，如 (feat) support the DSH 0.1.7 seam line — SettingsForms settings integration + verified 0.1.5–0.1.7 peer band）、推分支、开 PR（body 带 Closes #174）

停止原因：本会话上下文已达上限且可压缩空间耗尽（系统级限制，非任务阻塞）。以上所有状态均已落盘，新会话按清单收尾即可；未做任何 push/PR，只认领实际执行过的操作。

[Tyan66666]

继续

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

已完成，PR 已开：#180

做了什么（按 issue 四个工作项逐条落地）：

1. 接缝核验先行：五个 seam × 三条线（0.1.5 / 0.1.6 / 0.1.7）逐一核验 npm 产物，证据记入 docs/dsh-porting-verification.md（2026-09-24 条目）。0.1.6 相对 0.1.5 无漂移、干净纳入；0.1.7 两处破坏性变化：dsh-settings 服务重构（本 issue 主体）+ dsh-llm-deepseek 适配器协议切换（OpenAI chat-completions SSE → DeepSeek Messages 类型化 SSE，旧帧在 lib/index.js:1531 抛 MALFORMED_RESPONSE——e2e fake LLM 随之重写，wire 断言适配，记入 docs/e2e-harness-design.md 日志）。
2. SettingsForms 双轨移植（src/index.ts 注入回调能力探测）：installSection 存在 → ≤0.1.6 legacy 路径逐字保留；describe/update/replace 齐备 → ≥0.1.7 forms 分支（按 profile entry id compaction-acp 寻址，六键靠静态 Config schema 的 .volatile() 标注进表单，写走 update() + SettingsConflictError revision 处理，服务方法绑定 receiver）；两者皆无 → [bug] DSH 0.1.7 移除 dsh-settings.installSection 后 ACP 设置节注册抛 TypeError（启动 error） #173 的单条 warn 降级不变。热应用驱动：表单写入提交进 volatile 引用且不发事件，引擎每个 agent/pre-step 顶部 resyncSettings() 主动重读（在 autoNudge 闸门之前，改动当步生效）。rule 17 三个坑都已避开（过滤后条目注册 base、闸门读 live 快照、reset 只删目标键）。
3. 六键承载方式：0.1.7 下 settings.yaml 消失，由组合行 + volatile 引用承载（legacy import 对未映射 section 落回同名 entry id），已在 design doc §4.9 写明。
4. 区间与基线：peer 区间显式拓宽为 >=0.1.5-alpha.1 <0.1.8-0（永不 caret，0.1.8-0 排序在任何 0.1.8-x 预发布之前），devDep 基线移到 0.1.7-rc.1（43 个 dsh-* 包全钉该线），tests/peer-range.test.ts 重钉三线 accept/reject。

行为变更披露（旧 → 新）：

• 0.1.7 宿主：「启动一条 warn + 六键只能改组合行 + 重启」→ 完整支持、无 warn、六键经 /acp-prune config 运行时热调。
• 0.1.5 / 0.1.6 宿主：零变化（installSection 分支代码路径逐字保留）。
• 区间外宿主：零变化（单条 warn 降级保留）。

验证：全量 367/367 绿（含 SettingsForms fixture 真实 volatile 引用复用、双形状 checkpoint fixture、重钉 peer-range）；e2e 四场景对 0.1.7-rc.1 真实宿主栈全绿（fake LLM 说新 DeepSeek Messages 协议）；typecheck/build 干净；dist/ 未手工提交（合并后 dist-bot 刷）。

一句话总结：把 DSH 0.1.7 线正式纳入支持范围——settings 集成从 installSection 迁移到 SettingsForms 双轨（entry id 寻址 + volatile 六键热调），五缝核验后显式拓宽 peer 区间至 >=0.1.5-alpha.1 <0.1.8-0，测试与 e2e 全绿，可以合并。