前言¶
在 DSH（DeepSeek Harness）里调用 DeepSeek、Moonshot、Kimi For Coding、OpenAI Codex（Codex Connect）、OpenCode Go 等 provider 时，余额和套餐配额通常分散在不同接口中。手动查询比较分散，也容易把 API Key 暴露到浏览器端。dsh-plugin-llm-balance 是一个 DSH 插件，在 Web GUI 页面右上角提供一个可拖动的悬浮卡片，用于集中显示最近使用 provider 的余额/配额，并按阈值分档变色。
这是什么¶
下面介绍 FengHuoLinShan/dsh-plugin-llm-balance 的能力、安装方式和需要注意的边界。
- 维护者：
FengHuoLinShan - 定位：DSH Web GUI 插件
- 许可证：
MIT - 核心场景：在浏览器端查看 provider 余额与配额，不向前端发送 API Key 和 OAuth token
核心功能¶
最近使用的 provider 卡片¶
插件在 Web GUI 中常驻显示最近使用的最多 3 个 provider 的余额/配额悬浮卡片。它只记录插件启用后成功完成的模型调用，显示最近 3 个不同 provider。
余额与配额¶
插件同时支持金额余额与套餐配额展示，包括 5 小时、周等可用窗口及重置时间。状态颜色按最紧张窗口计算。余额与配额按阈值分档变色；加载或查询失败时显示灰色。
交互与刷新¶
- 卡片可拖动并记忆位置
- 点击卡片即可刷新
- 默认每 60 秒自动刷新
- 页面隐藏时暂停刷新，恢复可见时立即更新
DeepSeek 峰谷电价徽标¶
DeepSeek 行可显示「低谷 / 高峰」徽标。该状态为纯时钟计算，不发送余额查询请求；tooltip 显示时段表与距切换倒计时。
自动发现配置¶
插件合并内置 provider、llm-pi-ai.providers.* 和本插件配置，用于自动发现当前可展示的 provider。
凭据边界¶
API Key 和 OAuth token 不会发送到浏览器，也不会出现在任何响应、日志或页面中。余额查询通过仅允许 loopback 权限的 Connection RPC 完成。
支持范围¶
当前资料列出的 provider 包括：
- DeepSeek / DeepSeek Official
- Moonshot / Moonshot CN
- Kimi For Coding
- OpenAI Codex（Codex Connect）
- OpenCode Go
OpenAI Codex 依赖可选的 dsh-codex-connect，最低兼容版本为 0.1.0-alpha.4.5。不安装时，插件仍会运行，只是 openai-codex 如实显示未配置。
安装与启用¶
先确认 DSH 版本满足要求：0.1.0-rc.7 或更高版本。该版本引入了插件使用的 Connection RPC 独立通道。
下面使用 GitHub 方式安装：
dsh plugin --profile web add "github:FengHuoLinShan/dsh-plugin-llm-balance#main"
安装完成后，需要重启 dsh 服务，然后刷新页面。插件集合变更需重启 dsh 服务生效；client bundle 改动在 DSH checkout 的 pnpm run dev:web watcher 运行时可 HMR，否则需重新安装/重启服务并刷新页面。
如需显示 OpenAI Codex，另外安装 dsh-codex-connect：
dsh plugin --profile web add dsh-codex-connect@alpha
安装后，在其界面完成 ChatGPT OAuth 登录。不安装该可选依赖时，不影响其他 provider 的展示。
典型用法¶
查看卡片¶
重启 dsh 服务并刷新页面后，页面右上角会出现悬浮卡片。卡片会显示最近使用的最多 3 个 provider，并给出余额、配额、重置时间等信息。
调整轮询间隔¶
个性化配置在 ~/.dsh/profiles/web/cordis.patch.yml 中按行 id 覆盖。例如覆盖 refreshMs 为 30000：
# 在 ~/.dsh/profiles/web/cordis.patch.yml 中按行 id 覆盖
# 示例字段：refreshMs: 30000
# 注意：覆盖时需完整重述该行需要的全部 config 键
默认轮询间隔为 60 秒。
自测¶
如果从源码 checkout 获取插件，可以运行自测脚本：
node test/balance.test.mjs
卸载¶
dsh plugin --profile web remove dsh-plugin-llm-balance
适用场景与注意¶
适合正在使用 DSH Web GUI，并希望集中查看 DeepSeek、Moonshot、Kimi For Coding、OpenAI Codex（Codex Connect）、OpenCode Go 等 provider 余额/配额的使用者。
使用前注意：
- 插件会以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- 许可证为
MIT。 - 余额/配额数据来自官方接口，可能略有延迟，仅供参考。
- OpenCode Go 端点目前无官方公开文档，可能变化。
- API Key 和 OAuth token 不出服务端；不会发送到浏览器。
链接¶
- GitHub：https://github.com/FengHuoLinShan/dsh-plugin-llm-balance
- 社区目录页：当前资料未确认 URL，这里不给出具体链接。
