前言¶
在 DeepSeek Harness 裏切換多個模型 Provider 時，餘額往往分散在各自控制台或文檔接口裏。要確認 DeepSeek 登錄賬戶、官方 API Key、OpenRouter、SiliconFlow 等是否還有額度，通常需要離開 Harness 或另開頁面查詢。下面介紹社區插件 DSH Balance（@pipilu123566/dsh-balance）：在桌面/Web 側欄底部賬戶區域上方增加錢包入口，把已在 Harness 中配置的 Provider 餘額彙總展示，並支持按需刷新。
這是什麼¶
DSH Balance 是由維護者 pipilu123566 開發的 非官方 DeepSeek Harness 客戶端插件（MIT）。它在側欄佔用公開的 sidebar.footer.action 插槽，在賬戶按鈕上方單獨佔一行，不改動 Harness 核心設置流程；Provider 仍按 Harness 原有方式配置。
源碼持續開發已遷移至集合倉庫 deepseek-harness-plugin/dsh-balance；pipilu123566/dsh-balance 保留已發佈的 1.0.0 發行包、校驗和與固定版本引用。插件目錄頁：SkillHub - dsh-balance。
核心功能¶
根據 README 說明，插件當前能力包括：
- 側欄交互：懸停或聚焦錢包按鈕可展開餘額；點擊可固定面板。
- 多源彙總：在同一處查看 DeepSeek 登錄賬戶、DeepSeek API、OpenRouter、SiliconFlow 的配置與餘額（各 Provider 幣種與錢包類別分開顯示，不做貨幣換算或 token 估算）。
- 刷新策略：支持手動刷新；面板打開時約每分鐘自動刷新一次，關閉後停止輪詢。
- 錯誤呈現：缺少憑證、不支持的 Provider、限流與請求錯誤會明確展示，不會顯示爲「零餘額」。
各 Provider 數據來源與要求（節選）：
| Provider | 數據來源 | 說明 |
|---|---|---|
| DeepSeek 登錄賬戶 | Harness 賬戶服務 | 需在 Harness 內登錄；充值與贈送錢包分開展示 |
| DeepSeek API | 官方 /user/balance |
需配置官方 API Key |
| OpenRouter | 官方 /api/v1/credits |
需 Management Key；普通 Key 可能被拒絕 |
| SiliconFlow | 官方 /v1/user/info |
需爲 api.siliconflow.cn 配置的 Key；餘額爲 CNY |
| 其他已配置 Provider | 不發起推測性請求 | 標記爲不支持；未配置的目錄項不顯示 |
插件僅將各 Provider 的憑證發往對應的 HTTPS 白名單端點；拒絕自定義代理、非標準端口、URL 內嵌憑證與重定向請求。密鑰留在本機，不增加獨立後端或分析上報。
兼容性¶
1.0.0 面向 DeepSeek Harness 0.2.1-rc.5；README 未聲明更高 Harness 版本的兼容性。發行驗證在 macOS 上於隔離的 Harness Web Profile 中進行，詳見倉庫 validation。自動化測試不包含真實 DeepSeek API Key、OpenRouter 與 SiliconFlow 憑證。
安裝與啓用¶
安裝必須使用 Release 中的可安裝包 pipilu123566-dsh-balance-1.0.0.tgz，而非 GitHub 自動生成的源碼歸檔。
- 從 v1.0.0 Release 下載上述 tgz 到本地目錄。
- 完全退出 Harness 後再修改 desktop profile。在下載目錄執行：
dsh plugin --profile desktop add ./pipilu123566-dsh-balance-1.0.0.tgz --ignore-scripts
- 重新打開 Harness。在側欄底部賬戶區域上方應出現錢包按鈕；按 Harness 常規設置配置 Provider 即可。
macOS 上若 dsh 不在 PATH，可使用應用內置 CLI：
'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' plugin --profile desktop add ./pipilu123566-dsh-balance-1.0.0.tgz --ignore-scripts
若使用 Web profile，將命令中的 desktop 換爲該 profile 名稱，並在更換包前後停止/重啓對應實例。每個 profile 只應安裝一份 balance 包。升級時用新版本 tgz 重複上述步驟；不要自行擴大 README 聲明的 Harness 兼容範圍。
卸載：退出目標實例後執行：
dsh plugin --profile desktop remove @pipilu123566/dsh-balance
再重新打開 Harness。
典型用法¶
安裝並完成 Provider 配置後：
- 將指針移到側欄底部的錢包按鈕，或使其獲得焦點，查看各 Provider 餘額摘要。
- 需要固定查看時，點擊錢包按鈕釘住面板。
- 面板內使用刷新操作更新數據；面板保持打開時會約每分鐘自動刷新，關閉面板後輪詢停止。
README 中的演示截圖使用隔離 Harness 實例中的演示數據，不代表真實賬戶或實時 Provider 查詢結果。
適用場景與注意¶
適合：在 Harness 內頻繁切換 DeepSeek 登錄、DeepSeek API、OpenRouter、SiliconFlow 等 Provider，希望在側欄快速覈對餘額與錯誤狀態的用戶。
注意：
- 插件以當前 Harness /
dsh進程權限運行，會向已配置的 Provider 官方端點發起 HTTPS 請求。安裝前請閱讀 源碼與 MIT 許可證，並自行評估風險。 - 社區插件與 DeepSeek / 幻方無隸屬或背書關係；SkillHub 等目錄站點亦爲社區生態，並非官方應用商店。
- OpenRouter 需 Management Key；SiliconFlow 餘額爲人民幣；未支持的 Provider 不會假裝有餘額。
問題反饋可提交至集合倉庫 Issues。
結尾¶
DSH Balance 把多 Provider 餘額收攏到 Harness 側欄，減少離開客戶端查賬的步驟。獲取插件與 1.0.0 安裝包見 GitHub 倉庫 與 SkillHub 目錄頁。
