DSH（DeepSeek Harness）是智能体开发框架，Web 界面是其主要交互入口。在调试或长时间运行任务时，开发者需要实时掌握账户余额与 Token 消耗情况。手动查询 API 或查看日志会打断工作流。dsh-usage-panel 插件通过集成监控功能，将这些数据直接展示在会话头部。
dsh-usage-panel 是一个客户端插件，由 Mysterious Mark 维护。它为 DSH Web 界面提供 DeepSeek 账户余额与当前会话 Token 用量的实时监控面板，数据以彩色胶囊形式显示在会话头部右侧。
核心功能¶
- 余额显示：调用官方
GET /user/balance接口，显示总额、充值金额与赠送金额。 - Token 用量：读取宿主
tokenUsage投影，展示未缓存输入、缓存命中、缓存写入、输出、合计以及缓存命中率。 - 三级余额预警：支持自定义阈值，根据余额充足/警告/不足状态改变胶囊颜色。
- 充值入口：提供去充值、用量明细、登录平台、复制链接入口，支持在新标签页、当前标签页或复制链接打开。
- 查询效率优化：仅在页面可见时进行轮询，页面隐藏时暂停；支持失败指数退避、宿主端 30s 缓存与单飞窗口、手动刷新。
- 跨端兼容策略：
- 宿主端优先使用
ctx.connection.fetch并回退ctx.webServer。 - 浏览器端优先使用
conversation.session.header.utilities，其次conversation.session.header.corner。 - 纯 JavaScript 实现，无平台相关代码。
安装与启用¶
在终端执行以下命令将插件安装到 Web profile：
dsh plugin --profile web add dsh-usage-panel
安装完成后，重启 dsh web（或等待热重载）并刷新页面即可看到效果。
典型用法与配置¶
安装后，面板会自动显示在会话头部右侧。如需调整参数，可在 patch 中配置以下字段：
| 字段 | 默认值 | 说明 |
|---|---|---|
routePath |
/api/usage-panel/balance |
宿主端用于接收余额请求的路由 |
cacheMs |
30000 |
上游缓存时间与单飞窗口（毫秒） |
apiKeyEnv |
DEEPSEEK_API_KEY |
用于解析密钥的环境变量名 |
baseUrl |
https://api.deepseek.com |
服务商 API 地址 |
baseUrlEnv |
DEEPSEEK_BASE_URL |
用于覆盖 baseUrl 的环境变量名 |
适用场景与注意¶
- 宿主端：需要 Node.js 18 及以上版本。插件以当前 dsh 进程的权限运行，安装前请检查源码与许可证。
- 浏览器端：依赖内置 React 与 slots 服务。
- 容错：若宿主端缺少
useProjection投影，余额信息仍可正常显示。
该插件通过可视化面板解决了余额监控与用量追踪的痛点，适合需要在 Web 界面持续监控成本的 DSH 用户。
