跳到正文

noone89A/dsh-gauge

40最近提交 2026年8月15日

dsh-gauge DSH 插件

dsh-gauge 通过可配置小数位的精确命中率替代官方四舍五入的整数，补充分桶 token 明细、会话用量面板，以及自动跟随 DeepSeek 官方调价（含峰谷计价）的实时费用估算。支持中英文双语和货币自适应。

ui-productivitydeveloper-tools

如何安装 dsh-gauge DSH 插件

dsh plugin --profile web add dsh-gauge

复制不会执行命令。安装 dsh-gauge DSH 插件前请核对仓库和版本。

dsh-gauge DSH 插件数据来源

dsh-gauge DSH 插件快照日期：2026年8月16日

discovered

dsh-gauge DSH 插件能做什么

  • 精确缓存命中率，小数位可配置（0–2 位）
  • 分桶明细：命中/未命中输入输出 token，写入桶为 0 时自动隐藏
  • 费用估算：按实际用量 × 模型单价，显示当前费用与新价费用及涨幅对比
  • 按请求时刻峰谷计价：每条 assistant 消息按时间戳套用高峰/闲时费率
  • 高峰时段徽标：统计行尾显示当前时段高峰/闲时状态
  • 用量面板：会话页头 ⓘ 按钮弹出，包含模型、命中率、各桶总数、上下文占用、费用估算
  • 两行统计：官方指标行 + 精确用量行，可配置替换或追加
  • 中英文双语及货币自适应：UI 语言切换时文案和费用货币自动跟随

dsh-gauge DSH 插件适合哪些场景

  • 监控实际 token 消耗和缓存效率，优化 API 使用成本
  • 对比新旧价格下的费用，帮助预算规划
  • 了解高峰时段对计费的影响，调整使用策略
  • 开发调试时查看精确的 token 分布和上下文占用
  • 通过用量面板快速查看逐会话的模型、费用和 token 总数

dsh-gauge DSH 插件适合谁

  • DeepSeek API 用户，希望获得精确的缓存命中率和费用透明度
  • 使用 DSH Web UI 管理会话的开发者
  • 对 token 成本敏感、需要准确费用预估的用户

dsh-gauge DSH 插件的限制

  • 写入桶为 0 时自动隐藏，部分适配器从不报告 cache-write token
  • 费用为估算值，以官方实际账单为准
  • 配置卡片需要将 gauge 加入白名单（当前 DSH 版本限制），不加入不影响核心功能
  • 依赖 DSH 环境和 @deepseek-ai/dsh-token-meter 投影

dsh-gauge DSH 插件的仓库 README 摘录

以下文字摘自 dsh-gauge DSH 插件的上游仓库 noone89A/dsh-gauge 的 README，版权归原作者，仅作引用。

中文 | [English](README.en.md) 为 DeepSeek Harness Web UI 提供精确缓存命中率、token 用量与费用估算。 官方统计行把缓存命中率四舍五入成整数——`Math.round` 会把 99.8% 显示成误导性的 **100%**。 dsh-gauge 用一位小数（可配置）的精确数值顶替它，并补充分桶 token 明细、会话用量面板，以及自动跟随 DeepSeek 官方调价的会话费用估算（使用官方 API）。 ## 功能 - **精确缓存命中率** — `cacheRead / (cacheRead + uncached + cacheWrite)`，小数位可配置（默认 1），99.8% 就是 99.8%。 - **分桶明细** — 命中 / 未命中输入 token 与输出 token。*写入*桶为 0 时自动隐藏（opencode-go/pi-ai 适配器从不报告 cache-write，实际恒为 0）。 - **费用估算 + 调价对比** — 按实际用量 × 模型单价估算（deepseek-v4-flash / deepseek-v4-pro，自动从会话推导）。官方新价生效前显示 **当前费用 + 新价费用 + 预计涨幅**；生效时刻自动切换到新价。 - **按请求时刻的峰谷计价** — 估算**不是**"当前时刻"快照：每条 assistant 消息按自己的时间戳计价，高峰时段消耗的 token 按高峰价、闲时按折扣价，最后求和。 - **高峰时段徽标** — 北京时间 09:00–12:00 / 14:00–18:00 为 DeepSeek 峰谷定价的高峰窗口。统计行尾按当前时段显示**高峰**/**闲时**状态（切换为新价后同样按当前时段显示）。 - **用量面板** — 会话页头 ⓘ 按钮弹出面板：模型、命中率、计费输入、各桶总数（默认完整数字）、上下文占用与费用估算（含调价后对比）。 - **两行统计（官方指标 + 精确用量）** — 第一行保留官方会话指标（轮/步、LLM/工具调用时长、首 token 平均、tok/s），复刻官方样式（行距刻意收紧，两行视为一个整体）；第二行是插件的精确用量（命中率、分桶、输出、费用、高峰/闲时徽标）。`replaceNativeStatsLine: false` 时保留官方原生行（含原生用量段）。 - **双语 & 货币自适应** — UI 为英文时文案切英文、费用按国际价目表以 USD 估算。语言与货币实时跟随，无需重启。 ## 截图 ![统计行](https://raw.githubusercontent.com/noone89A/dsh-gauge/main/docs/images/stats-line.png) ![用量面板](https:/

阅读完整 README仓库许可: MIT

dsh-gauge DSH 插件常见问题

如何安装 dsh-gauge？

推荐使用一键命令：`dsh plugin --profile web add dsh-gauge`，它会自动安装并注册到 DSH 配置中。然后重启 `dsh web` 即可。如果想手动安装，进入 `~/.dsh/profiles/web` 目录，执行 `npm install dsh-gauge`，然后在 `package.json` 的 `dsh.profile.bundles` 中添加 `"dsh-gauge"`。

设置 → 插件里看不到 dsh-gauge 的配置卡片怎么办？

当前 DSH 版本的 Web 设置白名单未包含第三方插件。要显示卡片，需在宿主安装的 `node_modules/@deepseek-ai/dsh-host-apiproxy/lib/index.js` 的 `WEB_SETTINGS_NAMESPACES` 数组中添加 `"gauge"`。不添加白名单不影响核心功能（统计行、用量面板均正常），也可以直接编辑 `cordis.patch.yml` 进行配置。

为什么写入桶一直是 0？

部分适配器（如 opencode-go/pi-ai）从不报告 cache-write token。插件设计为当写入桶为 0 时自动隐藏该桶。如果未来有适配器报告写入 token，桶会自动恢复显示。

费用估算准确吗？能作为账单依据吗？

费用估算基于会话历史中的实际 token 用量乘以内置价目表（CNY 和 USD），但仅为估算值，可能与官方账单存在差异。请以 DeepSeek 官方账单为准。插件会在配置的生效时刻自动切换到新价格，并提供新旧价格对比。

dsh-gauge 和 dsh-usage 有什么区别？

dsh-gauge 侧重精度和效率：提供精确的缓存命中率（可配置小数位）、按消息时间戳的峰谷计价、自动价格切换。dsh-usage 提供每条 assistant 消息的 per-turn 读数和跨会话的用量页面（含热力图和聚合统计）。两者槽位不同，可以共存安装。