缓存监控 / Cache Monitor

English · MIT License

DSH / DeepSeekRuntime 插件，在左侧栏固定显示当前对话的缓存命中率与请求次数，并提供逐次模型请求的 Token 明细。

功能

• 与「用量/余额」相同的位置与交互：固定在侧边栏底部，点击打开详情。
• 只统计当前主窗口对话，不混入其他会话。
• 汇总缓存读取、缓存写入、未命中输入、输出及推理 Token。
• 展开详情后，按请求显示轮次、步骤、命中率和完整 Token 明细。
• 每 8 秒自动刷新，也可手动刷新。
• 点击外部、按 Esc 或点击关闭按钮收起详情。
• 窄侧栏自动切换为纯图标。
• 中英文界面。

插件展示的是模型请求实际返回的 usage 数据。命中率取决于 Provider、模型及其提示词缓存机制，不代表计费折扣。

安装

从 GitHub 安装

在 DSH 的「插件 → 添加插件 → 安装第三方插件」中输入：

https://github.com/Vhow123/dsh-cache-monitor

也可使用 CLI：

dsh plugin --profile desktop add https://github.com/Vhow123/dsh-cache-monitor

安装完成后按提示重启 DSH。

本地开发

dsh plugin --profile desktop add /absolute/path/to/dsh-cache-monitor

包通过本地链接安装时，修改 Host 或 Client 代码后重启 DSH，确保加载最新模块。

使用

1. 打开需要查看的对话。
2. 在左侧栏底部点击「缓存监控」。
3. 查看当前对话的汇总；点击对话名称展开逐请求明细。

每个对话保留最近 500 条请求明细，请求总数与 Token 汇总包含全部历史。

统计口径

命中率 = cacheReadTokens / (cacheReadTokens + uncachedInputTokens)

分母不含输出 Token。uncachedInputTokens 直接读取 Provider 的 usage.inputTokens，cacheReadTokens、cacheWriteTokens 和 reasoningTokens 缺失时按 0 处理。

同一轮次/步骤的流式更新会替换上一条统计，不会重复累计；重试开始时清除该步骤的上一条统计。

实现

• index.js：Host 会话投影 cacheMonitor，从持久会话日志重建统计。
• client.js：React 侧边栏入口与详情弹层，注册到 sidebar.footer.action。
• cordis.patch.yml：插件组合补丁。
• locale/zh.json、locale/en.json：插件管理器元数据。
• icon.svg：插件图标。

仅读取当前 DSH 实例的会话 Token 用量，不发送网络请求，不保存会话正文。

验证环境

DSH 0.2.1-rc.2，已验证侧边栏入口、当前对话统计、逐请求明细、Esc 关闭及窄侧栏模式。

许可证

MIT