前言¶

在 DSH 长会话中，对话内容和工具结果会持续累积，上下文窗口压力会变大。dsh-argp 是面向 DeepSeek Harness（dsh）的第三方上下文压缩引擎：它不让模型直接自由改写历史，而是让模型对“原子”提出 extract、summary、false 决策，再由确定性守卫裁定提案是否落地。被压缩和被剪枝的内容会保留在 append-only 日志中，后续可再召回。

下面介绍它的核心机制、安装方式、典型配置和使用注意。

这是什么¶

dsh-argp 由 yoza10635 维护，许可证为 MIT。

它解决的问题是：在 dsh 插件场景中，既要控制上下文规模，又要避免历史原文被改写后无法找回。dsh-argp 用三个部分配合：

• Stage-1 逐原子压缩：模型提出压缩候选，守卫裁定是否落地。
• Stage-2 引用图剪枝：超阈值时按图规则摘除整原子，压缩阶段执行 0 次 LLM 调用。
• append-only 日志：承载被压缩和被剪枝内容原文，支持两级召回。

核心机制¶

Stage-1 逐原子压缩¶

Stage-1 对当轮原子做压缩提案。

模型可以对原子提出三种决策：

extract
summary
false

确定性守卫负责判断这些提案能否落地。也就是说，LLM 只提出候选结果，是否真正替换由守卫裁定。

Stage-2 引用图剪枝¶

Stage-2 在超过阈值时，按反向拓扑序整原子摘除。该阶段在压缩时执行 0 次 LLM 调用。

CiteDeclarer 每轮声明跨轮引用边，并通过 injectEdges 通道供 Stage-2 使用。

日志与召回¶

append-only 日志承载被压缩和被剪枝内容的原文。

RecallZoom 提供两级召回：

recall_summary
recall_detail

被剪原子另有：

recall_pruned
list_pruned

安装与启用¶

先添加插件：

dsh plugin --profile <name> add dsh-argp

这一步会把 dsh-argp 挂到指定 profile。

接着，在 profile 的 cordis.patch.yml 中禁用 stock 摘要器：

- id: compaction-basic
  disabled: true

经过上面的步骤后，profile 层只需要做配置覆盖。

挂载由包的 bundle patch 负责，profile 层不要重复 insert loader entry，否则可能出现 duplicate loader entry id。

典型配置¶

如果要显式指定模型后端，可以配置 compressor 和 declarer 的 llm：

- id: dsh-argp
  config:
    compressor:
      llm: { provider: deepseek-official, model: deepseek-v4-flash }
    declarer:
      llm: { provider: deepseek-official, model: deepseek-v4-flash }

不配置 llm 时，可按 endpoint/apiKey 配置或环境变量走 OpenAI 兼容直连。

验证命令¶

仓库提供几类可运行的验证入口。

运行 per-atom soak：

npm run spike36

运行单事务零 LLM 调用验证：

npm run spike8a

生成逐原子压缩/剪枝明细：

node spike/atom-audit.mjs <产物目录>

适用场景与注意¶

适合需要控制长会话上下文、同时保留可召回历史原文的 dsh 插件场景。

使用前注意以下几点：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• Stage-1 的收益依赖模型指令遵循能力；守卫保证安全，但压缩收益会随模型服从率变化。
• lite 档多模型分工的服从率未实测。
• Stage-1 每轮压缩调用属于 side-channel 成本，不进入上下文，但计入总成本。
• B-6 窗口截断盲区：未被 dsh-argp 替换的 live 节点在逼近 contextWindow 时，可能被请求组装层截掉最旧部分且不留痕迹，recall_pruned 可能取不回。
• tombstone 两跳召回：占位文本经多轮演化后，原 seq 可能丢失，recall_pruned(seq) 需要正确编号。
• DeepSeek 系模型在系统提示词与用户指令冲突时，cites 声明可能为 0；Stage-1 守卫压缩与 Stage-2 确定性剪枝仍照常工作。

参考链接¶

GitHub 仓库：

https://github.com/yoza10635/dsh-argp

社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；本次资料未确认 dsh-argp 的具体目录页 URL，本文不列链接。