会话索引压缩 zongyanbai/dsh-context-continuum

@local/dsh-context-continuum

把 DeepSeek Harness 的上下文压缩从「滚动重写的叙事摘要」改成「只追加的会话索引」。

征集协助中 —— 见 docs/DEFECTS.md。三条实测缺陷已用真实宿主日志取证，欢迎提 issue / PR，尤其是第 1 条（功能性失败）。

它解决什么问题

官方引擎的压缩替换区间起点恰好是上一份摘要的 seq（实测 9/9 次），也就是每代都在重写旧摘要。早期内容被反复磨平。

同会话 A/B 实测（docs/AB-report.md）：

| 指标 | 官方滚动摘要 | 本插件的会话索引 |
| 早期字面事实存活率 | 0 / 407 | 条目逐字继承，不再被重写 |
| 摘要长度轨迹 | 13,762 → 20,029 字 | 154 → 3,079 字（≈110 字/代） |
| 官方叙事结构泄漏 | 每代都有 | 0 / 27 代 |

机制根源不是「模型写得不好」，而是替换区间起点错位。原文在 append-only 日志里一条不少，本插件的做法是：模型只写一个新条目，装配器把旧条目逐字搬运过来。

它提供什么

| 工具 | 用途 |
| context_anchors | 看被压掉了什么：compactionId、被压 seq 区间、token 数、摘要模型 |
| context_read | 按锚点取回被压缩掉的逐字原文（原文从未被删除，只是被遮蔽） |
| context_compact | 手动就地压缩 |

序号 T<n> 与第 n 个成功压缩事务一一对应。压缩失败时不编号，以「无条目 + 失败原因」呈现 —— 账本不把失败的压缩伪装成成功的。

如何安装

三层接线，缺一层不生效：

| 层 | 位置 | 作用 |
| ① bundle patch | 本仓库 cordis.patch.yml | 置灰顶层 compaction-basic，insert 本插件行 |
| ② profile 用户层 | 目标 profile 的 cordis.patch.yml | 新增 preset-continuum（standard 的确定性变换） |
| ③ 依赖与解析 | profile 的 package.json + node_modules/@local/dsh-context-continuum | 让包可解析 |

快速上手（Windows）

1. 备份 profile $p = "$env:USERPROFILE\.dsh\profiles\desktop" Copy-Item "$p\package.json" "$p\package.json.bak" -Force Copy-Item "$p\cordis.patch.yml" "$p\cordis.patch.yml.bak" -Force

2. 接线（见上表 ①②）
- package.json：bundles 数组加 "@local/dsh-context-continuum"
- cordis.patch.yml：追加 preset-continuum 块

3. 依赖（Windows 用目录联接，不用符号链接 —— dsh 解析不了符号链接） cmd /c mklink /J "$p\node_modules\@local\dsh-context-continuum" "<本仓库路径>"

4. 重启 DeepSeek Harness

5. 会话里选「continuum」这个 agent preset

第 5 步别漏。 本插件没有替你改默认值（避免擅自动你的会话），不选就还是 standard，工具挂不上。

回退

Copy-Item "$p\package.json.bak" "$p\package.json" -Force
Copy-Item "$p\cordis.patch.yml.bak" "$p\cordis.patch.yml" -Force
cmd /c rmdir "$p\node_modules\@local\dsh-context-continuum"

删目录联接用 cmd /c rmdir，不要用 Remove-Item -Recurse（后者在旧版 PowerShell 上会顺着联接删到源目录内容）。

架构

它是官方引擎的子类，只覆写 summarize()，不重做压缩机制：

ContinuumCompactionEngine extends BasicCompactionEngine
└─ override summarize() ← 唯一被替换的点：这次压缩产出什么 └─ super.summarize() ← 缓存复用 / 模型回退 / 会话关联全借官方的

| 文件 | 职责 |
| src/engine.ts | 压缩后端本体 + 注册三个工具 |
| src/indexlog.ts | 索引模板、旧条目逐字继承、强制丢弃叙述正文、超量归档 |
| src/artifacts.ts | 权威产物账本 deliverables/presented |
| src/anchors.ts | 从日志归并锚点账本 |
| src/trace.ts | 按锚点取回逐字原文 |
| src/tools.ts | context_anchors / context_read / context_compact |

不自己发 ctx.llm.stream()：那要重做前缀缓存复用、模型回退与会话关联。
summarize() 是 protected，子类直接调用正是官方设计的扩展点。

参数

thresholdRatio: 0.5 # 触发阈值（官方默认 0.8；大窗口模型建议调低） headroomTokens: 65536 # 生成余量 retainRatio: 0.16 # 保留最近 16% 原文尾巴 maxOverflowRetries: 1 # provider 报 CONTEXT_WINDOW_EXCEEDED 后强制压缩并重试 compactionRetries: 1 auto: true

已知硬约束（改参数前请读）：
| 配置 / 情形 | 后果 |
| headroomTokens: 0 | 官方断言直接拒：must be a positive integer，整个条目不激活 |
| maxTokens 过小 | 摘要被截断，引擎报 summarization truncated at the token cap 并拒绝安装 |
| retainRatio >= thresholdRatio | 没有可压区间，compactIfNeeded 返回 null |
| 摘要不比原文小 | 引擎主动拒绝 → 由归档机制兜住（表层封顶 24 条） |

本地验证

npm install
npm test # 101 项单测 / 10 个文件
npm run typecheck # 对真实 @deepseek-ai/dsh-*@0.2.0-rc.2 声明做类型检查
npm run build # 产出 lib/

tsconfig.json 是 noEmit: true（只做类型检查），真正的构建走 tsconfig.build.json。
先删 lib/ 再构建 —— 否则旧产物会冒充「构建成功」。

已知缺陷（征集修复中）

见 docs/DEFECTS.md。摘要：

1. 压缩把存在的任务信息判成「信息不足」（高，功能性失败）
2. <think> 泄漏进条目（中；README 曾声称 0 泄漏，实测是反例）
3. 压缩触发过晚 + 不控制上下文总量（中，定位偏差）

文档

| 文件 | 内容 |
| docs/DEFECTS.md | 桌面真实宿主实测缺陷报告（含日志取证） |
| docs/AB-report.md | 官方摘要 vs 会话索引的 A/B 实测 |
| docs/host-evidence-desktop.txt | 桌面宿主上的 agent 侧报文原文 |
| docs/retrieval-benchmark.md | 检索口径实测 |
| docs/AUDIT.md | 改造前的审计快照 |

致谢

nacre 的「强制逐字锚点 + 原文回溯」思想对本插件有启发（仅借思想、不借代码，其许可为 AGPL-3.0，代码并入会传染）。宿主已用 shadowedSeqs 原生提供锚点基础。

License

MIT