前言¶

DeepSeek Harness（DSH）把会话、工具和界面都做成插件。网页界面开着长时间跑 Agent 时，内置统计行能告诉你本场用了多少 token，但账户还剩多少钱、这一场大概花了多少，往往要另开控制台或自己拿单价去乘。

这个问题在 2026 年 8 月 17 日更具体。DeepSeek 官方从北京时间当天 0 时起对 API 实行峰谷定价：高峰为北京时间 09:00–12:00 和 14:00–18:00，其余为空闲时段。Flash 和 Pro 单价不同，缓存命中、未命中和输出也不一样。同一段对话，换模型或跨过高峰，花费差一截是正常的。

dsh-balance-meter 把官方余额接口和官方价格页接到 DSH 网页的输入框下方：一条 chip 同时给出账户总余额和当前会话估算花费。本文按社区目录详情页、仓库 README / README.zh.md、package.json 和源码交叉核对后整理。社区插件目录是独立站点，与 DeepSeek / 幻方没有官方从属关系；DSH 本身的定位仍是官方仓库写的那句：一切皆插件。

这是什么¶

dsh-balance-meter 是一款面向 DSH 网页界面 的会话与消息插件，由 Ghost011118 维护，许可证 BSD-3-Clause，当前仓库版本为 0.1.0。目录分类是「会话与消息」。GitHub 仓库 Ghost011118/dsh-balance-meter 在核实当日显示 16 星；社区目录页当时标注 13 星，以仓库页面为准。

它解决的是网页会话里「钱花到哪了」看不见的问题：

• 账户总余额：查询 DeepSeek 官方 Get User Balance 接口
• 本场估算花费：用 DSH 持久化的 tokenUsage 乘以官方单价
• 按会话实际模型计价，而不是写死 Flash

package.json 里 dsh.client.platform 为 web，peer 依赖对齐 DeepSeek Harness 0.1.0-rc.6。它不是 CLI 账单工具，也不会替你改模型或限流；只在网页输入框下方给出读数。

核心功能¶

输入框下方的余额 chip¶

安装并重启网页后，chip 出现在输入框下方、与内置会话统计行同一排。仓库给出的示例如下：

余额 CNY 4.16 · 本场 CNY 2.57

点击 chip 会展开两组明细：

• 余额：按币种拆开，赠送额度与充值额度分开显示
• 花费：按分桶拆开，输入、缓存读、输出分别计价

chip 报错时再点一次，会立即强制刷新。仓库说明：错误视图不会当成新鲜缓存复用，后续轮询会重新查询；网络或 Key 恢复后，chip 会自己回到实时总额。

按会话真实模型计价¶

默认 model: auto。每个会话的请求头会记下最近一次请求的 provider/model，插件把 id 映射到单价表：

• deepseek-v4-flash → flash
• deepseek-v4-pro → pro

因此一场用 Pro 的会话按 Pro 计价，不会被写死成 Flash。尚无请求头、或模型 id 无法识别时，auto 回退到 flash。需要锁定估算口径时，可把 model 设成 flash 或 pro，此时忽略自动识别。

花费 JSON 会带上 pricingKey 和 model，chip 能标出这一场按哪个模型算的。

从官方价格页取单价，并识别峰谷¶

插件默认每 6 小时抓取一次官方价格页：

https://api-docs.deepseek.com/zh-cn/quick_start/pricing/

抓到之后，按当前北京时间套高峰或空闲单价。高峰时段与官方公告一致：09:00–12:00、14:00–18:00。价格变动不必发新版插件。

价格页抓取失败时，回退到仓库写明的内置预设（flash：缓存命中 0.02 / 未命中输入 1 / 输出 2 元，每百万 tokens）。这组数字是抓取失败时的兜底，不是 8 月 17 日峰谷价生效后的官方价。组合配置里显式的 cost.* 覆盖优先于任何预设。

花费怎么算¶

记账口径与内置统计行相同：读取 DSH 持久化的 tokenUsage 投影，把四个分桶换成金额：

1. 未命中输入
2. 缓存读
3. 缓存写
4. 输出

DeepSeek 不对缓存写单独计费，插件默认按 0。余额侧走官方接口；花费侧是本地估算，用来看本场量级，不是账单对账。

宿主侧还会挂上 /api/balance JSON 接口，浏览器侧负责把读数画到页面上。cordis.patch.yml 用一条 id: balance 的插件行同时挂上这两半。

安装与启用¶

环境要求以仓库 README 为准：

• DeepSeek Harness 0.1.0-rc.6 或更新（web profile）
• 已通过 DSH 凭据通道写入 DeepSeek API Key（DEEPSEEK_API_KEY，在网页 Models 页面填写即可）

社区目录页给出的安装命令如下，在 DSH 终端执行：

