DeepSeek Harness（DSH）采用模块化插件架构。在使用 Web 端进行开发或日常操作时，频繁查看订阅额度或 API 支出往往需要在不同标签页或菜单间切换。dsh-usage-mini 旨在解决这一问题，提供一个悬浮面板，将关键的使用数据集中在屏幕一侧。
它是什么¶
这是一个专为 DeepSeek Harness Web 客户端设计的轻量级悬浮仪表盘。它不负责数据的采集或账户连接，而是作为 dsh-cost-meter 和 dsh-plugin-subscriptions 的可视化补充，专注于在界面上保留关键的使用情况。
核心功能¶
- 订阅与 API 监控：支持 Claude 和 Codex 订阅，显示可用使用窗口、已用/剩余百分比、重置时间及倒计时。同时显示 DeepSeek API 的本地记录支出/调用次数以及上游缓存的官方余额。
- 语言跟随：界面语言自动跟随 DSH 的全局语言设置（中文/英文），无需独立切换。
- 交互与位置记忆：窗口可拖动、可折叠，并自动记忆其在浏览器中的位置。
- 数据轮询：仅在窗口展开且页面可见时，每 60 秒轮询一次数据；折叠或隐藏时停止轮询以节省资源。
- 内置反馈：底部提供反馈栏，可直接向 GitHub 提交 Issue。
安装与启用¶
- 安装插件
执行以下命令将其添加到 Web 配置文件：
dsh plugin --profile web add dsh-usage-mini
-
启用小窗
安装完成后重启 DeepSeek Harness Web，在 Settings（设置）中找到“用量小窗”选项并开启。 -
前置依赖
该插件依赖dsh-plugin-subscriptions和dsh-cost-meter插件才能正常获取 Claude 订阅和 DeepSeek API 的数据。
注意事项¶
- 平台限制：仅支持 DeepSeek Harness Web 客户端，不支持 TUI 或 Headless 模式。
- 运行环境：经验证的 Node.js 版本为 22.23.2。
- 数据隐私：不持久化使用数据，仅持久化 UI 位置和折叠状态；不处理凭据或文件访问。
- 权限范围：插件运行在 DSH 进程权限内，不包含生命周期脚本或外部网络请求。
总结¶
对于需要在 Web 端持续监控 API 支出和订阅额度的用户，dsh-usage-mini 提供了一个低干扰、即开即用的解决方案。
