Repository navigation
docs(dsh): profile-layer patch recipe that actually disables native auto-compaction in web profiles (#1772/#2474) - #2476
Conversation
…uto-compaction in web profiles (ranxianglei#1772/ranxianglei#2474)
[bot] 🏷 审完了:diff 逐行 + 文档里每个事实断言对照仓库核对 + CI 全绿( 验证过程
八问
合并前一个小补:缺「快照刷新时机」。整行替换会冻结你抄下来的 roster——dsh 升级后上游往 EN:
ZH:
(我本地已提交为 非阻塞提示
判定:补上快照刷新一句即可合入;其余全部通过(diff 干净、位置正确、zh/en 对齐、事实断言全核过、CI 绿)。 |
|
收到审阅,两点都已处理: 1. 快照刷新那句 —— 已在
|
[bot] 🏷 两点都核实过了,收尾:
八问增量(①–④ 与上轮不变):⑤ 回归仍无——纯增量文档,零运行时变化;⑥ 缓存不涉及;⑦ 设计方向不变;⑧ 无新配置。新增内容仅一段维护指引,事实核查通过。CI 在 你补的 #2477 提示(告警只提 preset-standard 会让 PTC/创建者模式用户以为不适用)——已转发到 #2477 线程并附建议措辞;顺带提醒了 #2477 注释「indexes top-level rows only」与旧 CLIENTS.md「top-level rows and true group children」的措辞需对齐(该 PR 正在重写那节)。 |
📦 Merged Build PublishedThis merge to master was published as npm install -g billion-context@0.0.189-master.80e71a7 # this exact build
npm install -g billion-context@master # always the newest merged build
|
…-snapshot patch CAN switch off web-profile native auto-compaction (ranxianglei#2474) The ranxianglei#1772 boot warning ended in a dead end ('no patch layer can reach'). Verified live against dsh 0.2.1-alpha.1: preset-standard is an ordinary bundle-layer entry; a profile-level cordis.patch.yml row (applied after every bundle) replaces its config WHOLESALE, so a full-snapshot override carrying auto:false under compaction-basic switches off native auto-compaction. The once-per-process warning now names that recipe plus both verified traps (a partial snippet drops everything not restated — other plugins AND the preset's id/order identity; - insert: with the same id appends a dead duplicate row); launcher stderr, config doc, bundle-patch header and CLIENTS(en/zh)/README(en/zh) corrected to match; the regression test pins the exit pointer. Snapshot-freeze walkthrough lives in the companion CONFIGURATION.md PR (ranxianglei#2476). Supersedes ranxianglei#1786's dead recipe (.agent-presets user root removed in dsh 0.1.7+). Refs ranxianglei#2474
Refs #1772, #2474, #1786
What
Adds the working recipe for turning dsh native auto-compaction off in a web profile, to both
CONFIGURATION.mdandCONFIGURATION.zh-CN.md.#1772 closed with "the running
compaction-basiclives inside an agent preset that no patch layer can reach by id", and #1777's boot warning ends on "dsh native auto-compaction stays enabled in this profile". Both are correct about id-addressing — but the conclusion "no patch layer can reach it" is too strong: presets are ordinary top-level rows inserted by the bundle layer, and the profile patch layer is applied after it, so a profile patch can override the preset row'sconfigwholesale.Verified on dsh
0.2.1-alpha.1(Windows 11, profile bundles including@deepseek-ai/dsh-web-app):Automatic pressure/overflow compaction off; manual
/compactand the tool-result pruner stay — which is exactly what #1772 wanted and believed impossible. No upstream dsh change, no user-root directory, no roster-default replacement.The failure modes are all silent — documented as a table
Because
configis replaced, not merged, the obvious "write only the part I want to change" patch destroys the preset without any diagnostic. Measured against the same dump:- id: preset-standard.compaction.compaction-basicpatch: entry "…" not found; no effect- id: preset-standard+ partialconfig.plugins- insert:withid: preset-standardpreset-standardrow; live preset untouchedconfigsnapshot + oneauto: falseauto: falseThe doc section tells readers to re-dump and compare entry counts after editing, since a partial override fails silently.
Scope
Docs only —
CONFIGURATION.md+CONFIGURATION.zh-CN.md, 120 insertions, 0 deletions, noversiontouch, no source changes. The new subsection sits under the existing "Detecting other compression plugins (#1206)" list, right after theauto: falsebullet it extends.Revision note (after review)
The snapshot-refresh caveat the review asked for landed in
4713d36— the head under review was58816e8, which predates it. Both files carry it now (**The snapshot is frozen at the dsh version you copied from.**/**快照会冻结在你复制的那个 dsh 版本上。**), placed after the three-failure-modes table, and the recipe offers the opt-out: keep native auto-compaction on and let the #1729/#2432 rebase path handle it instead.CI on
4713d36: 24/24 success.Notes for review
$DSH_HOME/.agent-presets/+includeUserRoot: true, and I re-verified on the installed 0.2.1-alpha.1 tree thatincludeUserRoot,.agent-presets, and the plural@deepseek-ai/dsh-agent-presetspackage are all absent (PresetTree.importlives in the plural package, whose last version was 0.1.6-alpha.2). That was raised in-thread by @beicause and independently confirmed by the bot; this PR is the replacement content.bili dshline in the READMEs (README.md:255 / README.zh-CN.md:207 currently say "dsh auto-compaction off outside web profiles (dsh.bundle.patch.yml禁用自动压缩在 web profile 下静默失效 #1772)"). If you want the dead-end warning insrc/agent/dsh-native.tsto point at this section, say the word and I'll send a follow-up commit — I kept this PR docs-only to keep the review trivial.Part of #2474 — the issue stays open until the code-side PR (#2477, the boot warning's exit route) also lands; this PR covers only the docs half.