前言¶
在 DeepSeek Harness（DSH）Web UI 里，会话统计通常需要看缓存命中率、token 用量和费用。dsh-gauge 是一个面向 DSH Web UI 的插件，用来在这些指标上提供更细的展示和估算。下面介绍它的功能、安装、配置与注意事项。
这是什么¶
dsh-gauge 是 noone89A/dsh-gauge 仓库中的 DSH 插件，许可证为 MIT。它面向 DeepSeek Harness Web UI，提供精确缓存命中率、token 用量分桶、上下文占用、会话费用估算，以及高峰/闲时状态展示。适合需要在会话级别核对用量和费用估算的开发者。
核心功能¶
- 精确缓存命中率：按
cacheRead / (cacheRead + uncached + cacheWrite)计算，小数位可配置。 - 分桶 token 明细：展示命中 / 未命中输入 token 与输出 token；写入桶为 0 时自动隐藏。
- 会话费用估算与调价对比：按实际用量 × 模型单价估算，并自动跟随 DeepSeek 官方调价。
- 按请求时刻峰谷计价：每条 assistant 消息按自身时间戳套用高峰/闲时费率。
- 高峰时段徽标：统计行尾显示高峰/闲时状态。
- 用量面板：显示模型、命中率、计费输入、各桶总数、上下文占用与费用估算。
- 两行统计：第一行保留官方会话指标，第二行显示插件精确用量。
- 双语与货币自适应：UI 为英文时文案切英文、费用按 USD 估算；其余情况按 CNY。
安装与启用¶
推荐用 dsh plugin 命令安装：
dsh plugin --profile web add dsh-gauge
这条命令用于向 Web profile 添加插件。安装后重启 Web UI：
dsh web
经过上面的步骤后，DSH Web UI 中会出现插件提供的统计行和用量面板。
如果选择手动安装，可先做以下两步：
cd ~/.dsh/profiles/web
npm install dsh-gauge
然后把 "dsh-gauge" 加入 profiles/web/package.json 的 dsh.profile.bundles。
本地开发或调试时，也可以用源码方式安装：
pnpm add file:C:/Object/dsh-plugin/dsh-gauge
源码改动后执行：
npm run build
即可生效。
配置¶
如需调整配置，可进入：
设置 → 插件 → 可配置插件
在 dsh-gauge 卡片中调整配置；除 replaceNativeStatsLine 外，保存后立即生效。
也可以直接编辑：
~/.dsh/profiles/web/cordis.patch.yml
例如：
# ~/.dsh/profiles/web/cordis.patch.yml
- id: gauge
config:
showPrice: true
注意补丁条目是扁平 {id, ...} loader 条目；写成 - update: 会被报错拒绝。
如果修改了 replaceNativeStatsLine，或修改了 cordis.patch.yml，需要重启：
dsh web
配置卡片显示需把 gauge 加入 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 白名单；不加入不影响核心功能。
适用场景与注意¶
适合在 DSH Web UI 中查看精确命中率、分桶 token、上下文占用和费用估算的人。
注意：
- 费用为估算值，以官方实际账单为准。
- 插件以当前
dsh进程权限运行；安装前应检查源码与许可证。仓库使用 MIT 许可证，源码可在此查看：
https://github.com/noone89A/dsh-gauge
- DSH 插件生态强调“一切皆插件”；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，
dsh-gauge应作为社区插件处理。
结尾¶
dsh-gauge 把 DSH Web UI 的命中率、token 分桶、上下文占用和费用估算放到会话统计与面板中，便于核对会话用量。GitHub 仓库：
https://github.com/noone89A/dsh-gauge
如需在目录中查找，可搜索插件名 dsh-gauge。
