DeepSeek Harness (DSH) 採用插件化架構，dsh-sophnet-balance 是其中一款用於 SophNet 餘額查詢的插件。它針對在 DSH Web GUI 中開發或調試智能體時需要實時監控額度與用量的場景，提供內嵌式的狀態展示與數據查詢功能。
插件定位¶
該插件由 caijiachen34 維護，採用 MIT 許可證。其核心作用是在 DSH Web 界面中集成 SophNet 的賬戶數據查詢能力，使開發者無需離開當前工作流即可查看餘額、充值狀態、信用額度及歷史用量。
核心功能¶
- 輸入框狀態指示：在輸入框右側顯示一個呼吸燈圓點，實時反映 SophNet 餘額狀態（綠色 = 正常，黃色 = 偏低，紅色 = 餘額不足或無餘額）。
- 液態玻璃面板：點擊圓點展開面板。頂部展示總餘額及狀態徽標，下方列出充值/贈送/信用額度/當前欠款/提醒閾值的明細。面板主體爲用量視圖，包含 Token 總量、請求量、費用匯總，支持按服務或按日期查看明細，默認查詢近 30 天。
- 自動啓用機制：插件通過宿主端檢測當前模型提供商，僅在使用
sophnet提供商（包括modlens-sophnet等包裝名）時才顯示控件；切換走其他提供商後控件自動隱藏。 - 衝突處理：同一輸入框內會自動隱藏
opencodego查詢插件的呼吸燈，避免視覺干擾。
安裝¶
使用 dsh plugin 命令安裝，指定 profile 爲 web：
dsh plugin --profile web add github:caijiachen34/dsh-sophnet-balance
安裝完成後需要重啓 dsh web，以使新增的客戶端模塊進入瀏覽器清單。
典型用法¶
1. 配置 API Key¶
插件會優先讀取 SOPHNET_API_KEY 環境變量（該變量通常由 DSH 的 LLM 提供商配置複用）。若未配置，可在面板內手動輸入，Key 會緩存至 ~/.dsh/.sophnet-state.json。
2. 查看餘額¶
切換到 sophnet 提供商後，輸入框右側呼吸燈即顯示狀態。點擊圓點展開面板查看詳細餘額信息。
3. 查詢用量¶
面板默認顯示近 30 天的用量明細。可在面板內選擇起止日期進行查詢。面板展示按服務、按日期的 Token 統計及費用詳情。
注意事項與限制¶
- 提供商依賴：插件必須在使用 sophnet 提供商時纔會顯示，切換走其他提供商後控件會自動隱藏。
- 數據延遲：用量統計存在延遲。如果查詢的時間窗口內沒有調用記錄，統計數據可能全爲 0。
- API 結構差異：官方文檔與實測返回結構存在差異（例如
services字段在文檔中爲單數，實測爲複數），插件已做兼容處理。文檔未列出creditLimit/currentDebt等字段，但實測接口會返回，插件會據此顯示信用額度與欠款行。 - 開發調試：如需本地開發調試，可在插件源碼目錄外執行
dsh plugin --profile web add file:/絕對/路徑/dsh-sophnet-balance。
結語¶
對於使用 SophNet 作爲模型提供商的開發者，dsh-sophnet-balance 提供了便捷的本地餘額與用量監控入口。源碼託管在 GitHub，可供進一步查閱或貢獻。
