DeepSeek Harness 用量看板插件

DeepSeek Harness（DSH）采用插件化架构，开发者在使用过程中需要实时监控账户余额、今日消费及 Token 使用情况。rickyfu0625-cell/dsh-billing-dashboard 是一款为此需求设计的插件，提供右下角悬浮胶囊和完整面板，用于展示余额、消费趋势及充值入口。

核心功能¶

1. 账户余额监控¶

插件读取 DeepSeek 官方 /user/balance 接口数据，显示总余额、充值金额与赠送金额的拆分。当余额低于 ¥5 时，余额显示会标红提示。

2. 今日消费与 Token 统计¶

• 消费统计：支持两种模式。
  • 官方优先：如果配置了 DEEPSEEK_PLATFORM_TOKEN，优先调用官方用量接口获取今日消费。Token 失效时标签会标红。
  • 本地估算：未配置 Token 或接口失败时，插件会回放 $DSH_HOME 下的持久化会话日志，聚合 assistant/message 事件的 Token 并按官方价格折算。
  • 在面板内可以手动切换“数据来源”并持久化设置。
• Token 细分：统计今日输入 Token、输出 Token、缓存命中、缓存写入及推理拆分的具体数量。

3. 趋势图与充值¶

• 7 日消费趋势：提供折线图展示近 7 日的逐日消费，并附带数据标签。
• 一键充值：面板内提供“一键充值”按钮，点击直接跳转至 platform.deepseek.com/top_up。

4. 界面与交互¶

• 悬浮胶囊：右下角提供可拖拽的悬浮胶囊。收起状态下显示“今日消费”和“当前余额”摘要及刷新按钮。展开状态下显示完整面板，点击外部区域可收起。
• 位置持久化：胶囊位置会在窗口缩放或刷新后自动适配视口。
• 官方 Token 更新：提供“更新官方 token”按钮，支持粘贴新 Token 并在验证有效后写入配置。
• 主题适配：仅使用 --dsw-* 主题变量，跟随 DeepSeek Harness 的亮/暗色主题。
• 双语支持：界面语言跟随 DSH 的语言设置。

安装与启用¶

通过命令行安装插件：

dsh plugin --profile web add github:rickyfu0625-cell/dsh-billing-dashboard

安装完成后，需要重启 dsh web 进程并刷新浏览器页面，新的 bundle 会在启动时组合生效。

数据逻辑与适用范围¶

运行环境依赖¶

该插件仅适配 DeepSeek Harness（DSH） 环境，不能在 Claude Code 或 Codex 等 Harness 中运行。它依赖 DSH 的 webServer、sessionPersistence、credentials、slots 和 locale 服务。

模型与价格¶

• 模型识别：仅统计 DeepSeek 官方模型的消费。通过检测 provider 是否为 deepseek-official，或模型 ID 是否以 deepseek- 开头（如 deepseek-flash）来识别。非 DeepSeek 模型不计入消费。
• 价格同步：插件每天首次请求时会抓取官方定价页，解析当前价格并持久化。若与生效价不一致，后续消息将按新价折算。

注意事项¶

• 余额读取：需要已配置 DEEPSEEK_API_KEY（在 DSH 设置 → 模型中填写），密钥仅用于读取，不会离开 Host。
• 官方数据：获取官方消费数据需要配置 DEEPSEEK_PLATFORM_TOKEN（可通过浏览器 DevTools 获取）。若不配置，将自动回退到本地估算模式。