前言¶
在 DeepSeek Harness（DSH）Web 端做长会话或反复命中上下文缓存时，底部 composer 统计行会显示「缓存命中」百分比。内置格式化器在整数读数会失真时会自动加宽小数位，但日常多数场景下仍可能以整数或较少小数位呈现，例如 11% 或 99%，难以在同一会话里观察命中率的小幅变化。
下面介绍社区插件 dsh-cache-hit-precision（维护者 vrvtvy，分类：客户端）：在不新增可见 UI、不改布局的前提下，把统计行与「Token 用量」弹窗中的缓存命中率原位精化到三位小数，并与 DSH 使用同一计费分母与舍入规则，只在精度上与内置显示不同。
这是什么¶
dsh-cache-hit-precision 是一个面向 DSH Web 的客户端插件。它注册 composer dock 里一个不可见的 slot，读取与内置统计 pill 相同的 tokenUsage 投影，仅改写「缓存命中」这一个读数；轮次、步数、速度、总量以及弹窗中的未缓存输入、缓存读取、缓存写入、输出等桶位均保持原样。
插件不请求网络、不上传数据；卸载后不留下样式或 DOM 残留。包版本 0.2.4，以 MIT 许可证发布，延续自 dsh-cache-precision 并适配 DSH 0.2。
核心功能¶
原位三位小数¶
底部状态行与「Token 用量」弹窗中的「缓存命中」会由例如 缓存命中 98% 变为 缓存命中 98.460% 这类三位小数读数，界面其余部分与内置渲染一致。
与内置口径一致¶
分母为三个互不重叠的输入侧计费桶之和：
uncachedInputTokens + cacheReadTokens + cacheWriteTokens
与 DSH 完全一致；百分比采用精确整数运算的半进位，避免浮点误差。下表为 README 中的对比示例（内置显示 vs 本插件显示）：
| 缓存读取 / 计费输入 | 内置显示 | 本插件显示 |
|---|---|---|
| 123 / 1123 | 11% |
10.953% |
| 9995 / 10000 | 99.95% |
99.950% |
| 999999 / 1000000 | 99.9999% |
99.9999% |
| 9995 / 9995 | 100% |
100.000% |
即时精化与锚点¶
精化在 mutation observer 的微任务中完成，尽量在 React 提交之后、浏览器绘制之前更新读数，避免低精度首帧被看到。插件锚定统计行中缓存命中所在的 pill（DSH 0.2.0 之前为 data-composer-stats，0.2.1 起为 usage 对应的 data-composer-stat），以及会话用量弹窗列表的 data-session-stats-usage 与内置中英文案。
有意不改每轮用量面板（data-turn-usage-details）：该处命中率是会话内单轮口径，与 pill 的会话级读数不同，改写会造成误读。
安装与启用¶
插件已发布到 npm。DSH 桌面端可在「设置 → 插件 → 添加插件」中填写包名 dsh-cache-hit-precision 并安装。命令行等价于：
dsh plugin --profile web add dsh-cache-hit-precision
刚发布的版本在 npmmirror 上可能有短暂延迟；安装流程会在官方源与镜像间自动回退，CLI 也可用 --registry 指定源。安装完成后需重启 DSH。
说明：桌面端插件由桌面 profile 单独管理，CLI 会拒绝 --profile desktop；若只在桌面端使用，请走「设置 → 插件」界面。插件以当前 DSH 进程权限在客户端运行，安装前可在 GitHub 仓库 查看源码与 MIT 许可证。
典型用法¶
本插件无独立配置项：安装并重启后，在 Web composer 底部统计行或打开「Token 用量」弹窗即可看到三位小数的缓存命中率。开发者在仓库内可运行：
npm test
用于执行 node --test 下的单元测试。
适用场景与注意¶
适合谁：需要在 DSH Web 端日常观察上下文缓存命中率细微变化、且希望与官方 Token 弹窗读数一致的用户或智能体开发者。
兼容性（据 README 与 package.json 的 dsh.engines）：面向 DSH 0.2.0-rc.* 与 0.2.1-rc.*（分别在 0.2.0-rc.2 与 0.2.1-rc.2 上验证），引擎要求 >=0.2.0-rc.1 <0.3.0-0。DSH 0.1.x 统计行实现不同，当前版本不支持。若上游调整 StatsPills 结构或文案，插件可能需要跟进更新。
生态说明：DSH 采用「一切皆插件」的扩展方式；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-cache-hit-precision 解决的是 Web 端缓存命中率读数精度问题：三位小数、原位替换、与会话级 Token 统计同口径，且不扩大插件攻击面（无网络、无额外可见 slot）。需要安装步骤与原理细节时可查阅 GitHub：vrvtvy/dsh-cache-hit-precision，或在 SkillHub 目录页 检索同插件条目。
