@fenzhenhua123/dsh-balance-meter：DeepSeek Harness 余额与费用统计

在 DeepSeek Harness 的开发调试中，API 账户余额与单次会话的费用消耗是高频关注点。缺乏直观的统计会导致超支风险或对计费细节不清晰。下面介绍 @fenzhenhua123/dsh-balance-meter 插件，它能在会话页面底部统计条中直接展示余额与本次费用。

插件定位¶

这是一个 DeepSeek Harness 插件，由 FenZhenHua 维护。它通过在会话统计条追加胶囊组件，解决了 DSH 原生界面缺乏 API 余额实时监控和精细化费用统计的问题。

核心功能¶

1. 余额与本次费用胶囊：在「会话统计」条目旁追加显示。
2. API 余额显示：展示 DeepSeek 开放平台充值余额（含赠金），左键单击可查看明细。
3. 本次使用金额：按官方计费方式逐请求精确累计。
4. 本次 Tokens 统计：显示输入未缓存 / 缓存读 / 缓存写 / 输出 四桶数据，左键单击可见。
5. 精细化计费：
   • 分模型：支持 deepseek-v4-pro / deepseek-flash。
   • 分缓存：输入缓存命中 / 缓存未命中+写入 / 输出 三档计费。
   • 分时段：按北京时间峰谷计费，高峰时段价格 = 空闲 × 2。
6. 价格自动刷新：Host 侧每 6 小时抓取官方价格页并解析最新单价。

安装与启用¶

1. 执行安装命令：

   dsh plugin add @fenzhenhua123/dsh-balance-meter

2. 进入「插件」页，找到「余额与本次费用」卡片，点击开关即可启用/禁用（即时生效，浏览器端可能需刷新一次）。

典型用法¶

若官方价格抓取失败或需调整兜底价格，可编辑 lib/index.js 顶部的 EMBEDDED_PRICING 配置项。配置单位为人民币/百万 tokens（空闲时段），高峰时段会自动乘以 2。

适用场景与注意¶

• 适用场景：需要精确控制 API 预算、监控不同模型（Pro/Flash）及缓存命中率的开发者。
• 注意：
  1. 费用为基于官方计费规则的估算值，实际扣费以平台为准。
  2. 计算在 Host 侧逐请求重放会话日志进行。
  3. 插件以 Host 进程权限运行，安装前建议查看源码与许可证（MIT）。
  4. 跨年后需在 lib/index.js 的 CN_WEEKDAY_HOLIDAYS_2026 中更新下一年度日期。

总结¶

该插件通过可视化的胶囊形式，将余额与计费信息聚合在会话统计条中，便于进行成本控制。更多细节请参考 GitHub 仓库 或 社区目录。