dsh-context-compaction-optimizer
DSH 插件：将消息标记为无效，使操作员注释摘要引导压缩检查点吸收哪些内容。保留缓存：在缓存前缀之后追加内容，从不重写历史记录。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:bigPaulSixSixSix/dsh-context-compaction-optimizer#4ea9a4900dd698ad1a190af1eea7a754e981c42cContext Compaction Optimizer 以 dsh-context-compaction-optimizer 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Mark a conversation turn as invalid so a DSH compaction leaves it out of the checkpoint — without deleting anything from the session.
A compaction summarizes an earlier span of a conversation and replaces it with a checkpoint. Everything in that span is summarized, including the tangents, dead ends and pasted material that were never worth remembering. This plugin lets an operator mark those exchanges, and tells the summarizing model to treat them as if they had never been written.
It works by marking, never deleting. No message is removed, reordered or rewritten, so the provider's prefix cache still hits and a compaction costs approximately what it did before.
Read this before relying on it. These are measured limits, not disclaimers.
dsh plugin --profile <profile> add dsh-context-compaction-optimizer
The plugin installs as a real bundle, so it arrives through the package's own
cordis.patch.yml. Do not also add a mount row to your profile patch — that
loads the host half twice, registers two stream listeners, and injects the digest
twice.
Restart the host after installing; the host half is loaded at process start.
Marking
Triggering
/cco-compact in the composer, or press Compact now at
the bottom of the panel.Marking itself triggers nothing. Both entry points act on the same unit — the turn — so they cannot disagree.
Under Settings → Plugins → Compaction optimizer.
| Setting | Default | Meaning |
|---|---|---|
| Inject annotations into compaction | on | Master switch. Off means marking has no effect. |
| Treat unmarked messages as invalid | off | Applies the exclusion to messages nobody annotated. With this on, a conversation you never annotated excludes everything. |
| Record cache accounting | off | Keeps token and cache-hit readings per compaction for diagnostics. |
One further key is settable in $DSH_HOME/settings.yaml but has no switch, because
it selects between two internal renderings of the same exclusion set and there is
nothing for an operator to decide:
context-compaction-optimizer:
digestFormat: spans # or: anchors
sessionId + messageId) in a DSH storage
domain. A turn's mark is one write across that turn's messages.The unit is the turn: annotations are stored per message, but review and action are grouped as "your message plus everything the agent did about it" — a turn routinely spans dozens of messages, so marking per message would ask for a dozen clicks to express one judgement.
npm test # unit + contract suites; no external dependencies
npm run build # emits lib/index.js and lib/client.js
npm run smoke # live mount check against a running host (http://127.0.0.1:3080)
npm run measure # cache/leak report from existing session logs
npm test runs without a build and without a host. npm run smoke requires a
running DSH and is the post-install verification step.
0.1.5-rc.*, Node.js 20+.llm/stream waterfall and the agent preset roster.compaction-basic; it is backend-independent
and coexists with the stock compaction stack.Apache-2.0 — see LICENSE.