前言¶
DeepSeek Harness（DSH）采用插件化架构，但在日常使用中，监控 API 余额和 Token 消耗并不直观。现有方案往往需要手动切换页面或依赖第三方监控工具。tugu-dsh-balance-widget 插件在 DSH 侧边栏增加了一个入口，通过居中大卡片实时展示余额、充值入口及消耗数据，解决了这一痛点。
插件信息¶
名称: tugu-dsh-balance-widget
作者: jieguanya
许可: MIT
定位: 联网工具类插件
核心功能¶
该插件通过侧边栏入口与设置按钮保持同一水平行，提供以下功能：
-
左下角入口与居中大卡片
入口位于侧边栏左下角，点击后弹出居中大卡片。卡片支持点击遮罩、关闭按钮或 ESC 键关闭。面板打开期间，入口保持可见，可随时切换。 -
实时余额监控
插件自动读取 DSH 已配置的DEEPSEEK_API_KEY，调用 DeepSeek 官方接口GET /user/balance。面板打开期间每 60 秒自动刷新余额数据，支持手动刷新。 -
充值入口
面板内提供充值按钮，点击后直接在新窗口打开 DeepSeek 官方充值页面platform.deepseek.com/top_up。 -
今日消耗与模型分组
展示今日调用次数、Token 合计及金额。消耗数据按模型分组展示（模型 / 调用次数 / 金额），新增模型无需修改插件配置即可自动出现。 -
消费趋势图
默认显示近 7 天或近 30 天的每日消耗柱状图，支持鼠标悬停查看每日金额与 Token 明细。 -
当前会话 Token
全量回放会话持久化日志，实时补充进行中消息，覆盖重启前的历史记录。 -
今日约消费
通过当前余额与期初余额的差值进行估算，数据标注“约”字，避免与官方数据混淆。 -
安全机制
API Key 仅在宿主侧按请求解析，浏览器端只访问本地路由，Key 不出本机。
安装与启用¶
前置条件:
- DeepSeek Harness 0.1.7+
- 已配置 DEEPSEEK_API_KEY（设置页面或 .credentials.yaml）
安装命令:
dsh plugin --profile web add <插件目录路径>
典型用法¶
重启 DSH 后，侧边栏左下角会出现「余额」入口（与设置按钮同行）。点击该入口即可查看居中大卡片。
若需验证接口返回数据，可使用以下命令（将 <端口> 替换为实际端口）：
curl http://127.0.0.1:<端口>/api/dsh-balance
注意事项¶
- 该插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证。
- 同事机器上无需配置 Node.js 或 pnpm 环境，一键脚本可自动处理。
- 插件基于官方价格表进行计价与展示。
