@xiaobanli/dsh-compact-after-task
在当前任务完成后，根据用户设置的上下文阈值自动压缩 DSH 对话。包含易失性 Config 字段，以及 Settings -> Plugins 中的专用卡片。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @xiaobanli/dsh-compact-after-task@0.2.0
Compact After Task 以 @xiaobanli/dsh-compact-after-task 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DSH (Cordis) plugin that auto-compacts a conversation after the current task finishes, whenever context pressure crosses a threshold you set (default 50% of the routed model's context window). Install it and stop manually clicking "compress" — and stop letting the context (and the bill) grow unchecked.
The switch and the threshold live on a dedicated card under Settings → Plugins → "Auto-compact" (toggle + slider); changes apply immediately, no restart needed.
In a long conversation the model re-receives the entire history on every turn. As the conversation grows, this bites harder and harder:
/compact or the UI compress button works, but you have to remember to use it — and people only remember once things are already slow and expensive, after several huge turns have been paid for.dsh-compaction-basic only fires at 80% of the context window, and only at a step boundary while a task is running — by then you've already paid for several enormous requests, and the compaction interrupts work in progress.This plugin automates the "remember to compress" chore: after each task finishes (the agent returns to idle) it checks the pressure and compacts at your chosen threshold — dealing with cost before it hurts, not after.
Built-in dsh-compaction-basic | This plugin | |
|---|---|---|
| When | At each step boundary (agent/pre-step), mid-task | After the task fully finishes (agent returns to idle) |
| Threshold | thresholdRatio 0.8 (fixed) | thresholdRatio user-set, default 0.5 |
| Role | Last-resort mid-task safety net | Routine "slim down between tasks" |
The compaction itself is identical to /compact: it calls ctx.compaction.compactNow(), produces one <compacted-summary> checkpoint, and the conversation UI shows the usual "compacted N history items" card.
dsh-base), which provides dsh-compaction-basic, dsh-token-meter, dsh-agent and dsh-llm.0.1.7-alpha.2, because that release removed the third-party settings-card mechanism (Host-side settings.installSection, the settings.plugin.item slot and the settingsScope client service). This plugin instead declares its Config fields with .volatile(): the Plugins page auto-generates a form for the entry from that schema, keyed by the profile entry id (compact-after-task). A .volatile() field is a stable reference ({ get() }) at runtime — the loader commits a new immutable snapshot into the same reference when the user saves, so the plugin reads the current value on every use and needs neither a restart nor a change subscription. On runtimes without volatile support the same fields arrive as plain values, which the plugin also accepts.agentPresets.serviceFor(), not inject: ["compaction"]. Since agent presets arrived, the compaction service is no longer provided on the host plane — each session's preset (standard/cordis/…) mounts it inside an isolate realm, so a host-plane plugin that injects compaction pends forever (waiting for service: compaction). This plugin instead calls the official read API ctx.agentPresets.serviceFor(agent, "compaction") when the agent goes idle (that API exists precisely for callers whose request is about a session but arrives from outside it); on runtimes without agent presets it falls back to ctx.get("compaction").Two ways — pick one (do not mix them: the loader rejects a duplicate entry id).
dsh plugin add (recommended)The package ships a dsh.bundle.patch pointing at its own cordis.patch.yml, so it is a first-class bundle: installing it via the market or the CLI adds it to the profile's dsh.profile.bundles, and on the next boot the loader applies the package's own patch layer automatically — no manual editing needed.
# from npm (after publishing) — or from GitHub directly:
dsh plugin --profile desktop add @xiaobanli/dsh-compact-after-task
dsh plugin --profile desktop add github:xiaoliang2/dsh-compact-after-task
Or, in the desktop app, open Settings → Plugin Market and one-click install. Restart DSH Desktop, done.
Copy this package into the profile and make it resolvable from the profile's node_modules (same way dshmarket is installed):
# from the DSH home, e.g. C:\Users\you\.dsh\profiles\desktop
Copy-Item -Recurse <path-to>\dsh-compact-after-task .\plugins\dsh-compact-after-task
New-Item -ItemType Junction -Path .\node_modules\@xiaobanli\dsh-compact-after-task -Target .\plugins\dsh-compact-after-task
Add the plugin row to the profile's cordis.patch.yml (your user patch layer, applied after every bundle layer):
- insert:
- id: compact-after-task
name: '@xiaobanli/dsh-compact-after-task'
config:
enabled: true
thresholdRatio: 0.5
Declare the dependency in the profile's package.json so a later pnpm install does not prune it:
"dependencies": {
"@xiaobanli/dsh-compact-after-task": "file:plugins/dsh-compact-after-task"
}
Restart DSH Desktop for the profile change to take effect.
If you already installed it manually (method B), uninstall/remove it before installing via the market, otherwise the same entry id
compact-after-taskis inserted twice and the loader refuses to boot.
| Key | Type | Default | Meaning |
|---|---|---|---|
enabled | boolean | true | Master switch. |
thresholdRatio | number (0.05–1) | 0.5 | Compress when pressure reaches this fraction of the routed model's context window (0.5 = 50%). |
onlyRoots | boolean | false | Only compress top-level conversation agents (skip background subagents). |
After install, open Settings → Plugins: beside the plugin list there is now an Auto-compact tab holding one card:
cordis.patch.yml base-layer value.The card binds its entry's settings namespace (compact-after-task) through the official client service ctx.configForms: saving writes into your profile's patch for that entry, and the loader commits the new value into the running plugin — no restart needed. (The same values are also editable from the plugin manager's auto-generated form for that row; the two are equivalent.)
Set it from "the max per-turn re-send you can tolerate ÷ the model's context window":
Tune by feel after a couple of long tasks: compressing after every little task / summaries getting coarse → raise it; still re-sending hundreds of thousands of tokens per turn → lower it. Drag the slider on the Auto-compact card (live) or edit cordis.patch.yml (base layer; restart).
agent/status event and acts only on the idle transition — i.e. the current task's drive has fully drained. This is the "compress after finishing the current task" moment; it never interrupts a running task.tokenMeter.measure(session).totalTokens vs contextWindow × thresholdRatio (context window resolved via llm.resolveModelInfo).ctx.compaction.compactNow(agent, signal) call — the same operation /compact runs; compactNow reserves next-turn admission, so queued messages are correctly deferred until the compaction finishes. On rc.7+ ctx.compaction is the instance returned by agentPresets.serviceFor(agent, "compaction"); the operation is unchanged.busy (agent busy / a compaction already running) and cancelled are skipped; anything else is logged as a warning without disturbing agent lifecycle events.minimal), serviceFor returns undefined and that agent is skipped.npm install
node test-compact-after-task.mjs
The unit test stubs the services and covers: idle + above threshold compacts, below threshold does not, running does not, busy is silent, disabled does nothing, onlyRoots filters subagents, the agentPresets.serviceFor and host-plane fallback paths, live .volatile() config reads (threshold and switch changed between events), and legacy plain-value config.