DSH 提供插件擴展能力。在智能體開發或調試過程中，需要實時掌握 DeepSeek 賬戶的剩餘額度。dsh-balance 插件將餘額信息直接嵌入輸入框工具行（模型選擇器旁），無需切換頁面即可查看。
插件說明¶
- 項目名稱：
wyxcn445/dsh-balance - 維護者：Wyxcn445
- 許可證：MIT
核心功能¶
- 餘額膠囊：在輸入框工具行顯示主錢包餘額（優先顯示人民幣），附帶狀態色點。
- 明細麪板：點擊膠囊展開面板，查看充值餘額（各幣種）、贈送額度、用量明細、去充值入口及最近更新時間。
- 自動刷新：每 20 秒自動刷新；標籤頁重新可見時立即刷新；打開面板時強制刷新。
- 降級處理：未登錄、服務缺失或查詢失敗時，顯示可讀提示，不會導致輸入框報錯。
數據來源與安全¶
- 鏈路設計：瀏覽器端不直接訪問平臺接口。賬戶憑證只在宿主側可見。
- 請求路由：通過宿主端註冊的只讀路由
GET /api/dsh-balance獲取數據。 - 訪問限制：該路由僅接受來自迴環地址（127.0.0.1 / ::1）的請求。
- 鑑權機制：該路由未走 DSH 的令牌鑑權，僅靠迴環限制。
- 性能說明：餘額查詢屬於外部網絡請求，首次加載可能有短暫延遲。
前置條件¶
本插件讀取的是 DSH 內置 deepseekAccount 服務的賬戶數據。
已在 DSH 中登錄 DeepSeek 賬號（平臺會話）。只配置了
DEEPSEEK_API_KEY但未在 DSH 裏登錄賬號的用戶，膠囊會顯示「餘額未登錄」。
安裝與啓用¶
dsh plugin --profile <你的profile名> add github:Wyxcn445/dsh-balance
安裝後刷新瀏覽器頁面即可看到餘額膠囊。
使用¶
- 無需配置：接口爲只讀，無需任何配置項。
- 查看餘額：刷新頁面後，在輸入框工具行（模型選擇器旁）查看餘額膠囊。
- 查看明細：點擊膠囊展開面板，查看詳細的充值、贈送及用量信息。
注意事項¶
- 憑證安全：瀏覽器端不直接訪問平臺接口，憑證只在宿主側可見。
- 網絡請求：餘額查詢屬於外部網絡請求，首次加載可能有短暫延遲。
- 訪問範圍：僅接受來自迴環地址（127.0.0.1 / ::1）的請求。
- 鑑權方式：該路由未走 DSH 的令牌鑑權，僅靠迴環限制。
