dsh-dcp:锚点上下文压缩(链式摘要 + expand)+ LLM-DCP 提示词压缩
本插件包含两条独立能力线:
- 锚点压缩:对齐本机 omp 的 dcp 扩展(
~/.omp/agent/extensions/dcp,anchor mode), 由模型通过add_anchor/compress/expand主动管理工作上下文;摘要采用推荐的固定槽位, 但只做提示、不拒绝压缩;被吸收的旧压缩块形成链,全文随时可用expand取回; 两类提醒(token 压力 / 工作单元结束)驱动模型压缩。 - LLM-DCP(arXiv:2504.11004):既有的
dcp_compress工具,用可配置 LLM 充当 DCP-Agent 迭代压缩任意文本。 它不是 omp 对齐项,行为保持不变。
锚点压缩的完整规格、前置/后置条件、不变量与异常行为见
docs/anchor-compression.md。
对齐的上游提交:48d49ac(锚点压缩基线)→ c83eeaa(摘要槽位、继承校验、三类提醒)→
0583104(证据正则放宽)→ 99a4f87(摘要链路化、移除闸门与工具调用计数器)。
工具
add_anchor({ anchor })
在当前对话位置放置具名锚点;锚点身份是该工具调用的 provider tool-call id。
- 名字非空、不含空白、长度 ≤ 64;
session_start为保留名。 - 名字在整个会话内唯一(包括已被压缩消耗的锚点),重复会报错。
session_start是内置虚拟锚点,位于原始用户 prompt 之后;不需要标记消息。- 返回文本说明「这个锚点标记下一段的起点」:先打锚点、继续工作,结束时从更早的
锚点(或
session_start)压缩,把刚打的锚点留给下一段。 - 与
compress一样,add_anchor也必须是模型直接发起的工具调用;run_code子调用会报错,避免“返回成功但没有真正锚点”。
compress({ startAnchor, summary })
把从 startAnchor 到本次 compress 调用之前的上下文替换为模型自己写的技术摘要。
prompt · work1 · add_anchor(a1) · work2 · work3 · compress(a1, summary)
压缩后模型看到:
prompt · work1 · [Compressed: a1 → here] (block 1) summary · compress(a1, summary) · 确认结果
- 起点锚点及其结果被消耗;compress 调用与确认结果保留,后续轮次知道压缩发生过。
- 摘要由替换节点携带,落在 compress 调用之前;节点带
(block N)标识。 - 链式压缩的摘要按序累积;新起点在旧摘要之前时吸收旧块:旧块文本不删除,
在新摘要下渲染为一行索引(含 gist 与
expand({block: N})),全文随时可取回。 - 未知锚点、空区间、已消耗锚点、跨 system-prompt 更新、经
run_code子调用等情况 都会报错,且不产生任何会话事件;错误会列出可用锚点。 - 不再有
force参数:session_start可直接压缩。链保证旧文本仍可展开,所以 全量压缩不再是“不可恢复的失忆”;提醒文本仍建议优先用命名锚点。 - 摘要形状是请求,不是闸门:槽位缺失、证据缺失、自由格式都不会拒绝压缩;
偏差随成功结果返回为
摘要形状提示(已压缩,未拒绝)。
推荐的摘要结构(固定槽位 + 证据定位):
## 当前任务 - 正在做的事 证据: <定位>
## 已完成 - 动作/结论 证据: <定位>
## 未完成 - 下一步具体动作 证据: <定位>
## 约束 - 用户要求/不变量 证据: <定位>
## 文件与命令 - 关键路径/命令 证据: <定位>
## 在跑作业与句柄 - 作业/子代理/端口 证据: <定位>
- 六个槽位各一次、建议按此顺序;没有内容的槽位写单条
- 无;当前任务建议写实际任务。 - 每条事实是
-开头的条目,并以证据: <定位>结尾(路径、file:line、会话 id、 commit、URL、命令)。定位没有白名单:。证据:、全角冒号、任意定位文本都接受。 - 摘要是指针,不是原文副本;吸收旧块时不再要求逐字继承旧定位——旧块全文就在链里。
持久化语义:dsh 的 loop 请求是会话日志的纯函数,不能像 omp 一样只改请求副本。
因此本插件使用 dsh 官方的 surface replacement 机制:只追加事件,不删除或改写原始日志;
被压缩区间仅从派生给模型的历史中遮蔽,resume 后仍保持压缩结果。
替换前紧邻追加 compaction/prune 影子计价事件,保证上下文占用投影按
「被遮蔽区间 − 摘要节点」正确更新,不发生漂移。
压缩块没有独立状态:它们就是带 source.kind === 'dcp-compress' 的 user/message 事件。
blockId / parentIds 记录在消息的 source 里;旧版本(无 blockId)的块按日志顺序
补号,跨 resume 稳定。
expand({ block })
取回一条压缩块的全文——通常来自更新摘要下的索引行。返回该块模型摘要的全文, 并附上它自己的索引行(若有更深一层),因此可以沿链继续往回走。 块已经不在当前表面上(被后来压缩吸收)也仍然可取回,因为原始事件保留在日志里。 未知块号报错并列出已知块号。
注意:expand 只还原压缩块(模型写的摘要),不还原被压缩区间内的原始消息或
工具返回——那些原始事件仍在会话日志里,但不会重新进入派生给模型的上下文。
dcp_compress
既有 LLM-DCP 工具:多步迭代压缩 prompt/文档/会话文本,支持 targetRatio、steps、
keyPoints 与 provider/model 覆盖。与上面的锚点压缩不是同一能力。
配置(仅环境变量,无配置文件)
| 变量 | 含义 |
|---|---|
DCP_REMIND_THRESHOLD |
token 压力提醒阈值。缺省 0.4;(0,1) 为上下文窗口比例,>=1 为绝对 token 数,<=0 关闭。 |
DCP_DEBUG |
非空且非 0/false/off/no 时,写 $DSH_HOME/logs/dcp/dcp.log 与 context-<session>.jsonl。 |
提醒在 agent/pre-step 注入,两类按优先级 [dcp:context] > [dcp:unit],
每个 turn 至多一条;[dcp:context] 还按上下文每增长 10% 才提醒一次——档位从最近一条
token 提醒的估算值推导,其后的压缩或估算回落会重置档位(不新增持久状态)。
与 omp 不同,dsh 的提醒是普通 user/message 事件,会持久化,因此用 turn 级节流 +
档位共同限制重复(omp 的提醒不落盘,靠每请求 + 档位)。
[dcp:context]:估算上下文达到阈值。[dcp:unit]:最新的todo_write结果报告列表完成 (dsh 的Updated todo list: 0 pending, 0 in progress, N completed.,N>0; 也识别 omp 宿主的All items complete/Remaining items (0)/Remaining items: none./0 open)。按结果 toolCallId 去重——同一个完成结果只提醒一次, 模型再次调用todo_write并完成后才会重新提醒。
没有工具调用计数器(omp 99a4f87 删除 [dcp:budget]):调用数不是上下文代价。
旧实现按 40 次调用提醒,会在上下文远未接近窗口时逼模型压缩,随后不得不重读刚读过的文件。
token 压力是唯一可度量的成本,所以只保留 token / unit 两类触发。
token 压力提醒缺省阈值取 0.4 而非 omp 的 0.8,是为了让模型驱动压缩先于 dsh 自动
compaction(后者压力预算约为 0.8 × (window − 输出预留 − 64k headroom))。
token 缺失时的启发式估算按 CJK(约 2 字符/token)与 ASCII(约 4 字符/token)分档,
避免中文会话被低估约 40%。
压缩需要 ctx.tokenMeter(dsh-base 默认挂载)计算影子价格;服务缺席时明确报错,
不会静默造成上下文占用漂移。
安装
要求 dsh 0.2.1-rc.2 或更高的 0.2.x(peer 为 @deepseek-ai/dsh-tools /
@deepseek-ai/dsh-llm / @deepseek-ai/dsh-session / @deepseek-ai/dsh-token-meter
^0.2.1-rc.2;本机开发/测试对齐 0.2.1-rc.3)。
# 0) 在插件目录安装依赖(link: 插件需要自己的 node_modules)
npm install
# 1) 安装到目标 profile(web/desktop 均按 workspace 根处理,需 -w)
dsh plugin --profile web add -w <path/to/dcp-plugin>
# desktop 也可:
dsh plugin --profile desktop add -w <path/to/dcp-plugin>
# 2) 在对应 profile 的 cordis.patch.yml 追加(已有则无需重复):
# - insert:
# - id: dsh-dcp
# name: 'dsh-dcp'
新装依赖或修改插件源码后,若需要在不重启应用的情况下生效,可改变
cordis.patch.yml 的内容(例如增删一行注释):HMR 会重新组合 profile,并把已变化的
link: 包目标一起替换。2026-11-03 实测:只 touch(仅改 mtime)不会触发;内容变化后
当前 web 进程成功从旧版工具表切换到 0.4(新提醒文本、expand 工具、带 blockId 的
压缩节点均生效)。dsh plugin add 新装 npm 依赖仍需要重启 web 服务才能被 Loader 解析。
测试
node --test test/compress-tests.mjs test/tool-tests.mjs test/blocks-tests.mjs \
test/anchor-tests.mjs test/anchor-tool-tests.mjs test/remind-tests.mjs test/summary-tests.mjs
在受限沙箱(如 DSH 文件沙箱)内 Node 测试运行器 spawn 子进程会 EPERM,
改用 node --test --test-isolation=none ... 在同一进程内运行。
覆盖:LLM-DCP 既有回归、锚点扫描与唯一性、session_start、区间替换、链式累积、
吸收旧块与索引行、expand 全文取回/未知块号、旧块补号、摘要 advisory 解析与证据正则、
两类提醒的触发/优先级/节流/unit 去重、token 提醒的 10% 档位、CJK 估算、工具注册与参数校验。
本版本的单元/集成测试在真实 dsh Session(0.2.1-rc.3)上运行,覆盖上述全部逻辑,共 83 项全绿。
实机 e2e(链式吸收 / expand,2026-11-03,desktop profile,HMR 重载后的 web 进程,
子代理独立会话):模型依次执行
write note.txt → add_anchor e2e-a1 → read → compress(e2e-a1) → add_anchor e2e-a2 → write note.txt → compress(session_start) → expand(block 1),真实 dsh 0.2.1-rc.3 会话日志确认:
#28 tool-call add_anchor e2e-a1
#42 compaction/prune shadowedSeqs [28,30,34,36], shadowedTokenCount 166
#43 dcp-compress block=1 parents=[] anchor=e2e-a1
[Compressed: e2e-a1 → here] (block 1) …
#44 tool/result as block 1;4 message(s) elided, ~43 tokens freed
#63 compaction/prune shadowedSeqs [13 nodes], shadowedTokenCount 4331
#64 dcp-compress block=2 parents=[1] anchor=session_start
…已并入本块的旧压缩块(索引,全文未丢失):
- 块 1「e2e-a1」:验证 dcp 锚点压缩 — 全文: expand({block: 1})
#65 tool/result as block 2. Absorbed 1 prior block(s);13 message(s) elided, ~4187 tokens freed
#75 tool/result expand:"[block 1「e2e-a1」 — 全文]" + 块 1 摘要全文
#77 tool/result read note.txt → alpha / beta
返回的 freedTokens 按 shadowedTokenCount − 摘要节点估算 token 计算(下限为 0),
不是把被遮蔽区间的总量误报为净释放量。原始 add_anchor/read 事件仍在日志中;派生上下文只保留
摘要、compress 调用与确认结果。第二次压缩跨过第一次压缩时,新块的索引行列出旧块号并可用
expand({block: 1}) 取回旧摘要全文——链式吸收与全文取回均已在实机验证。
实现结构
lib/index.js 插件入口:注册 3 个锚点工具 + dcp_compress 与提醒监听
lib/anchor/anchors.js 表面节点/锚点扫描、名字校验、session_start
lib/anchor/blocks.js 压缩块链:日志扫描/补号、祖先索引、expand 渲染
lib/anchor/compress.js 区间解析、校验、影子计价 + 替换提交(链元数据)
lib/anchor/summary.js advisory 摘要解析、证据定位、gist、问题提示
lib/anchor/prompts.js 工具描述、摘要与两类提醒文本、索引格式
lib/anchor/remind.js 阈值解析、token 估算(CJK 分档)、两类提醒与去重/节流
lib/anchor/logger.js DCP_DEBUG 文件日志与 cordis logger
lib/tools/anchor.js add_anchor / compress / expand 工具接线
lib/dcp/compress.js 既有 LLM-DCP 核心
lib/tools/compress.js 既有 dcp_compress 工具
与 omp 的刻意差异(完整清单见规格文档):压缩是持久的 append-only 表面替换;
不注入 session_start 标记消息;提醒会持久化且每 turn 至多一次;缺省提醒阈值为 0.4;
in-history system-prompt 更新不可被压缩区间遮蔽;token 提醒的 10% 档位与 unit 去重水位
都从日志推导而不写独立状态;压缩块本身也是日志事件,没有 omp 的 dcp-state 与版本迁移;
dsh 禁止 run_code 子调用压缩,因此无需 omp 的 eval-kernel 绕过路径。
参考
- 对齐基准:
~/.omp/agent/extensions/dcp(README、docs/design.md、src/*),当前跟进99a4f87。 - 规格:
docs/anchor-compression.md。 - LLM-DCP:https://arxiv.org/abs/2504.11004 · 官方仓库(暂无代码):https://github.com/Fhujinwu/DCP
No comments yet. Be the first to write one.