DSH（DeepSeek Harness）采用“一切皆插件”的理念，支持通过插件扩展 Web 客户端的功能。在使用 Web 界面进行智能体开发或调试时，实时掌握 DeepSeek API 的账户余额与今日消耗是控制成本的关键。dsh-deepseek-balance 插件将这两项数据直接集成到左侧 rail 的底部，无需跳转页面即可查看。
这是一个由 qschen86 维护的 Web 客户端插件，用于在 DSH 界面的侧边栏底部展示余额徽章和消耗统计。
核心功能¶
- 余额徽章：显示在
sidebar.rail.footer槽位。内容为当前余额 + 今日消耗。当余额低于 5 元时，徽章颜色会变红。 - 详情面板：点击徽章弹出面板，显示余额明细（CNY/USD）、今日消耗量与 Token 数、以及近 30 天的消耗曲线（基于本地快照差分计算）。
- 自动刷新：在会话开始或结束回合时刷新数据。采用 60 秒缓存 + 单飞去重 + 服务端节流机制。若刷新失败，会回退显示最后一次成功获取的快照（Stale 数据）。
- 消耗统计：基于会话日志进行增量扫描（结合水印与 Liveness 机制），不重放全部历史日志，保证统计效率。
安装与启用¶
- 安装插件：
dsh plugin --profile web add dsh-deepseek-balance
（也可以直接指定 GitHub Release 的 tarball 路径，但第一种方式更简洁。安装后可使用 `dsh --profile web --dump-config` 验证条目。）
- 重启 dsh web 服务（部分配置生效）。
- 刷新浏览器页面（部分配置生效）。
典型用法¶
- 配置凭据：进入 DSH 设置，找到“凭据”选项，添加名为
DEEPSEEK_API_KEY的凭据，其值填入 DeepSeek 开放平台的 API Key。 - 验证显示：刷新页面后，左侧 rail 底部应出现余额徽章。
- 查看详情：点击徽章，弹出详情面板查看余额明细和消耗曲线。
注意事项与已知限制¶
- 版本兼容：该插件验证于 dsh 0.1.0-rc.6。余额和消耗面板完全基于官方槽位和服务注入，升级后通常兼容。
- 手动补丁（已知问题）：在当前验证版本下，“Deep diving…”鲸鱼喷水动画与插件清单标签页，需要手动对闭包内的两个客户端文件进行补丁（
dsh-client-ui-conversation/dsh-client-ui-settings-plugin-inventory）。这些补丁在 dsh 升级后会丢失，需要重新应用，但不影响余额和消耗功能。 - 权限与隐私：插件仅通过
ctx.credentials读取 API Key，不接触其他存储，且不读取凭据之外的配置。
该插件通过官方槽位将 API 消耗可视化，适合需要在本地频繁调用 DeepSeek API 的开发者。项目源码与详细文档可在 GitHub 查看。