dsh plugin add github:Ghost011118/dsh-balance-meter

该插件只作用于网页界面。维护者 README 写的是带 web profile 的写法，效果更明确：

dsh plugin --profile web add https://github.com/Ghost011118/dsh-balance-meter

需要可复现安装时，按目录页说明把 commit 哈希钉死。核实当日 master 最新提交为 db97c0ea49767d7e73166d8d57a13e54970533e4（2026-08-14），示例：

dsh plugin add github:Ghost011118/dsh-balance-meter#db97c0ea49767d7e73166d8d57a13e54970533e4

也可以从本地检出安装：

git clone https://github.com/Ghost011118/dsh-balance-meter.git
dsh plugin --profile web add link:$(pwd)/dsh-balance-meter

装完后重启 dsh web，再刷新浏览器。余额 chip 应出现在输入框下方。

插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前请检查源代码仓库和许可证。

典型用法¶

1. 零配置先看读数¶

默认使用 DEEPSEEK_API_KEY 和官方价格页，不必先写配置。网页 Models 页面写入 Key 后：

1. 按上一节安装插件
2. 重启 dsh web 并刷新页面
3. 开一场会话，chip 应显示「余额」和「本场」
4. 点击 chip，核对赠送 / 充值，以及输入、缓存读、输出的分桶花费

README 里的 余额 CNY 4.16 · 本场 CNY 2.57 只是界面示例，不是你的账户数据。

2. 可选组合配置¶

需要改模型预设、刷新间隔或走兼容网关时，在组合配置里插入插件行。仓库给出的示例如下：

- insert:
    - id: balance
      name: 'dsh-balance-meter'
      config:
        model: auto         # 'auto'（默认）| 'flash' | 'pro'
        pricingRefreshHours: 6

仓库列出的配置项：

多数情况保持 model: auto 即可。只想用 Flash 口径估所有会话时，再改成 flash。

3. Key 读不到时怎么查¶

README 把报错 no API key for provider route \deepseek-official`写进了疑难排查。插件和 LLM 路由走同一套凭据通道，默认文件是~/.dsh/.credentials.yaml`（即网页 Models 页面写入的那份）。

按仓库说明，可以按下面顺序核对：

1. 确认文件里有 DEEPSEEK_API_KEY: sk-...（引用指向非空字符串）。DSH 运行中直接改文件即可，provider 会热重载。
2. 凭据通道已挂载时，只从该文件读 Key；此时仅 export DEEPSEEK_API_KEY 不会被采用。导出只在未挂载通道时作为本插件的兜底。
3. 建议用单一受守护实例跑 dsh web（例如 dsh-autostart），避免多个 npx dsh web 抢同一端口、读到不同凭据快照。chip 恢复到实时总额，说明 Key 已经解析成功。

适用场景与注意事项¶

适合这些情况：

• 主要在 DSH 网页界面跑会话，想同时看到剩余额度和本场花费
• 同一环境会切 Flash / Pro，希望花费跟着实际模型走
• 峰谷定价生效后，需要按北京时间高峰 / 空闲来估本场成本
• 走兼容网关时，可以用 baseUrl 指向自己的入口

使用前注意下面几条，均来自目录页或仓库，不是额外发挥：

1. 只覆盖网页界面。 package.json 声明 platform: web。纯终端、桌面壳或其他 profile 不会出现这条 chip。
2. 本场数字是估算。 口径对齐内置 tokenUsage 和官方价格页，用于看量级；对账仍以 DeepSeek 官方账单为准。价格页失败时会落到内置 flash 预设，数字可能偏旧。
3. Key 必须进凭据通道。 网页 Models 页写入的 DEEPSEEK_API_KEY 才是余额查询和模型路由共用的那份。
4. 插件以当前 dsh 进程权限运行。 安装可能执行代码。先看 GitHub 源码和 BSD-3-Clause 许可证；生产环境建议固定 commit。
5. 社区目录不是官方应用商店。 条目来自 DeepSeek Harness 插件库，与 DeepSeek / 幻方无官方从属关系。DSH 官方仓库仍是 deepseek-ai/deepseek-harness。

小结¶

dsh-balance-meter 在 DSH 网页输入框下方补了一条余额与本场花费 chip：余额走官方接口，花费用同一套 token 记账乘以官方单价，并能按会话真实模型以及 8 月 17 日起的峰谷时段切换。对经常在网页里跑 Agent、又需要盯着额度的人，它把「还剩多少、这一场大概多少」放到了统计行旁边。

目录页与仓库：

• 社区目录：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-balance-meter/
• GitHub：https://github.com/Ghost011118/dsh-balance-meter
• DSH 官方仓库：https://github.com/deepseek-ai/deepseek-harness
• 官方价格页：https://api-docs.deepseek.com/zh-cn/quick_start/pricing/