@playform/hook-dsh-ccr
CCR hook（compress-cache-retrieve）：一个 DeepSeek Harness 插件，用于挂接 tools/post-execute 流程——每个已调度工具的规范化结果在成为模型内容之前都会经过此处——并将过大的工具输出替换为
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @playform/hook-dsh-ccr@0.2.1Hook Dsh Ccr 以 @playform/hook-dsh-ccr 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Version 0.2.1 - UNPUBLISHED (the npm bootstrap tier 2-planned / 3-candidates).
This DeepSeek Harness plugin hooks the tools/post-execute waterfall - the interceptable
wrapper around every normalized dispatch result, before it becomes model content - and it replaces
oversized tool output with a one-line type-aware preview plus a retrieval marker:
[terminal:exit 0 | 142 lines | make: *** Error 1]
<<<CCR:9d3c1f0a7b2e4d5c6a8b9c0d|terminal|5231>>>
... while it keeps the original retrievable through the registered ccr_retrieve tool.
It is ported from Aphrodite's CCR pipeline - compress, cache, retrieve - at the injection point that a proxy cannot reach: the tool result itself.
tools/post-execute sees the normalized result of EVERY tool with the name, the parsed arguments,
and the caller agent, and it is the only point that can legally replace model-visible output for all
tools.
The gate compresses only results of tools in targets (default: bash, glob, grep, read,
web_fetch, web_search, list, search) whose serialized content exceeds thresholdBytes
(1024) × the classified type's multiplier - errors ×8 (high-signal, compress late), grep/paths/
web ×2, the rest ×1.
It never compresses the exempt tools: write, edit, raw-write, subagent,
ask_user_question, and ccr_retrieve itself.
Failures pass through unless compressFailures is on.
With autoExpand on (the default), a result at or under autoExpandLimitBytes (102400) is stored
but returned FULL - no marker reaches the model while the content is cheap enough to keep inline.
The store is an in-memory LRU keyed by a sha256-24 hash of the full serialized content bytes
(node:crypto, no native deps), with a storeBudgetBytes budget (default 256 MiB,
least-recently-accessed eviction), a ttlSeconds TTL (default 3600), and an optional JSONL disk
journal (journalPath, default "" = memory-only): one {hash, type, size, ttlAt, payload} record
per store, loaded and TTL-compacted on boot, payload base64.
The family deliberately adapted SQLite (Aphrodite's ccr.db) to JSONL - a native dep the family
does not carry.
ccr_retrieve(hash, range?) matches the hash exactly - no prefix or fuzzy matching.
range { start, count } slices lines granularly.
Unknown/expired hashes return a self-describing error that tells the model to re-run the original tool.
Waterfall discipline: the hook always awaits next() first; a pass-through returns the downstream
decision unchanged; only an accepted, non-value-carrying decision is replaced; the whole transform
is fail-open (an internal error logs a warning and keeps the inline content, and never throws into
the waterfall); the listener prepends so the gate sees the pristine result.
The ccr hook and the normalize flavors' tool-results arm share the tools/post-execute waterfall;
the <<<CCR: marker guard makes any load order safe.
| Kind | Name | What |
|---|---|---|
| listener | tools/post-execute (prepend) | the compression gate: replace oversized results with a preview + <<<CCR:...>>> marker |
| listener | agent/pre-step (with contextEngine) | the engine phase: archives oversized stored results between turns |
| tool | ccr_retrieve | restores stored output by exact hash, optionally a { start, count } line range |
| config | SCHEME.md | the full Schemastery schema (see the table below) |
| Field | Type | Default | Meaning |
|---|---|---|---|
log | boolean | true | volatile - the shared factory log switch |
logFile | string | ~/.dsh/playform/hook-dsh-ccr.log | volatile - the ledger file |
targets | array | bash, glob, grep, read, web_fetch, web_search, list, search | the tools whose results the gate compresses |
exempt | array | write, edit, raw-write, subagent, ask_user_question, ccr_retrieve | never compressed |
thresholdBytes | number | 1024 | volatile - the base size threshold |
inlineThresholdBytes | number | 1024 | results under this stay inline untouched |
autoExpand | boolean | true | store but return FULL while the content is cheap enough |
autoExpandLimitBytes | number | 102400 | the auto-expand ceiling |
compressFailures | boolean | false | off, error results pass through |
multipliers | object | terminal 1, error 8, grep 2, paths 2, file 1, json 1, web 2, default 1 | volatile - the per-type threshold multipliers |
previewMaxChars | number | 240 | volatile - the preview length cap |
ttlSeconds | number | 3600 | the store TTL |
storeBudgetBytes | number | 268435456 | the LRU budget (256 MiB) |
ccr: activated (bundle 0.2.1, targets <n>, budget <n>)
ccr: stored <tool> <type> <size> -> <hash>
ccr: compressed <tool> <type> <size> -> <hash>
ccr: evicted <hash> (<reason>)
ccr: retrieved <hash>
ccr: retrieval miss <hash> (expired)
ccr: retrieval miss <hash> (unknown)
ccr: engine archived <n> results
pnpm --config.verify-deps-before-run=false --dir Classic/packages/hook-dsh-ccr run prepublishOnlynode Classic/packages/hook-dsh-ccr/Target/Test/<Folder>/Test.js
journalPath | string | "" | memory-only unless a JSONL journal path is set |
contextEngine | boolean | false | the engine phase stays inert |
contextEngineThresholdPct | number | 30 | the engine's budget-percentage trigger |
protectFirstTurns | number | 2 | turns the engine never archives at the front |
protectLastTurns | number | 4 | turns the engine never archives at the back |