前言¶

用 DeepSeek Harness（dsh）跑 Web 客户端时，账户里还剩多少钱、今天烧了多少 token，往往要另开页面或自己翻 session 日志。官方余额接口能查余额，但和「本机 dsh 今天实际用了多少、按当前峰谷价大概花多少」并不在同一块 UI 里。

下面介绍社区插件 dsh-plugin-balance-ui（维护者 novaschai7，GitHub：novaschai7/dsh-plugin-balance-ui）。它在 dsh Web 客户端侧边栏底部增加一块面板，展示 DeepSeek 账户余额、今日 token 用量、今日花费估算，以及当前北京时间计费档位是高峰还是空闲；悬停可看明细与对账信息。插件分类为客户端，当前 GitHub 星标为 0，版本 0.1.0，许可证 MIT。

这是什么¶

dsh-plugin-balance-ui 是面向 DeepSeek Harness Web 客户端的账户与用量面板插件。数据主要在本地从 dsh 已有信息推导：除 DeepSeek 官方余额接口外，不调用其它第三方服务。

侧边栏展示什么¶

侧边栏展开时，面板 footer 区域大致包含以下行（含义以 README 为准）：

侧边栏收起时，上述数值会以紧凑文字堆叠在 rail 内。鼠标悬停会出现 tooltip：充值与赠送余额、输入/输出/cache-hit token 数、请求次数、花费估算的分档明细、当前「每百万 token」单价，以及下一档切换的北京时间点。

数字从哪里来¶

README 说明的计算方式如下。

余额 — 宿主侧通过 dsh 的 credential 机制携带凭证请求 https://api.deepseek.com/user/balance，缓存 30 秒。

用量 — 宿主侧遍历 $DSH_HOME/sessions（默认 ~/.dsh/sessions）下的 session 日志，解压 .jsonl.zstd，汇总本地午夜之后每条 assistant/message 的 token；缓存 10 秒，只读不写。

花费 — 浏览器侧按 DeepSeek 公布的 CNY 价目表，分别按高峰档与空闲档为各模型行计价。reasoningTokens 由宿主上报但不单独计费（已包含在 outputTokens 内）；cache-write 按零价处理（价目表仅列 cache-hit 输入、cache-miss 输入与输出）。

高峰与空闲¶

高峰为北京时间（UTC+8）工作日 09:00–12:00、14:00–18:00，不含中国法定节假日；其余时段（含周末与节假日）为空闲，费率约为高峰的一半。宿主为每条 assistant 消息打上所属窗口，分档计价；时段徽章在下一北京时间边界（09:00 / 12:00 / 14:00 / 18:00 / 午夜）切换，而非仅依赖轮询间隔。

价目表引用自 DeepSeek 定价文档（CNY / 百万 token），README 中列有 deepseek-flash、deepseek-v4-pro 的高峰/空闲 input、output、cache hit 单价；已退役的 deepseek-v4-flash、deepseek-v4-flash-vision-exp 会别名到 deepseek-flash。价目表中没有的模型标记为未定价，花费行显示 —。

2026 年法定节假日列表在插件中显式维护（依据国办发明电〔2025〕7 号）；列表需每年更新（通常次年 11 月发布新通知）。未收录的年份按「无节假日」处理，可能在工作日高峰时段略高估花费。花费为估算，不是账单；不含折扣、赠送抵扣或发布后的调价。

对账行¶

插件会定时采样账户余额（约每 15 分钟，以及 footer 轮询时），用余额下降之和推断实际支出，充值与赠送增加不计入花费。对账 比较本地估算与该推断在「从各自午夜起已被完整采样」的天数内（逐渐增至 7 天）的差值；tooltip 按日分解并说明可观测原因（本机未记录的调用、折扣/赠送、充值与采样间隔、节假日、未定价模型等）。新安装在对首个完整日之前显示 样本不足。

README 明确两点局限：本地 session 无 cache-write 字段，若官方对 cache write 计费则估算看不到；对账仅针对 CNY 账户，其它币种不做错误对比。

安装与启用¶

在 dsh 插件市场（dsh-market）中搜索 balance-ui 安装，或使用命令行（须与 README 原文一致）：

dsh plugin --profile web add dsh-plugin-balance-ui

安装后重启 dsh 服务，以便新的 profile 层完成组合。

环境与依赖¶

• 使用绑定 Web 应用的 dsh profile。
• DeepSeek API key 需通过 dsh credential 以 DEEPSEEK_API_KEY 提供；无 key 时用量相关行仍可用，仅余额行报错。
• Node.js ≥ 22.15.0（宿主侧使用 zlib.zstdDecompressSync）。

宿主提供的只读路由¶

宿主侧注册四条同源、只读 JSON 路由（均拒绝非 GET/HEAD 与跨域），供客户端拉取数据：

典型用法无需额外配置：安装并重启后打开 dsh Web 客户端，展开或收起侧边栏即可在 footer 查看面板；需要明细时悬停面板即可。

适用场景与注意¶

适合长期在 dsh Web 端对话、希望同屏掌握余额、今日用量与按峰谷价估算花费的开发者。DSH 生态主张「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。

插件以当前 dsh 进程权限运行，会读取本地 session 日志并调用 DeepSeek 余额接口；安装前请自行查看 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全与合规要求。

小结¶

dsh-plugin-balance-ui 把 DeepSeek 余额、本机 session 汇总的今日 token、按北京时间峰谷档估算的 CNY 花费，以及可选的对账提示，放进 dsh Web 侧边栏 footer，减少切页与手工算账。

• 目录页：https://www.skillhub.cn/plugins/novaschai7/dsh-plugin-balance-ui
• 源码与说明：https://github.com/novaschai7/dsh-plugin-balance-ui