dsh-plugin-api-quota

DSH Web UI 插件 — 在侧边栏查看你的 DeepSeek API key 额度。

English

功能

在 Web 侧边栏底部（设置按钮旁）新增 API 额度 入口，点击弹出面板，通过 DeepSeek 官方余额接口（GET /user/balance）查询当前 API key 的额度：

• 总额度、赠送额度、充值额度
• 币种与可用状态
• 查询时间，支持一键刷新

API key 永远不会进入浏览器：浏览器半只请求同源的 /api-quota/balance 路由（由插件 host 半提供），host 半通过凭据服务（ctx.credentials）解析 key 并在服务端访问 DeepSeek。

工作原理

| 半区 | 职责 | | --- | --- | | Host（src/index.ts） | 在 web server 注册 GET /api-quota/balance；通过 ctx.credentials 解析 DEEPSEEK_API_KEY，调用 https://api.deepseek.com/user/balance | | 浏览器（src/client/） | 注册 sidebar.footer.action 槽位；请求该路由并渲染余额面板（Modal） |

凭据引用与端点均可通过插件配置调整（apiKeyEnv、baseURL、balancePath），默认值为 DEEPSEEK_API_KEY / https://api.deepseek.com / /user/balance。

快速开始

DSH 插件安装进 profile（dsh web → web profile）。安装后重启 dsh web 即可。

# 在插件仓库根目录
npm install && npm run build
# 在 profile 补丁层注册（~/.dsh/profiles/web/cordis.patch.yml）：
#   - insert:
#       - id: plugin-api-quota
#         name: dsh-plugin-api-quota
# symlink 进 profile 的 node_modules：
#   ln -s "$PWD" ~/.dsh/profiles/web/node_modules/dsh-plugin-api-quota

配置项

| 字段 | 默认值 | 含义 | | --- | --- | --- | | apiKeyEnv | DEEPSEEK_API_KEY | 持有 API key 的凭据引用（环境变量形状） | | baseURL | https://api.deepseek.com | DeepSeek API 基础地址 | | balancePath | /user/balance | 附加到 baseURL 的余额接口路径 |

License

MIT