@kober-basket/dsh-cachescope
DeepSeek Harness 的提示缓存可观测性和逻辑输入诊断
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:kober-basket/dsh-cachescope#adfea3f7d370b22b35376220afca4002b40c4534
Cachescope 以 @kober-basket/dsh-cachescope 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
See how much prompt cache a model call used—and what changed when it missed.
CacheScope puts provider-reported cache-token usage beside the DSH-side difference between adjacent logical inputs. It records observed llm/stream attempts and serves a desktop dashboard without modifying model requests or registering a model-visible tool.
Dashboard shown with synthetic sample calls. Provider figures are illustrative.
Install the bundle into the Web profile and start DSH:
dsh plugin --profile web add @kober-basket/dsh-cachescope
dsh web
Open http://127.0.0.1:3080/cachescope.
Prompt privacy: the installed bundle enables
captureInput: full. By default it can retain the latest 12 complete logical inputs in DSH process memory, up to 2,000,000 UTF-8 JSON bytes each. Use the metadata-only configuration below before sending sensitive prompts if complete-input inspection is unnecessary.
- id: cachescope
name: '@kober-basket/dsh-cachescope'
config:
captureInput: metadata
Restart DSH after changing the profile.
The first observed call has no local comparison baseline. Cache Read also remains unreported when the provider adapter does not carry that usage field; a missing field is not treated as zero.
The table initially filters to conversations. Clear the purpose filter to include title generation, compaction, and direct model calls.
current uncached = previous uncached + ΔPrompt - ΔCache Read - ΔCache Write.| Evidence | Source and meaning | Does not mean |
|---|---|---|
Selected Cache Read / Prompt | Provider usage normalized by the DSH adapter for one call. | A local diff percentage or the DeepSeek console aggregate. |
| Filtered weighted ratio | Σ Cache Read / Σ Prompt across currently retained, visible calls that reported Cache Read. | The provider console's potentially different time window and call population. |
| Uncached input | The adapter's normalized uncached input-token bucket. | Response length or the number of newly added or changed tokens. |
| Input-tree colors | Comparison with the preceding in-process call from the same Session and purpose. | Proof that the provider used a region as a cache key or returned those exact tokens from cache. |
| Token reconciliation | Arithmetic explaining how adjacent reported token buckets changed. | A provider cache key, token offsets, or the cause of a cache decision. |
| Call TTFT | Time from CacheScope beginning stream iteration to the first non-empty token. | Isolated provider Prefill time; queueing and network time are included. |
Output tokens enter neither cache ratio. The input hierarchy represents the DSH logical model input captured before provider-specific serialization, so it can differ from the exact wire payload.
The Schema default applies when the plugin is mounted directly. The published installable bundle overrides only captureInput to full; the profile's own patch remains authoritative.
| Key | Schema default | Installed bundle | Effect |
|---|---|---|---|
captureInput | metadata | full | Retain fingerprints and metrics only, or bounded complete logical inputs. |
maxAttempts | 500 | 500 | Maximum attempts retained in process memory. Older attempts are evicted. |
rawRetentionAttempts | 12 | 12 | Maximum recent attempts that may retain complete inputs. |
maxRawInputBytes | 2000000 | 2000000 | Maximum UTF-8 JSON bytes retained for one complete input. |
refreshMs | 1500 | 1500 | Dashboard polling interval in milliseconds. |
logAttempts | true | true | Print one metadata-only summary after each attempt. |
includeAuxiliary | true | true | Include compaction, title generation, and direct calls. |
dashboard | true | true | Register the dashboard when the WebServer is bound to loopback. |
pricing | unset | unset | Optional currency and per-million-token rates for local cost estimates. |
Supply all four rates from your current provider price sheet; CacheScope does not ship or update a pricing table.
- id: cachescope
name: '@kober-basket/dsh-cachescope'
config:
pricing:
currency: CNY
uncachedInputPerMillion: 0 # replace with your current rate
cacheReadPerMillion: 0 # replace with your current rate
cacheWritePerMillion: 0 # replace with your current rate
outputPerMillion: 0 # replace with your current rate
Replace every zero before relying on cost estimates. CacheScope uses normalized usage fields and the values you supply; the example contains no current or recommended provider rates.
captureInput: metadata to disable prompt-text retention.Cache-Control: no-store and held in the open page's JavaScript memory while displayed.logAttempts emits metadata-only summaries. Whether those lines persist depends on the host's logging configuration.127.0.0.1. Requests must come from loopback, use the expected 127.0.0.1:<port> Host, and pass Origin and Sec-Fetch-Site checks when those headers are present.Treat captureInput: full as local access to complete model inputs.
dsh plugin --profile web remove @kober-basket/dsh-cachescope
Restart DSH after changing the profile.
npm install
npm run typecheck
npm test
npm run build
npm pack --dry-run
MIT