dsh-ledger-compact

English · 中文

dsh-plugin for DeepSeek Harness. Large tool results are shaped before they reach the model. An optional local fold can replace DSH’s LLM /compact.

Why

Long agent turns dump huge tool_result blocks into the next request. DSH already has an excellent LLM compact (@deepseek-ai/dsh-compaction-basic), but it costs an extra model call and runs after pressure builds.

This plugin does two cheaper things first, and optionally a third:

1. Ingress shaping — freeze oversized unsent tool results into a head/tail excerpt on the idle pre-step. History that already entered the prefix is left alone.
2. Mechanical fold — /fast-compact and the input-bar bolt collapse older history into a short ledger card. No model call.
3. Replace default compact (off) — reuse the official engine’s summarize hook so /compact, auto-compaction, and overflow recovery also skip the LLM.

Keep dsh-compaction-basic mounted. This plugin does not replace the engine.

Install

Requires dsh ≥ 0.1.2-rc.1.

dsh plugin --profile web add github:telagod/dsh-ledger-compact

Restart the web profile after install. The bundle patch inserts plugin id dsh-ledger-compact.

From a local checkout:

git clone https://github.com/telagod/dsh-ledger-compact.git
dsh plugin --profile web add ./dsh-ledger-compact

What you get

The input-bar bolt is a context-pressure meter. By default it needs a second click before folding (can be turned off). After a fold, the chat shows an expandable row in the same style as the official compact line; the open view is a slim left-axis timeline, not a model essay.

Settings

Open Settings → 快速压缩. Changes write through to the Host document immediately.

Turn Replace default compact off at any time to restore DSH’s LLM checkpoint. /fast-compact stays mechanical either way.

Commands

/fast-compact
/fast-compact status

There is no vision sidecar. /fast-compact vision … was removed.

/compact remains the official DSH command. With replace-default off, it still calls the model. With it on, the same command runs the mechanical fold through the existing engine.

Ingress excerpt

Default is text only — no PNG, no LLM. Already-shaped placeholders are not rewritten. skill and context tool results are skipped. If tokenMeter is missing, ingress is skipped so the plugin never replaces without writing compaction/prune.

[Snapcompact: N tokens → excerpt]
first 16 lines
… (K lines elided; see image if attached. To inspect or edit exact bytes, re-read with offset/limit) …
last 8 lines

A PNG is attached only when all of these hold:

• “Allow dense PNG” is on
• the routed model’s inputModalities explicitly includes image (names like gpt-4o are never guessed)
• excerpt + estimated image tokens ≤ original × savings ratio (default 15% cheaper)

Fold card

Mechanical, no model. Prior fold placeholders and <compacted-summary> blocks are dropped, not nested.

[Snapcompact] Fold ~N tok. Exact file bytes are not stored — re-read with offset/limit if a detail matters.
FILES
- [edit] path
- [read] path
INTENTS
- recent user goals
TOOLS
- read 4
COMMANDS
- …
ERRORS
- …
EXCERPT
[user] …
[tool] …

This is cheaper and more predictable than an LLM checkpoint. It also keeps less prose: paths, intents, tool counts, and a short excerpt — not a narrative of why.

Working with DSH compact

Do not unmount @deepseek-ai/dsh-compaction-basic.

• Pressure, range selection, shrink checks, and durable compaction/* events stay on the official engine.
• This plugin only wraps summarize().
• /fast-compact marks the current agent for one compactNow() so other sessions keep the LLM path.
• Replace-default is a live setting: every hooked engine uses the mechanical summarizer until you turn it off (or unload the plugin).

On web, compaction lives in the preset isolate. Host code reads it with agentPresets.serviceFor(agent, "compaction"), not inject: ['compaction'].

Develop

node --test lib/ledger.test.js

License

MIT. Bitmap fonts under lib/fonts/ are documented in lib/fonts/README.md.