dsh-context-decay
面向 DeepSeek Harness 的模型驱动有损上下文衰减：内联位置锚点、多跨度摘要、显式丢弃、分层重新压缩、不可恢复。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:LDyty/dsh-context-decay#3d0f368b6a8d19aa01dd763afdb5689cae3bb06fContext Decay 以 dsh-context-decay 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Model-driven, lossy context decay for DeepSeek Harness.
The model decides when and what to compress. Finished spans are replaced by self-written summaries; the current turn is always kept. There is no recovery: the summary is the only surviving record.
Install note: This is a manual-install plugin: it requires a DSH checkout with the
modelMessageDecorationseam and is not a drop-in plugin-market bundle (see Requirements).
⟦p<number>⟧; tool-call-only assistant turns are
unanchored by design. Compression ranges use those anchors directly:
⟦p<from>⟧ summary ⟦p<to>⟧. Anchors are presentation, never part of the content.compress with one or more
half-open ranges and writes each summary itself. No extra summarizer request.
Split around content that must stay live; pass all consumed spans in one call
so the prefix is not invalidated repeatedly.decompress, no
original-text search, and no external table. The summary must be self-contained.to
boundary at its first visible anchor keeps those messages and compresses only
the history before the turn; "end" remains the end-of-compressible-history
sentinel.drop removes a block
completely with no tombstone.patches/dsh-model-message-decoration.patch
applied. Stock DSH does not expose the decoration seam; there is no runtime
fallback. Installation alone is not enough: rebuild the host after patching.package.json.compaction-basic.auto: false), keeps the manual /compact command, and
disables the in-place surface rewriters (tool-result-pruner,
image-offload) when those rows exist. /compact remains an emergency
host fallback; its checkpoint is not a context-decay block.Manual patched install:
# 1. Apply the host patch to a DSH checkout and rebuild the host.
git -C /path/to/deepseek-harness apply /path/to/dsh-context-decay/patches/dsh-model-message-decoration.patch
pnpm -C /path/to/deepseek-harness install
pnpm -C /path/to/deepseek-harness build
# 2. Install this plugin into a profile (checkout or tarball).
dsh plugin --profile web add /path/to/dsh-context-decay
# or: dsh plugin --profile web add ./dsh-context-decay-0.1.0.tgz
# 3. Restart the web server and open the profile.
dsh web --profile web
See docs/INSTALL.md for the full patched-checkout workflow,
Windows commands, verification, updating, and rollback.
| Tool | Purpose |
|---|---|
compress({spans:[{from,to,summary,topic?}]}) | Replace one or more half-open ranges with self-written summaries. from/to are visible anchor texts such as "⟦p12⟧" (bare "p12" and integer 12 also work); to may also be "end". Several non-overlapping spans per call are allowed. Tool-group edges are rejected. |
drop({from,to}) | Remove exactly one live summary block. Use the block's printed anchor pair; "end" is allowed for a tail block. No tombstone, no recovery. |
A live summary block prints its pair inline as ⟦p<from>⟧ summary ⟦p<to>⟧; use that
pair for drop. The sidebar panel shows pressure and the block ledger, so no
extra status tool is needed.
Examples:
# one span
compress({spans:[{from:"⟦p4⟧", to:"⟦p9⟧", summary:"Read the three requirements files; constraints are ..."}]})
# two non-overlapping spans in one call
compress({spans:[
{from:"⟦p4⟧", to:"⟦p9⟧", summary:"Read the requirements; constraints are ..."},
{from:"⟦p9⟧", to:"end", summary:"Implemented the parser and tests; ..."}
]})
# drop one live summary block
drop({from:"⟦p4⟧", to:"⟦p9⟧"})
The anchor ids above are illustrative; use anchors visible in the current session.
| Key | Default | Meaning |
|---|---|---|
enabled | true | Enable the plugin. |
contextWindowTokens | route value | Override the total context window. |
reservedOutputTokens | route value | Override the reserved output budget. |
defaultContextWindowTokens | 128000 | Fallback when the route has no window. |
growthTokens | 20000 | Normal reminder after this much growth since the last reminder. |
warnRatios | [0.70, 0.81, 0.95] | Warning levels as fractions of the effective window. |
reminderCooldownTurns | 1 | Minimum turns between reminders. |
maxSpansPerCall | 8 | Maximum spans in one compress call. |
minSummaryChars | 20 | Minimum summary length. |
maxSummaryChars | 8000 | Maximum summary length. |
maxMissTokens | null | Optional one-time miss guard. |
maxPaybackRequests | null | Optional payback guard. |
audit | false | Write request/compression audit JSONL. |
debug | false | Verbose plugin logging. |
The effective window is total window - reserved output. The model sees
pressure as a fraction of the effective window. The panel labels that percentage
as effective pressure, shows the total and reservation, and adds a total-window
occupancy line for direct comparison with the built-in context meter. Pressure,
reminder, and request facts are kept per session, so switching sessions updates
the panel.
The host patch adds a modelMessageDecoration service. The plugin registers a
decoration provider that prefixes the messages selected by the replay state;
the agent loop, token meter, and request payload all apply the same decoration.
Positions come from the replayed surface, not from message text. Compressions
append compaction/start, compaction/summary, a replacement user message, and
compaction/end; replay rebuilds blocks, tiers, and the free list.
See docs/ARCHITECTURE.md for the state model,
invariants, and failure modes.
See docs/PROMPTS.zh-CN.md for a Chinese translation of
the model-facing prompts, tool descriptions, reminders, and error copy.
/compact remains available./compact is a manual fallback. It runs the official backend and writes an
official checkpoint, not a context-decay tier block. Use it only when a
session is already too large for a normal request.engines.dsh cannot distinguish a patched host
from a stock one. Distribute the checkout or tarball with the patch
instructions until the seam is upstream.surfaceOp and compaction event shape.npm install # if building outside a DSH checkout
npm run build # src/ -> lib/ (JS + declarations), client/ -> lib/client.js
npm run check # typecheck only
npm test # node:test suite against lib/
Local development can reuse a DSH checkout's TypeScript: set
DSH_HARNESS_ROOT or place the checkout next to this package.
MIT. See LICENSE.