dsh-gauge

中文 | English

为 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 估算。语言与货币实时跟随，无需重启。

截图

安装

# 方式一（推荐）：直接使用 Release 附件（npm 包 tarball，含编译产物）
dsh plugin --profile web add file:dsh-gauge-0.1.0.tgz

# 重启
dsh web

输入框下方应出现精确统计行，会话页头出现 ⓘ 用量入口。

npm 发布后（推荐方式）：dsh plugin --profile web add dsh-gauge——dsh plugin 会 pnpm add 并自动把声明了 dsh.bundle 的包加进 dsh.profile.bundles。

本地开发/调试：用源码安装替代第②步——pnpm add file:C:/Object/dsh-plugin/dsh-gauge（源码改动后 npm run build 即生效，适合改 src/config.ts 的价格/高峰窗口）。

开箱即用 & 配置卡片

装完重启后开箱即用，无需任何配置：

• 输入框下方两行统计：精确缓存命中率（99.8% 就是 99.8%）、分桶明细、输出、预估费用、高峰/闲时徽标；