前言¶
用 DeepSeek Harness(DSH)跑 OpenCode Go 訂閱的用戶,最常遇到的兩個問題是:額度用到哪了、按當前消耗速度還能撐多久。OpenCode 的 API 只給出一個歸一化百分比,沒有現成的界面;去 Console 網站看又要切窗口、手動算窗口重置時間。這個插件把訂閱狀態、額度計量和模型單價直接做成 DSH 側欄面板,數據全部來自 OpenCode Go 的接口。
下面介紹 Wiselfx/dsh-opencode-go-panel。它是一個 DSH 客戶端插件,面向使用 OpenCode Go 訂閱、希望在 DSH 側欄裏直接看用量的開發者。插件本身不計算、不存儲額度,只做讀取、歸一化和展示。
核心功能¶
面板展示四類信息,全部從 OpenCode Go API 讀取:
- 訂閱與套餐狀態:來自 OpenCode Console 狀態接口,包括 plan、price、workspace、續訂或結束日期、取消狀態、升級價格、是否開啓額外用量。
- 統一的額度計量條:覆蓋 5 小時、每週、每月三個窗口,顯示已用與剩餘美元、百分比、重置倒計時和消耗速度。
- 基準美元額度模型:以最大單模型上限爲基準(Go 爲 $100),小上限模型按比例更快消耗基準額度。
模型額度與消耗倍率表如下(來自 README):
| 模型 | 月度上限 | 消耗倍率 |
|---|---|---|
| DeepSeek V4.1 Flash | $100 | 1.00× |
| GLM-5.3-Flash | $60 | 1.67× |
| MiniMax M3.1 Flash | $20 | 5.00× |
| Kimi K3 | $15 | 6.67× |
混合使用只需要這一條基準計量條,因爲 OpenCode API 返回的百分比已經是混合總額。表格中每行的「剩餘額度」表示該模型單獨使用時的情形。
- 每百萬 token 定價:來自需要認證的 OpenCode Go 模型接口,包含 input、output、cache read、context、max output 以及模型標籤。
安裝與啓用¶
如果你已有本地 checkout,用 Plugin Manager 直接安裝 bundle:
plugin_manager install_bundle target=/absolute/path/to/dsh-opencode-go-panel
另一種方式是從 GitHub 倉庫通過 Harness Plugin Manager 安裝 bundle package,然後啓用它。首次安裝客戶端 bundle 後需要刷新頁面纔會生效。
關鍵詞配置不做額外拼接。倉庫實際上就是一個 bundle:package.json 中的 dsh.bundle.patch 指向 ./cordis.patch.yml,dsh.client 聲明瞭 platform: web、immediately: true,並注入 @deepseek-ai/dsh-client-ui-layout。
憑證獲取順序¶
Host 端按以下順序解析憑證:
- Harness credential store(
OPENCODE_GO_API_KEY) - 環境中的
OPENCODE_GO_API_KEY、OPENCODE_API_KEY、OPENCODE_ZEN_API_KEY - 插件自己的
~/.dsh/opencode-go/api-key文件 ~/.pi/agent/auth.json(opencode-go)~/.local/share/opencode/auth.json(opencode)
沒有找到 key 時,面板會顯示 connect 卡片,粘貼的 key 會存入 Harness credential store。
精確的 Console 計費數據還需要本地 OpenCode Console 登錄(~/.local/share/opencode/opencode.db);沒有它時,面板退回到百分比用量接口。也就是說,不登錄 Console 也能看用量比例,但看不到精確賬單金額。
典型用法¶
安裝並配好憑證後,打開 DSH 客戶端側欄即可看到圖標和麪板。
面板分兩層:Host 端負責路由和同源校驗(index.js),以及 API、憑證、額度和模型的歸一化(data.js);Client 端負責側欄圖標和麪板 UI(client.js)。憑證需要從面板粘貼時,直接用 connect 卡片輸入;已有 OpenCode 登錄態時無需額外操作。
想確認數據來源時,把面板顯示的百分比和 Console 網頁上的數字對一下即可。兩者應該一致,因爲面板不重算,只讀接口。
適用場景與注意¶
適合兩類人:
- 用 OpenCode Go 訂閱、希望在 DSH 裏直接看套餐狀態和剩餘額度的開發者。
- 需要比較不同模型的月度上限與消耗倍率、決定主力模型的人。
需要知道的幾點限制:
- OpenCode 只暴露一個覆蓋所有模型的歸一化百分比,沒有按模型的花費或 token 總量。插件不會從本地 session 日誌重建 token。
- 每模型上限是 OpenCode 公佈的 Go 額度,狀態接口並不返回,插件用的是公佈的表。
- 輸入、輸出、緩存讀單價和可用模型列表來自 OpenCode Go 模型 API。
- 插件以當前 DSH 進程的權限運行。安裝前應檢查源碼和許可證(MIT),確認
index.js、data.js、client.js與cordis.patch.yml的內容符合你的預期。 - 該插件由 Wiselfx 維護,GitHub 目前 1 星,版本 1.1.1。生態裏的社區目錄屬於獨立站點,與 DeepSeek / 幻方沒有官方從屬關係。
結尾¶
這個插件的價值在於把分散在 OpenCode Console 和模型接口裏的信息收斂到一個側欄面板:訂閱狀態、三窗口額度、各模型的消耗倍率和每百萬 token 單價。它不做本地估算,也不替代 Console,適合希望用量可見、又不想另開網頁的 OpenCode Go 訂閱用戶。
目錄頁:https://www.skillhub.cn/plugins/Wiselfx/dsh-opencode-go-panel
GitHub:https://github.com/Wiselfx/dsh-opencode-go-panel