前言¶
DSH 的插件化思路会把常用能力拆成可加载的插件。对同时使用多个 AI 平台的开发者来说，余额和用量往往分散在不同控制台里。dsh-api-balance 是 Badegg404 维护的一个 DSH Web 插件，用于在会话标题栏悬浮显示多个 AI 平台的账户余额与用量，并分 Balance（余额）和 Usage（用量）两个 tab。下面介绍它的定位、核心功能、安装命令和典型用法。
这是什么¶
dsh-api-balance 是一个 DSH Web 插件：会话标题栏悬浮显示多个 AI 平台的账户余额与用量（余额 / 用量双 tab）。
它由 Badegg404 维护，许可证为 MIT。GitHub 仓库为：
https://github.com/Badegg404/dsh-api-balance
核心功能¶
- 多供应商：一个插件查询多个 AI 平台，并可在 UI 中切换 provider。
- 双 Tab：
Balance（余额）显示账户余额；Usage（用量）显示 30 天费用或 token 配额。 - 持久化：provider / API key / 额外参数保存在 DSH credentials store（
~/.dsh/.credentials.yaml，mode 0600），重启后保留。 - 实时刷新：30s 自动轮询，并支持手动刷新。
- 安全：host routes 仅接受 loopback 请求；API key 不发送到前端或写入日志。
- 主题感知：使用 DSH theme tokens，跟随 light/dark 模式。
- 可扩展：按 README 在宿主侧
PROVIDERS（或BALANCE_PROVIDERS/USAGE_PROVIDERS）中添加条目，UI 自动渲染对应表单。
安装与启用¶
安装命令如下：
dsh plugin --profile web add https://github.com/Badegg404/dsh-api-balance.git
这条命令用于 web profile，把插件加入 DSH 后，打开会话即可在标题栏看到入口。
典型用法¶
1、打开会话后，标题栏出现悬浮 pill，位于 Session log 按钮左侧。
2、在 Balance（余额）tab 选择余额 provider，粘贴 API key（AGICTO 还需 account UUID），保存后显示余额并每 30s 自动刷新。
3、在 Usage（用量）tab 选择 usage provider（例如 OpenAI），粘贴 API key 并保存，显示近 30 天费用（或智谱的 token 配额），同样自动刷新。
4、可在 UI 中手动 Refresh、Clear 或重新选择 provider。
适用场景与注意¶
适合经常调用多个 AI 供应商、希望在一个 DSH 会话界面查看账户余额和用量的开发者。
使用前注意：
- 插件会以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- provider endpoints 可能上游变化；如果某 provider 解析失败，需查阅官方文档。
- AGICTO 需要额外参数 account UUID。
- 凭证保存在
~/.dsh/.credentials.yaml（mode 0600）。 - host routes 仅接受 loopback 请求；API key 不会发送到前端或写入日志。
结尾¶
dsh-api-balance 把多平台余额和用量查看收拢到 DSH 会话标题栏，减少在多个控制台之间切换的成本。
GitHub：https://github.com/Badegg404/dsh-api-balance
相关目录页（社区站点，链接来自插件线索）：https://www.skillhub.cn/plugins/Badegg404/dsh-api-balance
