前言¶
在 DeepSeek Harness（DSH）里跑长对话时，token 在涨、钱包在扣，但界面往往不直接告诉你「这一会话大概花了多少、账户还剩多少」。有人用桌面挂件、多厂商统计或通知提醒，功能多、也更容易打断对话。下面介绍维护者 ashuai 的客户端插件 dsh-status-balance：在 Web UI 输入框下方常驻一行两个数字，点开再看今日账本，刻意不做对话链路上的额外请求。
这是什么¶
dsh-status-balance 是 DeepSeek Harness Web UI 的极简余额挂件。它在输入框下方、上下文指示器之后显示 本会话花费 与 钱包余额；点击后展开今日消耗、余额变化、预计可用天数和当前峰谷时段。插件分类为客户端，零依赖、无构建，不参与对话、不注册工具、不注入 system prompt。
仓库：https://github.com/ashuai/dsh-status-balance
社区目录页：https://www.skillhub.cn/plugins/ashuai/dsh-status-balance
界面上你会看到什么¶
状态栏是一行约 22px 的 pill，无文字标签、无动画、无声音。示意（来自 README）：
[↗ ¥0.0043] · [👛 ¥6,053.41] ← 输入框下、上下文指示器之后
| pill | 含义 |
|---|---|
| 左（流出图标） | 本会话消耗：由 tokenUsage 投影 × 当前峰谷价估算，随投影实时刷新，不轮询 |
| 右（钱包图标） | 钱包余额：经 Host 同源 route 拉取，页面可见时每 60 秒轮询一次 |
点开 pill 后，详情里会按行展示账户余额、充值/赠送余额（两者都非零时合并）、今日我的消耗、今日余额减少、差额、今日充值、预计可用天数、当前峰谷时段，以及更新时间、统计起点、错误原因和手动刷新入口。两个「今日」口径不同：我的消耗 是本进程按事件与峰谷价算的 usage；余额减少 是本进程观测到的钱包下降（含其他终端、会话或 key），差额大于 ¥0.01 时提示可能被别处消耗。
为什么这么小¶
源码约 86 KB，两个 JS 文件（index.js Host、client.js 浏览器），无 npm、无编译。浏览器侧按需请求：可见时 60 秒轮询余额，隐藏则停；Host 侧 30 秒缓存、单飞、失败退避。API key 只在 Host 解析使用，浏览器只拿到展示用字符串。本地账本 $DSH_HOME/.dsh-status-balance.json（未设置 DSH_HOME 时为 ~/.dsh/.dsh-status-balance.json）只存金额、token 数与 session id，不存 prompt 或消息内容。
金额按 DeepSeek 官方 CNY / 百万 tokens 标价估算（DeepSeek 不返回单次调用成本），不是账单；折扣、赠送与计费差异不会完全体现。
安装与启用¶
需要带 Web UI 的 DSH profile（例如 composer.dock，且存在 tokenUsage / modelSelection 投影时可用）。
# 本地目录
dsh plugin --profile web add link:/absolute/path/to/dsh-status-balance
# 或从 GitHub
dsh plugin --profile web add github:ashuai/dsh-status-balance
安装后重启 dsh web（改 Host 半需重启；只改浏览器半则刷新页面）。卸载：
dsh plugin --profile web remove dsh-status-balance
配置（可选）¶
所有键写在 profile patch 该插件行的 config 下，均可省略。常用项如下（完整表见 README）：
| 键 | 默认 | 说明 |
|---|---|---|
balanceUrl |
https://api.deepseek.com/user/balance |
余额接口 |
apiKeyRef |
DEEPSEEK_API_KEY |
凭据引用 |
routePath |
/plugin/dsh-status-balance |
同源 GET 路由 |
cacheTtlMs |
30000 |
成功缓存时长 |
prices |
README 价表 | 可覆盖 timezone、peakWindows、models 等 |
峰谷默认按 Asia/Shanghai：工作日 09:00–12:00、14:00–18:00 为高峰，其余与周末为谷时；flash 系与 pro 系单价见仓库 README。
典型用法¶
- 按上文命令安装并重启
dsh web，打开 Web UI，在输入框下确认两个金额 pill 出现。 - 对话过程中观察左侧数字随会话 token 投影变化；右侧约每分钟更新余额（页面在前台且可见时）。
- 点击 pill 查看今日账本与预计可用天数；若今日余额减少从进程首次成功请求才开始观测，标签会显示「（自 HH:mm）」。
- 需要改价表或余额 URL 时，在 profile 的
config中写入对应键后重启 Host。
适用场景与注意¶
适合已经在 DSH Web UI 里日常对话、希望一眼看到本机会话估算花费与 DeepSeek 钱包余额、又不想让插件进入模型链路的用户。它不做多厂商、订阅额度、通知、桌面悬浮或历史趋势图。
安装前建议浏览仓库源码与 MIT 许可证。插件以当前 dsh 进程权限运行；同源路由 /plugin/dsh-status-balance 与其它插件路由类似，无额外鉴权，只返回展示字段——服务监听在哪个网卡，路由就在哪里可达。多 Host 进程共享同一 DSH_HOME 时本地账本可能互相覆盖。社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-status-balance 把「本会话花了多少、钱包还剩多少」收成输入框下的一行数字，需要时再点开今日账本。若要安装或查配置细节，以 GitHub README 为准：https://github.com/ashuai/dsh-status-balance；目录页：https://www.skillhub.cn/plugins/ashuai/dsh-status-balance。
