dsh-compaction-micro
用于 DeepSeek Harness 压缩的分层微清理层：在官方摘要层之前，将列入白名单的可重新运行工具结果清除为占位符，在无需调用模型的情况下释放上下文空间。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Perfirstvito/dsh-compaction-micro#e0df7557e18d611d340c884c143ce2472929cdffCompaction Micro 以 dsh-compaction-micro 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Standalone micro-clear tier for DeepSeek Harness compaction. It clears whitelisted, re-runnable tool results to placeholders at its own microThresholdRatio — below the summarize threshold — so the expensive model-backed summary runs less often. It is an observer: it never mutates the model request, makes no model call, and every rewrite is a single-node tool/result content replacement preceded by a compaction/prune shadow-price event, so the durable log stays the reconstructable source of truth.
Snip (trimming) and full (summarization) stay owned by the official dsh-compaction-tool-result-pruner and dsh-compaction-basic.
Mount this bundle before dsh-compaction-basic. Its agent/pre-step and agent/request-error listeners are registered with prepend: true, so they run first regardless of mount order:
- name: '@deepseek-ai/dsh-token-meter'
- name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
- name: '@deepseek-ai/dsh-compaction-basic'
config:
thresholdRatio: 0.9
- name: 'dsh-compaction-micro'
config:
clearableTools: [read, glob, grep, web_search, web_fetch]
retainRecent: 3
microThresholdRatio: 0.85
reservedTokens: 0
agent/pre-step (prepend): measure pressure; when totalTokens >= floor((contextWindow - reservedTokens) × microThresholdRatio), clear whitelisted tool results oldest-first, retaining the newest retainRecent visible. The official backend then re-measures the smaller surface and skips summarization when the clear already relieved enough pressure.agent/request-error (prepend): on a confirmed context overflow, clear whitelisted results first, then delegate to the official prune + summarize + retry.| Field | Default | Meaning |
|---|---|---|
clearableTools | [] | Tool names whose results the micro tier may clear. Empty disables the tier. Only list read-only, re-runnable tools — the service does not verify that property. |
retainRecent | 3 | Newest clearable results always retained visible. |
microThresholdRatio | 0.85 | Clear at this fraction of the effective window. Must be in (0, 1]. |
reservedTokens | 0 | Tokens subtracted from the routed context window before scaling the threshold. |
auto | true | Install the automatic listeners; false exposes only ctx.microCompaction.clearSession(). |
The whitelist is operator-owned and is the safety gate: read/glob/grep and read-only web tools are the intended members; write, edit, shell, subprocess, and workflow tools must stay out.
Build against a local DeepSeek Harness checkout by junctioning its workspace packages into node_modules/@deepseek-ai (see the checkout's packages/*/* and vendor/*), then:
npm run typecheck # tsc -p tsconfig.json --noEmit
node --import tsx --test tests/micro.test.ts
Runtime smoke (from the DSH checkout):
dsh plugin --profile headless add link:<this-dir>
DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1 DEEPSEEK_API_KEY=mock-key \
dsh --profile headless "run the pwsh tool once and report"
MIT