AHui-Lab/dsh-usage-widget

dsh-usage-widget

一个 DeepSeek Harness (DSH) 插件，在 Web GUI 的左侧边栏内保留一个紧凑的用量小组件：

- DeepSeek 账户余额 — GET https://api.deepseek.com/user/balance
- Kimi Code 配额 — GET https://api.kimi.com/coding/v1/usages（5 小时窗口 + 每周配额）

该面板始终显示在侧边栏底部，点击可折叠/展开，每 60 秒自动刷新，并提供 DeepSeek / Kimi 切换。

社区插件，并非 DeepSeek 官方插件。

安装

需要 DSH Web/Desktop 配置文件（该插件面向浏览器客户端）。

从 GitHub 安装（仓库已附带预构建的 lib/，无需构建步骤）
dsh plugin --profile  add github:AHui-Lab/dsh-usage-widget

发布到 npm 后
dsh plugin --profile  add dsh-usage-widget

如果没有全局 dsh CLI
npx --yes @deepseek-ai/dsh plugin --profile  add github:AHui-Lab/dsh-usage-widget

重启 DSH，然后在左侧边栏底部查找“用量”条目。

数据如何流转

浏览器无法直接调用 api.kimi.com（其 CORS 预检请求会拒绝 Authorization 头），因此该插件保留了两条数据路径：

1. 宿主路由 GET /usage-monitor/deepseek|kimi（注册在宿主 Web 服务器上）代理上游。它优先使用客户端在 Authorization 头中发送的 API 密钥，否则回退到 DSH 凭据服务 / 环境变量。
2. 浏览器直连回退（当宿主路由不可达时使用）：使用用户在面板中存储的密钥直接请求上游。对 DeepSeek 有效（允许 CORS）；在此模式下 Kimi 会被 CORS 阻止。

API 密钥

密钥是每台机器独立的，绝不随插件分发：

- 宿主路由模式：将 DEEPSEEK_API_KEY / KIMI_CODING_API_KEY 放入 ~/.dsh/.credentials.yaml 或环境变量中（宿主读取它们）。
- 浏览器直连回退：打开面板 → 齿轮图标 → 粘贴 DeepSeek API Key 和 Kimi Code token。它们仅保存在浏览器的 localStorage 中（键前缀 usage-monitor.key.），并且仅发送到上游 API。

注意：密钥有意不随插件分发。每台机器自行配置。

布局

该小组件注册到 sidebar.footer.action 列表插槽中，并内联渲染在侧边栏列内（占满列宽，无浮动覆盖层，不与聊天区域重叠）。所有样式都限定在 data-plugin="dsh-usage-widget" 下。

开发 / 发布说明

- 宿主入口：lib/index.js（注册两个 /usage-monitor/ 路由；inject: ["webServer"]）。
- 客户端 bundle：lib/client.js（ModuleLoader bundle；仅从基线中使用 react + @deepseek-ai/dsh-client-ui-primitives）。
- lib/ 已提交，因此 GitHub 和 npm 安装都无需构建步骤。
- 环境变量覆盖：USAGE_MONITOR_DEEPSEEK_REF、USAGE_MONITOR_KIMI_REF、USAGE_MONITOR_DEEPSEEK_BASE、USAGE_MONITOR_KIMI_BASE。

发布前验证：

npm run check
npm pack --dry-run --ignore-scripts

许可证

MIT