DSH（DeepSeek Harness）提供了一個統一的對話與管理界面，但在實際使用中，開發者往往需要同時對接 DeepSeek、智譜、Moonshot 等多個服務商。頻繁切換到各個平臺查看餘額或配額會打斷工作流。
dsh-ai-wallet 插件在 DSH 界面右下角提供了一個可拖動的懸浮球，實時聚合顯示當前對話模型對應的餘額/配額，點擊展開即可查看所有已配置供應商的金額餘額或配額餘量。
核心功能¶
懸浮球與面板是插件的主要交互形式。懸浮球固定在界面任意位置，支持自由拖動，位置會自動記憶。
球面會實時顯示當前對話正在使用的模型對應的餘額/配額（數據基於最近一次模型調用推斷，每 60 秒自動刷新）。點擊球體或遮罩層可展開完整的餘額面板。
面板提供以下能力：
- 一屏查看所有已配置供應商的金額餘額或配額餘量。
- 對於配額型供應商，展示進度條與重置時間。
- 支持手動刷新，並對未配置 Key 或 API 錯誤提供友好提示。
插件內置 8 套主題（包括液態玻璃、淺色玻璃、賽博青、Dracula 等），可在面板底部一鍵切換。主題與懸浮球的位置會持久化保存到服務端文件（~/.dsh/dsh-ai-wallet.prefs.json），不隨 DSH 端口變化丟失。
安裝與啓用¶
通過命令行安裝插件。安裝後需重啓 DSH 才能生效。
dsh plugin --profile desktop add dsh-ai-wallet
配置與使用¶
默認情況下，插件會啓用 deepseek 和 zhipu 兩個供應商。在 profile 的 cordis.patch.yml 中覆蓋配置，可以調整面板展示順序或啓用特定供應商。
- id: dsh-ai-wallet
config:
providers:
- deepseek
- moonshot
- zhipu
providers 數組中的順序決定了面板上各供應商的排列順序。
自定義供應商接入¶
對於不在內置白名單中的供應商，或者使用私有端點的供應商，可通過 config.customProviders 聲明式接入，無需修改源碼。支持 quota（進度條）與 balance（金額行）兩種類型，鑑權方式支持 bearer（默認）與 cookie。
- id: dsh-ai-wallet
config:
providers:
- deepseek
- my-gateway
customProviders:
- id: my-gateway
name: 內部網關
kind: quota
url: https://your-gateway.example.com/api/profile/quota
auth: cookie
keyNames: [GATEWAY_COOKIE]
fields:
level: data.status
limits:
label: 月度配額
remaining: data.remainingCny
total: data.limitCny
percentage: data.utilizationPercent
resetTime: data.period.resetsAt
支持的供應商¶
插件內置支持以下供應商的餘額查詢：
- DeepSeek
- 智譜 GLM (Zhipu)
- Z.ai (GLM 國際)
- Moonshot (Kimi)
- MiniMax
- StepFun (階躍星辰)
- SiliconFlow (硅基流動)
- OpenRouter
- xAI (Grok)
注意事項¶
- xAI 限制：
xai供應商使用的是社區維護的非官方 credits 端點。由於 xAI 預付費 credits 沒有公開 API，若該社區端點失效，面板會顯示錯誤。 - 不支持查詢的供應商：僅控制台查詢、無公開餘額 API 的供應商（如通義千問、百川、Groq）暫不支持。OpenAI 和 Anthropic 的普通 Key 也不支持用量查詢，故未內置。
- 權限與安全：插件以 DSH 進程權限運行。安裝前建議檢查源碼與許可證（MIT）。
總結¶
dsh-ai-wallet 通過懸浮球與面板的形式，將多供應商的餘額與配額查詢集中在 DSH 界面內。開發者無需離開當前工作流即可監控資源使用情況，適合需要同時管理多個 AI 服務賬戶的場景。
