本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-balance-meter

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-balance-meter

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 余额来源明确区分：官方 API、中转兼容端点或本地手工记账余额
• 当前会话估算花费（token 用量 × 官方单价）
• 按模型计价：从每个会话的请求头读取实际使用的模型（flash / pro），让花费跟随你真正用的模型，而非固定默认
• 每 6 小时自动抓取官方价格页，价格变动与 2026-08-17 峰谷定价上线后均无需更新插件
• 峰谷时段（北京时间 09:00-12:00 / 14:00-18:00）自动按高峰/空闲计价（峰谷定价生效后）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后在哪里看到余额 chip？

重启 dsh web 并刷新页面后，输入框下方的状态条会出现一个 "余额 CNY x.xx · 本场 CNY y.yy" 的小按钮，点击展开可看按币种/分桶的明细。

显示 "no API key for provider route deepseek-official" 怎么办？

宿主从 DSH 凭据存储 (~/.dsh/.credentials.yaml) 读取 DEEPSEEK_API_KEY；在 Web 的 Models 页面写入即可，DSH 运行中可直接编辑，plugin 与 LLM 路由走同一套凭据通道，会热重载。

余额卡在 "不可用" 多久能恢复？

错误视图不会被当作新鲜缓存复用——每次轮询都会重新查询 provider，因此只要底层条件恢复（余额可达、网络恢复、Key 已写入），chip 会自动恢复，无需手动点击。

我用的是中转 API，怎么显示余额？

把 source 设为 proxy，把 API Key 保留在 DSH 主机侧（只作为 Bearer 凭据发往中转），如果中转返回 DeepSeek 格式的 balance_infos 直接可用，否则用 proxyBalancePath 配置数字余额的点路径。

manual 模式的数据存在哪里？

隐藏在 DSH settings 命名空间 balance.manualLedger 下，不另建明文文件，也不会随普通余额响应发给浏览器；账本保存基线、剩余余额、本地累计扣费以及每个会话的 token 检查点。

重启 DSH 会重复扣费吗？

不会。manual 模式只扣除上次成功持久化检查点之后的正向 token 增量，因此轮询和重启都不会重复扣除同一份累计会话消耗。

缓存写入（cache write）token 会扣费吗？

不会。DeepSeek 不对缓存写入单独计费，默认按 0 元/百万 tokens 计算。

2026-08-17 的峰谷定价会自动生效吗？

会。插件每 6 小时抓取官方价格页，解析峰/闲两套单价，2026-08-17 之后按当前北京时间（09:00-12:00、14:00-18:00 高峰，其余闲时）自动切换。

— 源: plugin_wiki.faq_json

兼容性

• DSH: ^0.1.0-rc.6
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则