DeepSeek Harness 插件：在左側邊欄顯示 Sub2API 的餘額與用量詳情

DeepSeek Harness (DSH) 採用“一切皆插件”的架構。dsh-sub2api-usage 插件將 Sub2API 的餘額和用量信息集成到 DSH 的左側邊欄中，無需在瀏覽器中打開站點即可查看。它支持多種查詢模式，且所有請求由宿主進程發出，站點無需配置 CORS。

功能概覽¶

該插件在左側邊欄提供常駐的餘額小條，點擊可打開包含詳細數據的面板。

1. 側邊欄展示：在左側邊欄底部顯示餘額摘要（如 $12.34 用量），帶狀態圓點。餘額低於閾值時顯示黃點，未配置時顯示紅點。
2. 詳細麪板：點開小條或圖標可查看完整用量面板，包括錢包餘額、剩餘額度、訂閱週期、按小時/按天用量趨勢折線圖、模型用量及限流窗口。
3. 自定義接口：查詢接口的每一部分（服務地址、模式、路徑、JSON 指針）均可自定義。
4. 查詢模式：支持多種認證方式，包括站點 Key、管理員 Key、賬號密碼登錄以及完全自定義的請求。
5. 數據可視化與導出：支持按小時或按天切換趨勢圖，支持導出 CSV 或 JSON 數據。
6. 實時刷新：後臺按間隔自動刷新余額（默認 120 秒）。

安裝與前置條件¶

前置條件：
* DeepSeek Harness (DSH) 環境，且命令行中包含 dsh。
* Node.js 版本 ≥ 18。

安裝：

dsh plugin --profile desktop add github:aming1029/dsh-sub2api-usage

安裝完成後，插件管理器會即時生效，無需重啓應用。

配置與使用¶

1. 打開 DSH 客戶端，在側邊欄底部找到餘額小條或圖標區的「Sub2API 用量」。
2. 點擊進入面板，切換到「設置」選項卡。
3. 在「查詢接口」部分配置服務地址和憑證。
4. 選擇合適的查詢模式並保存，點擊「測試連接」可驗證配置是否正確。

支持的查詢模式：
* 站點 Key：適用於查詢特定 Key 的餘額和用量。
* 管理員：使用管理員 API Key，可查詢指定用戶或用戶列表的餘額、凍結餘額、充值總額等。
* 賬號密碼：使用郵箱和密碼登錄，查詢當前登錄賬號的信息。
* 自定義請求：手動指定請求方法、路徑、請求頭和請求體。

高級特性與注意事項¶

• 小時數據採樣：對於僅返回按天數據的接口，插件會利用後臺採樣邏輯在本地計算小時級用量，保留最近 14 天數據。
• 宿主發起請求：所有對上游站點的請求均由 DSH 的宿主進程（Node.js 側）發出，頁面端不會直接請求站點接口。這意味着站點無需開啓 CORS，且憑證不會出現在頁面代碼中。
• 配置持久化：設置項（包括刷新間隔、默認視圖、統計區間等）會保存到配置文件中。

結語¶

該插件爲使用 Sub2API 的開發者提供了一個集成在 DeepSeek Harness 中的實時監控面板。所有功能均由宿主側處理，保障了數據獲取的穩定性和隱私安全。

• GitHub 倉庫：https://github.com/aming1029/dsh-sub2api-usage
• 插件目錄：https://www.skillhub.cn/plugins/aming1029/dsh-sub2api-usage