Townrain/dsh-precise-cache ↗★ 2

dsh-precise-cache

Five-decimal cache-hit readout beside the chat stats line for the DeepSeek Harness Web GUI 核心用于精确监控 DeepSeek 缓存命中情况。适合需要了解真实缓存命中率(避免官方四舍五入至100%的误差)的开发者。

Package
dsh-precise-cache
Compatibility
Unverified
Version
0.1.0
License
MIT
Last updated
Aug 14, 2026

Install

This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗

dsh-precise-cache

简体中文 | English

给 DeepSeek Harness 加一个小功能:在聊天输入框下方的统计栏旁边,多显示一行精确到小数点后五位的缓存命中率,长这样:

精确命中 99.87654%

效果图

有什么用?

Harness 自带的统计栏里,缓存命中率是四舍五入到整数的:真实命中率只要达到 99.5%,它就会显示成 100%。

这个插件用的是和官方一模一样的数据,只是不做四舍五入,把真实的数字直接显示出来。

安装(三步)

Windows:PowerShell 一行命令(不需要 npx,不需要装任何东西)

打开 PowerShell,粘贴运行:

irm https://raw.githubusercontent.com/Townrain/dsh-precise-cache/main/scripts/install.ps1 | iex

脚本会自动下载插件、放进 dsh 的插件目录、登记到你的配置里(重复运行不会重复登记)。然后:

  1. 重启 dsh
  2. 刷新浏览器页面

完成,统计栏旁边就会出现 精确命中 …%。

想装到别的 profile 或强制覆盖,先下载脚本再带参数运行: pwsh -File scripts/install.ps1 -Profile headless / -Force

其他方式

  • 装了 npm:npx dsh-precise-cache install
  • 下载本仓库后用 Node:node scripts/install.js install --from . --force

卸载

irm https://raw.githubusercontent.com/Townrain/dsh-precise-cache/main/scripts/install.ps1 -OutFile "$env:TEMP\dsh-precise-cache-install.ps1"
& "$env:TEMP\dsh-precise-cache-install.ps1" -Uninstall

然后重启 dsh。装了 npm 也可以直接 npx dsh-precise-cache uninstall。

常见问题

装好了但看不到那一行? 这一行只有在「产生过输入计费」之后才会显示,没有数据时它会自动隐藏。随便发一条消息再回来看就有了。

会拖慢 dsh 或影响计费吗? 都不会。它只读取 dsh 本来就在计算的统计数据,不发起任何请求、不改任何数字。

为什么是五位小数? 这是本插件最初的诉求:位数越少越容易重新掉进四舍五入的假象里。

技术细节(开发者)

工作原理

lib/index.js      宿主半:空实现(读数纯属浏览器呈现)
lib/client.js     浏览器半:模块表格式 bundle,无需构建步骤
scripts/install.js  Node 一键安装器
scripts/install.ps1 PowerShell 一键安装器(下载 zip + 写入组合行)
  • 数据来源:Harness 的 tokenUsage 投影(provider 上报值,宿主折叠、全日志累计),通过 dock 槽位的标准 useProjection 座席读取,无任何自建 RPC。分母与内置统计行完全一致:uncachedInputTokens + cacheReadTokens + cacheWriteTokens。
  • 插件装载契约:package.json 声明 dsh.client.platform = "web" 及 inject 依赖,宿主扫描器据此生成 window.__DSH_BOOT__ 图行并挂载 /plugins/dsh-precise-cache/client.js 路由;浏览器半以 window.__ModuleLoader__.load({ id, factory }) 注册交接,id 即包名,工厂返回 { apply, inject }。
  • UI 入口:通过 ctx.slots.inject('conversation.composer.dock', …) 注册为新 id 的列表条目(排在内置 stats 行之后),文案走 locale: 'preciseCache' 座席,样式标签带 data-plugin 归属、卸载时由模块加载器回收。
  • 热更新边界:lib/client.js 内容变化刷新页面即生效;dsh.client 声明变化需要重启 dsh。

开发

npm run check          # node --check 语法校验
npm run install:local  # 本地安装验证

许可

MIT © 2026 Townrain。欢迎按 dsh-plugin 生态习惯提 PR 与 Issue。