前言¶
DeepSeek Harness (DSH) 的插件生态允许扩展 Web UI 的功能。开发者通常需要直观地查看账户余额和当前的计价时段，以控制成本。dsh-balance-usage 插件直接在侧边栏展示这些信息，并按官方规则估算每一轮对话的花费。
这是什么¶
这是一个由 LZ-jun 维护的开源插件，采用 MIT 许可证。它不依赖任何第三方服务，仅通过 DSH 官方账号服务和本地会话日志获取数据，在侧边栏左下角以绿色显示余额与峰谷时段，并实时估算每个会话与每一轮的花费。
核心功能¶
侧边栏余额与时段显示¶
插件在侧边栏左下角显示账户余额。当侧边栏展开时，显示钱包图标、余额金额胶囊以及时段状态（空闲/忙碌）。当侧边栏收起（56px 轨道）时，以紧凑模式显示金额胶囊，圆点颜色依旧表示峰谷。
* 余额状态着色：
* 充足：绿色
* 偏低（默认阈值 10 元以下）：琥珀色
* 为 0：红色
* 时段判定：绿色圆点代表空闲时段，琥珀色圆点代表忙碌时段。悬停提示会显示余额、当前时段以及距切换还有多久。
展开面板详情¶
点击侧边栏的余额条目，会向上展开一个浮层面板，包含以下内容：
* 账户余额：显示总额、充值/赠送拆分、余额来源。点击余额可直接跳转至官方账号页或充值页。
* 当前计价时段：显示空闲/忙碌胶囊、当前北京时间，以及距下一次切换的实时倒计时。
* 忙碌时段（高峰计价）：列出周一至周五 09:00–12:00 和 14:00–18:00（北京时间），并说明高峰价 = 空闲价 × 2；周末与法定节假日全天按空闲计价。
* 近期用量统计：提供今日、近 7 天、近 N 天的 Token 估算费用与请求次数；包含近 14 天每日 Token 柱状图；按模型拆分的详细表格。鼠标悬停在柱状图上可查看当日明细。
* 交互与刷新：面板通过 React Portal 渲染，支持点击外部或按 Esc 关闭。支持自动刷新间隔设置（默认 60 秒）和外观主题切换（跟随/深色/浅色）。
会话与单轮花费估算¶
插件在输入框下方与每一轮的用量旁边，按官方高峰/空闲价估算费用：
* 本会话消耗：在输入框下方的 dock 区域显示胶囊“本会话消耗 ≈ ¥x”。点击后向上展开，显示高峰花费、空闲花费、请求次数、缓存命中率及模型信息。
* 本轮花费：在每一轮的用量行右侧，显示“本轮花费 ≈ ¥x”触发器。点击后查看该轮的详细花费拆分。
计价规则与数据来源¶
- 定价规则：遵循 DeepSeek 官方定价文档。高峰为周一至周五 09:00–12:00 和 14:00–18:00（北京时间），价格翻倍；周末与法定节假日全天按空闲计价。
- 节假日表：内置了 2026 年法定节假日表。
- 判定时刻：峰谷归属按请求发起时刻（
step/start事件时间）判定，取不到时回退到消息完成时刻。 - 数据来源：不依赖 DSH 官方账号服务与本地会话日志，不接入任何第三方服务。
价格表¶
插件内置了空闲时段的官方价格表（元 / 百万 tokens）。高峰时段价格按 ×2 计算。
| 模型 | 输入（缓存未命中） | 输入（缓存命中） | 输出 |
|---|---|---|---|
deepseek-flash |
1 | 0.02 | 4 |
deepseek-v4-pro |
4.5 | 0.15 | 13.5 |
deepseek-chat（旧） |
2 | 0.5 | 3 |
deepseek-reasoner（旧） |
4 | 1 | 16 |
安装与启用¶
本插件是一个标准的 DSH bundle 包（package.json 中包含 dsh.bundle.patch 与 dsh.client）。安装后由 profile 的 bundle 栈自动挂载，无需手动修改配置文件。
典型用法¶
- 点击侧边栏的余额条目，查看余额、倒计时、时间表与用量统计。
- 点击输入框下方的“本会话消耗”胶囊，查看会话总花费的拆分详情。
- 点击每轮用量行右侧的“本轮花费”触发器，查看本轮对话的费用。
注意事项¶
- 定价遵循官方规则，本地按官方价表估算，非官方账单。
- 不支持跨时段请求的精确边界判定，按请求发起时刻（step/start）判定。
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
结语¶
该插件通过侧边栏和输入框两处的直观展示，解决了开发者对 DeepSeek 账户余额和实时成本的关注需求。更多细节可查阅插件目录页或 GitHub 仓库。
