在使用 DeepSeek Harness (DSH) 进行开发或日常使用时，管理 API 密钥和监控余额是常见操作。如果需要在 Web UI 中快速查看余额，手动登录网页或命令行查询效率较低。DSH 插件机制允许扩展 Web UI 的功能。
dsh-plugin-api-quota 是一个 DSH Web UI 插件。由 ganfne123 维护，分类为「联网工具」。它的核心作用是从 Web 界面的侧边栏底部添加一个 API 余额入口，用于查询 DeepSeek API 密钥的余额情况。
核心功能¶
插件主要提供以下功能：
- 侧边栏集成：在 Web 侧边栏底部（Settings 旁）增加「API Quota」入口。
- 余额查询：查询 DeepSeek 官方余额接口 (
GET /user/balance)。 - 信息展示：面板显示总余额、已获余额、充值余额、币种以及可用状态。
- 交互刷新：显示查询时间，并提供刷新按钮以更新数据。
- 安全性设计：API Key 不会传输到浏览器端，而是通过插件宿主端的同源路由 (
/api-quota/balance) 处理。 - 宿主端处理：宿主端通过
ctx.credentials解析密钥，并调用api.deepseek.com。 - 可配置性：支持通过配置项
apiKeyEnv、baseURL和balancePath调整行为。
安装与启用¶
安装与启用插件需要手动操作，分为构建、注册和链接三个步骤。
- 在插件仓库根目录下运行构建命令：
npm install && npm run build
- 在配置文件
~/.dsh/profiles/web/cordis.patch.yml中注册插件：
- insert:
- id: plugin-api-quota
name: dsh-plugin-api-quota
- 将插件目录软链接到 Web profile 的
node_modules：
ln -s "$PWD" ~/.dsh/profiles/web/node_modules/dsh-plugin-api-quota
使用方法¶
安装并重启 dsh web 后，在侧边栏底部会出现新的「API Quota」入口。点击该入口，面板会显示余额信息。如果需要刷新数据，点击刷新按钮即可。
适用场景与注意¶
此插件适合需要在 Web 界面快速核对 DeepSeek API 余额的用户。插件以宿主进程的权限运行，安装前建议检查源码与许可证。该插件采用 MIT 许可证。
总结¶
通过这个插件，可以将余额查询集成到 DSH 的工作流中，减少切换窗口的频率。
插件目录：https://www.skillhub.cn/plugins/ganfne123/dsh-plugin-api-quota
源码：https://github.com/ganfne123/dsh-plugin-api-quota
