dsh-balance-meter：DeepSeek Harness 的账户余额与会话成本显示插件

dsh-balance-meter 是 DeepSeek Harness（DSH）的账户余额与会话成本显示插件（DSH plugin），专为 DSH Web GUI 设计。它解决的是用户在 Web 界面中无法直观看到 DeepSeek 账户余额和当前会话预估花费的问题，核心能力包括实时查询官方余额接口、按 token 用量与官方定价估算会话成本、自动识别每个会话实际使用的模型（flash 或 pro）以精确计价，并每 6 小时自动拉取官方定价页，确保 2026-08-17 峰谷定价上线后无需更新插件即可适配。该插件由 Ghost011118 维护，采用 BSD-3-Clause 许可证，最近更新于 2026-08-14。

dsh-balance-meter 这个 DSH plugin 支持哪些核心特性？

插件在 composer dock 中显示一个包含账户总余额和当前会话预估成本的 chip，例如 Balance CNY 4.16 · This session CNY 2.57。点击 chip 可展开查看按币种的余额明细（赠送 + 充值）以及按桶的成本明细（输入 / 缓存读取 / 输出）。若显示错误，点击可强制立即刷新。插件默认零配置，自动使用 DEEPSEEK_API_KEY 和官方定价页，并支持通过组合配置覆盖 model（auto/flash/pro）、pricingRefreshHours（默认 6 小时）、apiKeyEnv、baseUrl、refreshIntervalSeconds（默认 30 秒）等选项。

dsh-balance-meter 怎么安装？

安装需要 DeepSeek Harness 0.1.0-rc.6 或更高版本（web profile），并通过 DSH 凭据机制存储 DeepSeek API key（DEEPSEEK_API_KEY，Web Models 页面会写入）。推荐使用以下命令从 git URL 安装：

dsh plugin --profile web add github:ghost011118/dsh-balance-meter

安装后重启 dsh web 并刷新页面，余额 chip 即出现在 composer dock 中。

dsh-balance-meter 如何估算会话成本？

插件读取 DSH 的持久化 tokenUsage 投影（与内置统计行相同的记账数据），将四个桶（未缓存输入、缓存读取、缓存写入、输出）按官方定价页解析出的价格转换为金额。缓存写入 token 不单独计费，默认按 0 处理。在 auto 模式下，插件通过每个会话请求头中记录的 provider/model 识别实际使用的模型（deepseek-v4-flash → flash，deepseek-v4-pro → pro），从而按真实模型计价，而非固定默认值。若请求头缺失或模型 ID 无法识别，则回退到 flash。显式设置 model: flash 或 model: pro 可强制使用该预设。在 2026-08-17 峰谷定价上线前，当前单一价格保持权威；上线后，将根据北京当前小时自动应用峰谷时段（09:00-12:00 / 14:00-18:00）。若无法获取定价页，则使用内置预设（flash: 0.02 / 1 / 2 CNY 每 1M）。组合配置中的显式 cost.* 覆盖优先级最高。

dsh-balance-meter 兼容哪些 DeepSeek Harness 版本和平台？

插件要求 DeepSeek Harness 0.1.0-rc.6 或更新版本，并针对 web profile 设计。它依赖多个官方 DSH 客户端包（如 @deepseek-ai/dsh-client-connection、@deepseek-ai/dsh-token-meter 等），确保与 DSH 生态无缝集成。插件本身是 JavaScript 编写，通过 git URL 安装，无需 npm 账户。

查看更多 DSH 插件，访问 dsh-plugin.org