确定性会话压缩 mpetruc/dsh-vcc

dsh-vcc

为 DeepSeek Harness 打造的确定性、无 LLM 会话压缩插件，支持无损召回——改编自 pi-vcc 的面向视图编译器方案。

当会话超出窗口时，dsh-vcc 不再花钱请 LLM 压缩历史，而是把对话编译成结构化、稳定的摘要：

- [Session Goal] / [Files And Changes] / [Commits] /
[Outstanding Context] / [User Preferences] 头部区块，跨多次压缩合并（去重、跨压缩合并文件、易变区块重新构建）；
- 一份排好序的简要记录（用 --- 分隔），其中的消息保留指向会话日志的无损 (#N) 引用。

(#N) 是事件 seq——也就是 vcc_recall 搜索用的同一个索引——所以压缩丢掉的东西，一次确定性调用就能找回来：

vcc_recall(query: "redis cache decision") → ranked, paged hits (#N)
vcc_recall(expand: [42]) → full untruncated content
vcc_recall(query: "#42:auth.ts") → drill into a file from an entry
vcc_recall(query: "#42:auth.ts:full") → all lines of that file content
vcc_recall(mode: "touched") → files worked on, with entry indices
vcc_recall(scope: "all") → also reach edited/retried branches

还附带 /vcc（预览下一次压缩会写出的摘要，不做任何改动）和 /vcc-recall（把工具当人类命令用）。

目录结构

| 路径 | 作用 |
| index.js | DshVccCompactionEngine（默认导出）——继承基础后端，用确定性流水线覆盖它的 summarize 钩子；注册召回工具和命令。 |
| lib/dsh-adapter.js | DSH 消息 → pi 消息结构（工具调用 id→名称 关联、推理策略）。 |
| lib/session-source.js | 会话事件 → 消息流（lineage = 实时界面，all = 完整日志）。 |
| lib/engine-util.js | 为 (#N) 引用对齐 seq；提取上一次摘要。 |
| lib/drill-down-dsh.js | #N:path 下钻，重新挂到会话事件上。 |
| lib/recall-tool.js | vcc_recall 工具 + 共享召回算法。 |
| lib/commands.js | /vcc 和 /vcc-recall 人类命令。 |
| src/ | pi-vcc 核心流水线编译成 ESM（MIT，见 NOTICE）：normalize、filter-noise、sections、rank、build-sections、summarize、search-entries、render-entries、format-recall、recall-scope、extract/\。 |
| cordis.patch.yml | 在预设的 compaction 组里启用引擎，并禁用预设自带的 LLM 后端。 |
| node_modules/@deepseek-ai/ | 指向 harness 检出包的符号链接农场，bundle 在模块求值时导入这些包（见下文）。 |

工作原理

- bundle 把一行服务（dsh-vcc）挂进 cordis 智能体预设的 compaction 组，并禁用同一组里预设自带的 compaction-basic 行。此后预设会话把 ctx.compaction 解析为 DshVccCompactionEngine——它是基础
后端保留了全部机制（阈值/溢出自动触发、区域选择、(maxTokens) 收缩门、重试退避、持久会话变更、compaction/summary 事件），只把 summarize 钩子替换为移植版 pi-vcc 核心里的 compileRanked。
- 对齐方式：buildSummarizationInput 把引擎打算遮蔽的那些消息原样交给它；消息就是持久表面对象，所以用一张身份映射（Map<Message, seq>，从 session.surface.nodes 构建）就能还原每条消息的事件 seq，失败即关闭。摘要里的 (#N) 引用和 vcc_recall 的索引是同一批 seq——构造上自洽。
- 编译结果以 { summary, rawOutput, provider: 'dsh-vcc', model: 'deterministic' } 返回，不调用 llmStreamCall——走的是后端 SummaryResult 的非 LLM 分支。编译结果为空会抛错，后端就把它当成什么都没产出的摘要器处理（走重试/错误路径）。

安装与验证

plugin_manager → install_bundle → target: /home/user1/dsh-compaction/dsh-vcc

- install_bundle 会在配置档的 package.json 里记录 @local/dsh-vcc: link:<this dir>，并应用 cordis.patch.yml；首次安装不需要重启。
- 确认：先看 cordis_inspect_query（Host Config / Tool / Service），然后在 cordis 预设会话里运行 /vcc，查看实时的确定性预览，再用 /compact 压缩。之后 vcc_recall 就能回答关于被遮蔽历史的问题。
- 替换同一包的已安装版本，仍然需要重启配置档才能加载新的模块代。

已知范围（v1）

- 只对 cordis 预设生效（补丁针对组合配置档中最后出现的那些行）。standard / ptc / minimal 预设仍用自带的压缩后端。
- 设计上就是确定性的：不调用 LLM、不联网、无不确定性——相同输入永远产出相同输出。
- 只有当前会话可搜索；更早的会话不行。

归属

dsh-vcc 是 pi-vcc（MIT）的移植版——pi-vcc 本身又衍生自 pi-blackhole（作者 k0valik，MIT）和 invisible-continue（作者 monotykamary，MIT）。src/ 下编译后的核心就是 pi-vcc 流水线（normalize、filter-noise、build-sections、rank、summarize、extract/*、search/render/format-recall、recall-scope），只把它的 load-messages/JSONL 层换成 lib/session-source.js，并把下钻重新挂到会话事件上。完整许可证文本见 NOTICE。