dshbase

插件目录 / UI & Skins / dsh-precise-cache

dsh-precise-cache

已验证 · 实测可装 Townrain

✓ 持续维护

查看 GitHub ↗ ← 返回插件目录

2Stars
0Forks
0未关闭 issue
JavaScript语言
2026-08-14最近推送
跨平台平台

功能简介

聊天统计旁的五位缓存命中率读数(dsh-plugin)。

✅
我们的评价
可用 — 实测通过,早期项目

聊天统计旁的五位缓存命中率读数(dsh-plugin)。 实测能干净安装、正常启动。早期项目,但功能可用。

「已验证」表示我们的自动化 CI 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计,也不代表对第三方代码的背书。

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。

安装

🧩 让 Agent 自动装(推荐)

装一次目录插件,之后本站所有插件都能让 DeepSeek Harness 自动找、自动装:

dsh plugin add dshbase-catalog

然后对 agent 说「帮我装 dsh-precise-cache」,它会在目录里找到并自动安装。文档:dshbase-catalog · 已验证场景包。

该插件是 GitHub 源码(未发 npm)——直接从仓库装:

Web profile:

dsh plugin --profile web add github:Townrain/dsh-precise-cache

Headless(CLI)profile:

dsh plugin --profile headless add github:Townrain/dsh-precise-cache

实测报告

验证通过:从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行(dsh 0.1.0-rc.6)。

使用场景

改变 dsh 的外观或交互方式——一套主题、皮肤或新面板,重塑工作区。

适合谁

在 web UI 里一待几小时、想让它按自己的习惯好看又好用的人。

二次开发建议

皮肤、面板和主题 token 是扩展点——写新皮肤、加面板,或与上游配色同步 token。

安全:尚未扫描——我们的每日静态扫描将很快覆盖它。

分享徽章

UI & Skins 里更多

浏览全部 7797 个插件 →