在 DeepSeek Harness (DSH) 的 Web 界面中开发智能体时，若使用 OpenCodex 作为底层提供方，开发者通常需要频繁确认 API 配额、速率限制以及费用统计。在聊天窗口中反复切换标签或打开终端查看，既影响开发效率也容易打断心流。dsh-opencodex-usage 插件旨在解决这一痛点，提供一个常驻屏幕的悬浮监控组件，将复杂的接口数据转化为直观的卡片视图。
插件定位¶
这是一个由 Walvez 维护的 DSH 客户端插件，用于在 DeepSeek Harness 的 Web 界面中展示 OpenCodex 的用量数据。它通过读取本地 OpenCodex 的接口和配置文件，将多提供方的速率限制、配额剩余以及费用统计集成到一个可自由拖拽的悬浮卡片中，无需手动刷新页面即可获取最新状态。
核心功能¶
1. 自由拖拽与位置记忆¶
插件在聊天主界面生成一个悬浮胶囊。用户可以按住胶囊在屏幕任意位置拖拽，松开后位置会自动保存在浏览器的 localStorage 中。即便刷新页面或重启服务，胶囊仍会出现在上次的位置。插件加入了防误触逻辑，能够区分微小的移动（点击打开面板）和大幅度的拖拽操作。
2. 全量接入 5 大提供方速率与配额监控¶
插件直接对接 OpenCodex 的官方接口获取数据。支持的提供方包括 OpenCode Go、Google Antigravity、OpenAI (Codex login)、xAI Grok 和 DeepSeek。针对每个提供方，插件展示不同的关键指标，例如 OpenCode Go 的 5 小时滚动限额、Google Antigravity 的 Gem/Cla 用量百分比、OpenAI 的账户池容量恢复提示以及 DeepSeek 的实时 API 余额。
3. 用量与费用统计¶
插件提供 7 天和 30 天两种统计周期。面板展示总请求数、总 Tokens、Cache 缓存命中率以及基于 API 估算的费用。同时，它还列出了当前活跃度最高的模型排行榜，帮助开发者快速了解资源消耗情况。
4. 零配置自动探测¶
插件不需要手动配置 OpenCodex 的运行端口和鉴权 Token。它会自动读取 ~/.opencodex/runtime-port. 获取动态端口，并读取 ~/.opencodex/admin-api-token 完成鉴权。同时，它适配了 DSH 的设计令牌，能够自动适应深色、浅色以及自定义皮肤主题。
安装与启用¶
- 克隆仓库
cd ~/.dsh/profiles/web/plugins
git clone https://github.com/Walvez/dsh-opencodex-usage.git
- 修改配置文件
打开~/.dsh/profiles/web/package.json，在dependencies中添加插件依赖，并在dsh.profile.bundles中加入插件名称。
{
"dependencies": {
"dsh-opencodex-usage": "link:plugins/dsh-opencodex-usage"
},
"dsh": {
"profile": {
"bundles": [
"dsh-opencodex-usage"
]
}
}
}
- 重启服务
安装完成后，必须重启dsh web服务才能使插件生效。
典型用法¶
安装并重启服务后，在 DSH 的聊天主界面会出现一个悬浮胶囊。点击胶囊可展开监控面板，拖拽胶囊可改变其在屏幕上的位置。面板顶部提供 7 天和 30 天的切换按钮，用于查看不同时间维度的用量与费用统计。
适用场景与注意¶
本插件以 DSH 进程的权限运行，因此它依赖于本机安装并正在运行的 OpenCodex 服务。确保 OpenCodex 的运行端口（默认 10100）和鉴权 Token 配置正确。此外，插件遵循 MIT 许可证，使用时请自行检查源码与许可证。
对于需要在 DSH 中频繁管理 OpenCodex 资源的开发者，dsh-opencodex-usage 提供了一种直观且低干扰的监控方案。它将复杂的接口数据转化为可视化的悬浮卡片，减少了视线在窗口与终端之间的切换。
插件目录：https://www.skillhub.cn/plugins/Walvez/dsh-opencodex-usage
源码地址：https://github.com/Walvez/dsh-opencodex-usage
