前言¶
DeepSeek Harness (DSH) 的理念是“一切皆插件”。在本地或通過 API 開發智能體時，實時掌握 OpenCode Zen 餘額和 Go 使用窗口是必要的。dsh-opencode-usage 是一個 Web GUI 插件，它將 OpenCode Zen 餘額和 Go 使用窗口直接顯示在 composer 工具行中，通過一個同心圓按鈕即可查看 5 小時/每週/每月的滾動使用情況。
插件定位¶
- 插件名：
dsh-opencode-usage - 維護者：
zzh799 - 核心價值：在 DSH Web 界面中，通過 composer 工具行查看 OpenCode Zen 餘額和 Go 使用窗口。
核心功能¶
插件主要提供以下能力：
- 環形圖展示：在 composer 按鈕上展示滾動 5 小時、每週、每月的使用窗口。
- 使用面板：點擊按鈕打開面板，顯示窗口詳情，支持手動刷新。
- 內置配置編輯：面板內提供配置編輯器，僅掩碼顯示 cookie 尾部，全量 cookie 不會離開主機。
- 智能 Cookie 規範化：支持粘貼原始 auth token、完整 header 或中間任意內容。
- 防刷機制：內置服務器端緩存（默認 5 分鐘）和 60 秒故障冷卻，避免頻繁請求 opencode.ai。
- 可選峯值時鐘：支持通過配置開啓
showPeakClock顯示。
安裝與啓用¶
插件需要 DSH 的 webServer 服務。
dsh plugin --profile web add /path/to/dsh-opencode-usage
配置說明¶
配置優先級爲：環境變量 > 配置文件 ($DSH_HOME/ocgo-usage.json) > 默認值。
環境變量與配置項¶
| 環境變量 | 配置文件鍵 | 默認值 | 描述 |
|---|---|---|---|
OPENCODE_GO_COOKIE |
cookie |
— | OpenCode Go 會話 cookie (自動規範化) |
OPENCODE_GO_WORKSPACE_ID |
workspaceID |
— | OpenCode workspace id |
OPENCODE_GO_BASE_URL |
baseUrl |
https://opencode.ai |
Provider 基礎 URL |
OPENCODE_GO_CACHE_TTL |
cacheTTL |
300 |
緩存時間，限制在 [60, 3600] 秒 |
OPENCODE_GO_TIMEOUT_MS |
timeoutMs |
15000 |
請求超時時間 |
| — | showPeakClock |
false |
是否顯示峯值時鐘 |
安全與權限¶
- Cookie 安全：Cookie 永遠不會被記錄或日誌化。
- 文件權限：配置文件寫入時使用
chmod 600。
API 使用¶
插件提供同源 JSON 接口供調用：
* GET /api/opencode-usage：獲取緩存的使用視圖。
* GET /api/opencode-usage/refresh：強制發起一次新的 provider 查詢。
* GET /api/opencode-usage/config：獲取掩碼後的配置視圖。
* POST /api/opencode-usage/config：寫入 cookie / workspace / showPeakClock。寫入成功後立即失效緩存。
適用場景與注意事項¶
- 該插件以當前 DSH 進程的權限運行，請確保在安裝前檢查源碼與許可證。
- 插件依賴
webServer服務，若未啓用 Web 界面，該插件無法工作。
結語¶
通過該插件，開發者可以在 DSH 的 Web 界面中直觀地查看 OpenCode 資源消耗情況，無需切換頁面或通過外部工具查詢。更多細節請參考 GitHub 倉庫。
