DeepSeek Harness（DSH）是用于智能体开发的客户端工具，但在实际使用中，开发者往往难以实时掌握账户余额的精确变动以及每一步请求的消耗细节。官方账单通常存在滞后，且无法提供逐条请求的明细分析。
dsh-balance-stats 是一个为 DSH 提供的客户端插件。它通过读取本地会话日志，结合内置的官方定价规则，实时计算并展示余额、续航时间以及详细的消耗明细。插件基于 MIT 协议开源，API 密钥仅存储于本地，浏览器无法接触，确保了使用安全。
功能¶
该插件主要提供以下能力：
- KPI 盘头：在右上角悬浮胶囊和设置页顶部展示余额、续航、今日/本月/本会话的消耗情况。
- 预算制动：支持设置每日预算上限，当今日消耗超过阈值时，通过颜色变化（黄/红）进行提示。
- 缓存命中率健康提示：当缓存命中率低于 50% 时，自动弹窗警告，提示用户优化缓存策略。
- 计算步骤明细：逐条列出每一笔费用的计算过程，与官方账单对账，包含输入、输出、缓存命中/未命中的分项统计。
- 官方定价与扣费规则：内置官方价格表，包含峰谷计价规则，并提供直达官方定价页的链接。
- 会话明细：支持按工作区、时间（全部/今天/昨天/本周/本月）以及标题或 ID 进行筛选。
- 历史会话完整统计：磁盘上持久化的旧会话也会纳入统计，而非仅限于最近打开的会话。
- 差额说明：解释本地统计与官方账单之间几毛钱差值的来源（主要是标题生成和网页搜索）。
- 六项进阶能力：包括错峰省钱建议、最贵请求排行、工作区成本排行、对账闭环、定价快照自检以及本会话实时花费。
安装¶
确保已安装 DSH 并配置好环境变量。在终端中执行以下命令安装插件：
dsh plugin --profile web add "C:\dsh-plugins\dsh-balance-stats"
安装完成后，重启 dsh web 并刷新浏览器即可使用。
典型用法¶
- 查看核心指标：在设置页的“余额与消耗”顶部查看四个大数字卡片，或点击右上角悬浮胶囊查看续航、今日、本月及本会话花费。
- 设置预算：在设置中配置每日预算上限，查看进度条变化。
- 筛选会话：使用工作区下拉菜单、时间筛选器以及标题或 ID 搜索功能，快速定位特定会话的消耗情况。
注意事项¶
- 数据差异：由于插件无法统计“标题生成”和“网页搜索”这两类本地日志不记录的调用，本地统计与官方账单通常存在几毛钱的差值。
- 启动耗时：首次打开面板时，需要等待几秒钟扫描历史会话。
- 时间判断：峰谷时段的归属依据本地记录的事件时间判断，可能与官方归账存在极少数秒级偏差。
结语¶
dsh-balance-stats 通过本地化计算和实时监控，帮助开发者更精确地控制 DeepSeek 账户的消耗。插件维护者提供了 GitHub 仓库和 SkillHub 目录页供查阅。
