前言¶
DeepSeek Harness (DSH) 採用“一切皆插件”的設計理念。在使用 Web 界面進行開發時，監控 API 賬戶餘額通常需要切換標籤頁或查看命令行輸出，這會打斷工作流。dsh-account-balance 插件將餘額信息直接集成到聊天界面中，讓開發者能實時掌握賬戶狀態。
插件介紹¶
這是一個運行在 DSH Web 客戶端上的儀表盤插件，由用戶 ls-cool-123 維護。它能在聊天窗口上方（會話頭部的工具區）顯示 DeepSeek 模型的賬戶餘額，解決從界面層直接查詢餘額的需求。
核心功能¶
該插件通過 Host 與 Client 兩個半部分協作，實現餘額的實時查詢與展示：
- 實時顯示：在聊天窗口上方（會話頭部的工具區）顯示餘額膠囊。
- 數據明細：鼠標懸停可查看「總餘額 / 贈送餘額 / 充值餘額」的明細。
- 自動刷新：支持手動刷新，且每 60 秒自動刷新一次。
- 架構實現：
- Host 半：在 Web 服務器上註冊本地路由
/api/account-balance。它解析憑證服務（ctx.credentials）中的 API Key，代理 DeepSeek 官方GET /user/balance接口。 - Client 半：在
conversation.session.header.utilities槽位註冊組件，負責輪詢接口並渲染 UI。
- Host 半：在 Web 服務器上註冊本地路由
- 安全機制：API Key 只留在本機進程裏，絕不暴露給瀏覽器。
安裝與啓用¶
- 進入插件所在目錄。
- 運行安裝命令，將插件添加到 Web 服務的依賴中：
dsh plugin --profile web add .
- 重啓 Web 服務以加載插件：
dsh web
配置¶
插件複用 DeepSeek 官方適配器的憑證來源，無需額外配置。
- 憑證來源：使用 Web 模型設置頁寫入的託管憑證、
.env文件或環境變量中的DEEPSEEK_API_KEY。 - 可選配置：
DEEPSEEK_BASE_URL，用於覆蓋餘額接口基地址，默認爲https://api.deepseek.com。 - 接口格式：餘額接口返回格式以 DeepSeek 官方文檔 爲準。
