前言¶
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
