前言¶
在 DeepSeek Harness（DSH）里长时间跑对话和子代理时，账户里还剩多少钱、今天大概烧了多少 token，往往要切到别处查。官方账户页能看到余额，但和「当前这一天的会话用量、按对话拆分的估算花费、以及现在是不是高峰计费时段」并不在同一块 UI 里。社区插件 @b9p79rgh6f-sudo/dsh-balance-widget（GitHub：b9p79rgh6f-sudo/dsh-balance-widget）把这几项收进侧边栏底部一行常驻挂件，点开面板再看明细。下面介绍它做什么、数据从哪来，以及如何安装。
这是什么¶
维护者 b9p79rgh6f-sudo 在插件市场分类为客户端。插件在 DSH Web 侧边栏底部挂一行小部件：DeepSeek 账户余额、今日 token 用量与估算花费；展开后可看今日各对话花费、累计 token 与请求数，以及当前处于高峰还是空闲计费窗口。许可证为 MIT（见 GitHub README）；当前 package 版本为 0.3.2。
核心功能¶
侧边栏底部一行¶
- 左侧显示余额，后跟今日花费估算。
- 右侧小标签写「空闲半价」或「高峰全价」；圆点在空闲时段为绿色，高峰时段为黄色。
点开后的面板¶
- 余额卡与今日花费进度条（相对最近 7 天日均）。
- 今日累计 token、请求数。
- 每个对话的花费列表；子代理费用归并到发起它的对话。
- 下一次计费时段切换的时间。
数据从哪来¶
余额：通过 DSH 官方账户服务 deepseekAccount 读取充值余额与赠送余额，不经过第三方。
今日用量：宿主侧扫描各会话日志里带 usage 的 assistant/message 事件，按事件时间归到北京时间的自然日，结果缓存在：
~/.dsh/storages/balance-widget-cache.json
花费：按 DeepSeek 官方价目从 token 折算，仅为估算，不是账单。价目取自官方文档，README 记载抓取日期为 2026-11-03；官方调价后需在插件 index.js 中更新 PRICES 常量。
计费时段：北京时间周一至周五 9:00–12:00 与 14:00–18:00 为高峰（全价），其余时段半价。README 说明：法定节假日仍按工作日规则处理，因此估算可能偏高。
安装与启用¶
可从 SkillHub 插件目录页 安装，或在终端执行（将 <profile> 换成你的 DSH profile）：
dsh plugin --profile <profile> add @b9p79rgh6f-sudo/dsh-balance-widget
也可以直接从 GitHub 安装：
dsh plugin --profile <profile> add github:b9p79rgh6f-sudo/dsh-balance-widget
装完后刷新页面；若宿主页有改动，按 README 建议重启 DSH。
依赖：
- DSH Web 0.2.x 及以上（使用
sidebar.footer.action与shell.overlay槽位，以及deepseekAccount服务）。 - Node >= 20（见 package.json
engines）。 - 读用量需要会话日志与官方账户服务可用；登录状态下才能显示余额。
典型用法¶
安装并登录 DSH 后，无需额外配置项即可在侧边栏底部看到余额与今日花费一行。需要核对某对话或子代理贡献时，点击挂件打开面板，查看「每个对话的花费」与 token、请求数汇总。
维护者在仓库 tools/ 下提供了开发自查脚本（README 说明依赖本机会话日志，换机不一定能直接跑）：
test-client-render.mjs：用假的 React 桩渲染界面，无需启动 DSH。verify-usage.py：读本机会话日志重算用量与花费，用于和面板数字对账。
适用场景与注意¶
适合：长期在 DSH Web 里开发智能体、频繁开多对话或子代理，希望在同一界面快速感知余额、当日用量和高峰/空闲时段的用户。
注意：
- 插件以当前 DSH 进程权限运行；安装前建议浏览 GitHub 源码 与 MIT 许可证，确认符合你的安全策略。
- 花费数字是依据插件内价目表的估算，不能替代官方账单；调价后需自行更新
PRICES。 - SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
dsh-balance-widget 把余额、今日用量估算、按对话拆分和计费时段提示固定在侧边栏底部，减少在 DSH 与账户页之间来回切换。目录页：https://www.skillhub.cn/plugins/b9p79rgh6f-sudo/dsh-balance-widget；源码与 README：https://github.com/b9p79rgh6f-sudo/dsh-balance-widget。
