前言¶
在 DeepSeek Harness (DSH) 的開發場景中，開發者通常需要在多個 AI 服務提供商之間切換，管理各自的訂閱配額。手動查看不同服務的剩餘額度往往打斷工作流。dsh-subscription-overlay 插件旨在解決這一問題，它通過一個可切換的 Web 覆蓋層，聚合了 Claude、Codex 和 OpenCode Go 的實時配額，同時針對沒有公開配額接口的 CommandCode 進行本地可用性探測和消耗記錄。
插件簡介¶
這是一個由 ajceee 維護的 DSH Web 插件，遵循 MIT 許可證。它通過 DSH 的 Web 插件機制注入界面，提供懸浮窗和設置面板，用於統一展示服務狀態和本地消耗數據。
核心功能¶
1. 訂閱額度聚合與展示¶
插件聚合了四個提供商的數據：
* Claude、Codex、OpenCode Go：顯示實時使用情況條和重置時間。
* CommandCode：由於該服務沒有配額端點，插件僅顯示探測狀態（在線/離線 + 延遲）和本地消耗記錄，不會生成虛構的百分比條。
2. 浮層與交互¶
- 懸浮窗：默認顯示爲可拖拽的“藥丸”或“圓環”模式，帶有未讀或狀態變化的徽章。
- 熱鍵切換：使用
Ctrl+Shift+S可隱藏或顯示浮層。 - 面板操作：點擊浮層可打開 4 提供商面板，點擊刷新按鈕可強制重新獲取數據。
3. 本地消耗追蹤¶
提供本地月度消耗賬本，記錄已使用的 Token 數量，並支持設置月度預算（以 Token 爲單位）。當預算大於 0 時，會計算並顯示預算佔用百分比。
4. 設置與控制¶
- 全局與單項開關：支持獨立開關每個提供商的數據展示。
- 輪詢與告警：設置輪詢間隔（1-60 分鐘）和告警閾值（1-100%）。
- HTTP API：提供同源 API 接口，支持通過 POST 請求進行狀態刷新、CommandCode 探測、設置更新及賬本追加。
安裝與配置¶
前置要求：
* DSH 版本 0.1.5-rc.1 或更高。
* Node.js 版本 20+。
安裝步驟：
1. 克隆或獲取插件源碼到本地目錄（例如 C:/Projects/dsh-subscription-overlay）。
2. 執行以下命令安裝插件：
dsh plugin --profile web add C:/Projects/dsh-subscription-overlay
- 重要：安裝後必須重啓 DSH Web 進程，以使
bundle-list更改生效。
使用方式¶
- 顯示/隱藏：安裝成功後，右下角會出現訂閱額度浮層。按下
Ctrl+Shift+S可快速切換其顯示狀態。 - 查看詳情：點擊浮層打開面板，查看各服務的具體剩餘額度。
- 刷新數據：點擊浮層或面板內的刷新按鈕，可強制重新從 OAuth/Session 源獲取數據。
- CommandCode 探測：在 CommandCode 卡片中，點擊“探測”按鈕重新檢查服務的可用性。
- 管理消耗：在設置中配置月度預算，或查看“本月消耗”面板以瞭解月度累計 Token 使用量。
注意事項¶
- CommandCode 限制：該服務無配額端點，面板僅展示探測結果和本地記錄，不顯示百分比（除非設置了月度預算）。
- 憑證管理：插件不會在設置中存儲 API Key，所有憑據通過 DSH 的憑證域解析，並支持環境變量或會話文件作爲回退。
- 權限與重啓：插件以當前 DSH 進程的權限運行，請確保安裝前已檢查源碼與許可證。安裝後務必重啓服務以加載新插件。
