dsh-compaction-cacheaware
适用于 DeepSeek Harness (DSH) 的 Reasonix 风格、缓存感知型压缩后端。通过 compact_ratio、一个结构化摘要检查点和稳定的近期尾部替换/增强 compaction-basic。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-compaction-cacheaware@0.1.11Compaction Cacheaware 以 dsh-compaction-cacheaware 发布，当前版本为 0.1.11。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Reasonix-style cache-aware compaction backend for DeepSeek Harness (DSH).
This is a standalone, modular DSH plugin. It implements the official
@deepseek-ai/dsh-compaction seam (ctx.compaction) and is designed to be
mounted instead of @deepseek-ai/dsh-compaction-basic inside a preset's
compaction realm. It does not modify other plugins, presets, or host files.
🐋 收录于 DSH 插件社区目录（1024Store）
本仓库带
dsh-plugintopic，且package.json声明了有效的dsh.bundle.patch（patch 文件随仓库同 revision 提交），可被 awesome-deepseek-harness-plugins 目录的静态校验收录。 在线市场：https://deepseek1024.com/
compact_ratio (default 0.85), not multiple
soft/snip/force thresholds.clamp(window×10%, 32K, 96K).replace shadows the old
range in the model-visible projection only; the raw session log remains the
source of truth.Standing facts & constraints, Goal,
Decisions & rationale, Files & code, Commands & outcomes,
Errors & fixes, Pending & next step.已发布到 npm registry，直接安装：
cd "$env:USERPROFILE\.dsh\profiles\web"
pnpm add dsh-compaction-cacheaware
本包自带 DSH profile bundle 声明和 cordis.patch.yml。将
dsh-compaction-cacheaware 加入 profile 的 dsh.profile.bundles 后，DSH
会自动禁用 compaction-basic 并挂载本后端；不要再把同一条插入 patch
重复添加到 profile 的 cordis.patch.yml。
也可以从 GitHub 安装：
pnpm add dsh-compaction-cacheaware@github:Zhuchen00123/dsh-compaction-cacheaware
pnpm install
pnpm build
如果不使用 profile bundle，也可以在 preset 的 compaction realm 里手动替换：
# - id: compaction-basic
# name: '@deepseek-ai/dsh-compaction-basic'
- id: compaction-cacheaware
name: 'dsh-compaction-cacheaware'
config:
compactRatio: 0.85
checkpointCeilingRatio: 0.5
recentTailRatio: 0.1
recentTailMinTokens: 8192
recentTailMaxTokens: 16384
summaryMaxTokens: 16384
如果从源码本地调试，也可以直接用编译产物路径：
- id: compaction-cacheaware
name: 'file:///absolute/path/to/dsh-compaction-cacheaware/lib/index.js'
config:
compactRatio: 0.85
checkpointCeilingRatio: 0.5
recentTailRatio: 0.1
recentTailMinTokens: 8192
recentTailMaxTokens: 16384
summaryMaxTokens: 16384
Note: mounts inside an agent preset's isolated compaction realm replace
compaction-basic there directly; the profile-level bundle patch cannot reach
that realm, so every preset that ships compaction-basic in its own compaction
group must be migrated to this package.
Keep @deepseek-ai/dsh-command-compact in the same realm so /compact uses
this backend. The optional @deepseek-ai/dsh-compaction-tool-result-pruner can
still be mounted as a sibling; this plugin reads it through ctx.get().
| Key | Default | Meaning |
|---|---|---|
compactRatio | 0.85 | Sole automatic trigger fraction. |
checkpointCeilingRatio | 0.5 | Normal auto-checkpoint acceptance ceiling. |
recentTailRatio | 0.1 | Recent verbatim tail fraction. |
recentTailMinTokens | 8192 | Lower bound for production tail (lowered from upstream 32K so compaction still triggers under token-meter underestimation). |
recentTailMaxTokens | 16384 | Upper bound for production tail (lowered from upstream 96K, same reason). |
summaryMaxTokens | 16384 | Summarizer output cap. |
exceptionalMinSavingsRatio | 0.25 | Required savings when fixed prefix exceeds ceiling. |
minRecentKeep | 2 | Minimum recent messages kept. |
minCompactMessages | 2 | Minimum compactable messages. |
maxPinnedFirstUserTokens | 1500 | Pin first user turn if ≤ this. |
pinnedFirstUserWindowFrac | 0.15 | First-user pin window fraction cap. |
protocolReserveTokens | 256 | Framing reserve. |
summarizationProvider / summarizationModel | '' | Optional summary route; defaults to conversation route. |
auto | true | Register automatic pressure/overflow listeners. |
ctx.compaction and its own automatic listeners.ctx.compaction in the same realm, and if a
later mount supersedes this instance, its automatic listeners stand down
(warn-once, hot-reload aware) instead of racing the new owner. Note a
profile-level bundle patch cannot reach an agent preset's isolated
compaction realm — migrate each preset individually.dsh-wsl-bash, dsh-team-dashboard, router-opencode-wsl,
or any other plugin.cordis.patch.example.yml in this package.scripts/sync-reasonix-compact.mjs and the GitHub Action in
.github/workflows/sync-reasonix-compact.yml watch
esengine/DeepSeek-Reasonix and open/update a PR when the upstream compact
implementation changes. The sync job:
main-v2 Reasonix source.vendor/reasonix/compact/ with the upstream compact files and
design docs.src/generated/reasonix-constants.ts from the Go constants and
summary prompt (when they change).The generated constants are imported by this package so tuning values stay traceable to upstream.
This repository is designed to be published as a standalone public GitHub repo.
The 1024Store catalog
discovers public repos with the dsh-plugin topic and statically validates the
dsh.bundle.patch declaration (the patch file must exist in the same tree).
# 1. Authenticate GitHub CLI once
gh auth login
# 2. From this repository root, publish and add catalog topics
./scripts/publish.sh dsh-compaction-cacheaware
scripts/publish.sh will:
dsh-plugin, deepseek-harness, and reasonix topics.After that, deepseek1024.com lists the entry (browse-only until the npm package is published; installs come from npm).
MIT