前言¶

在 DeepSeek Harness（DSH）裏用 OpenCode Go 跑會話時，配額還剩多少、單次請求花了多少錢、不同模型各佔多少，往往要切到瀏覽器裏的 opencode.ai 用量頁才能看清。DSH 自身的事件流能反映本機會話，但和官網賬戶級明細、滾動配額不是同一套視圖。

下面介紹社區插件 xenia0922/dsh-opencode-go-usage：在 DSH 桌面右下角掛一個可拖動、可縮放的懸浮面板，把官方 usage.list 與 DSH 會話分析放在同一處查看。

這是什麼¶

dsh-opencode-go-usage 由維護者 Xenia0922 發佈，分類爲客戶端插件，當前版本 v1.7.1，MIT 許可證，支持 Windows、macOS、Linux。

它解決的核心問題是：在 DSH 工作區內直接查看 OpenCode Go 的賬戶級用量、配額、逐請求花費，以及按 DSH 會話、模型、日期聚合的本地統計。數據在本機處理；網絡請求只發往 opencode.ai，以及用於版本檢查的 GitHub 公共 package.json，不會把 API key、Cookie 或用量數據發給第三方。

• 目錄頁：https://www.skillhub.cn/plugins/Xenia0922/dsh-opencode-go-usage
• 源碼：https://github.com/Xenia0922/dsh-opencode-go-usage

核心功能¶

官方賬戶級用量¶

讀取官網 usage.list，使用官方逐請求費用，支持跨設備數據。憑據通過本地配置中的 authCookie 與 workspaceId 提供。

DSH 會話分析¶

只統計 source.provider == "opencode-go" 的事件；deepseek 直連等其他 provider 不計入。插件按相鄰事件計算 cache token 增量，避免重複累計；金額先按內置模型價格估算，再嘗試與官方逐請求記錄匹配。

配額監控¶

顯示滾動 5 小時、周、月配額、重置時間和消耗速度預測。支持從 $DSH_HOME/.credentials.yaml 自動發現 OPENCODE_GO_KEY_*，可切換 key 並提示限流狀態。

交互面板與數據分析¶

FAB 可拖動；面板支持標題欄拖動、邊緣縮放、最大化，位置和大小寫入瀏覽器 localStorage。可按模型排行、費用分項查看 7/14/30 天趨勢、最近會話，並導出 CSV。界面支持中英文，可手動切換或跟隨 DSH 全局語言。

安裝與啓用¶

插件以當前 DSH 進程權限運行，安裝前建議閱讀源碼與 MIT 許可證。

推薦：Bundle 插件¶

在插件倉庫的父目錄執行：

git clone https://github.com/Xenia0922/dsh-opencode-go-usage.git
dsh plugin --profile my-profile add ./dsh-opencode-go-usage
dsh --profile my-profile

Bundle 模式會隨 DSH profile 啓動，並通過本地 webServer 註冊路由 /ocgo-usage/fetch、/ocgo-usage/config、/ocgo-usage/retry。若插件目錄路徑含空格導致 dsh plugin add 解析失敗，請移到無空格路徑，或用 junction/link 指向無空格目錄。

快速體驗：動態加載¶

動態加載不需要構建，但只在當前 DSH 進程有效：

1. 在 DSH 會話中讓 Agent 執行 cordis_define，kind: new，idPrefix: zenus。
2. 將 src/host.js 內容填入 code.host。
3. 將 src/client.js 內容填入 code.client。
4. 執行 cordis_run 並授權。

DSH 重啓後動態定義會消失；長期使用請用 Bundle 模式。

典型用法¶

首次配置官方視圖¶

安裝後右下角會出現 OpenCode Go FAB。官方視圖採用一次性手動憑據配置：

1. 在普通瀏覽器打開 opencode.ai 的 usage 頁面並確認已登錄。
2. 按 F12（或 Ctrl+Shift+I）打開開發者工具，進入 Application/應用 → Storage/存儲 → Cookies → https://opencode.ai。
3. 找到名稱爲 auth 的 Cookie，只複製 Value/值 一欄（不要帶 auth= 前綴或整條 Cookie: 頭）。
4. 從地址欄形如 https://opencode.ai/workspace/wrk_123/usage 的 URL 中，只複製 wrk_123 作爲 workspaceId。
5. 在面板兩個輸入框分別填入上述兩項，點擊「保存並刷新」。

配置保存在本機：

~/.config/dsh-opencode-go-usage.json

憑據保存後，後續刷新不需要再次登錄，也不依賴調試模式啓動瀏覽器。

面板區域與常用操作¶

點擊 FAB 打開或關閉面板；拖動標題欄移動面板，拖動右緣、底緣或右下角調整大小；雙擊標題欄最大化或還原；標題欄按鈕可切換語言、導出 CSV、手動刷新。官方明細首次全量抓取通常需 15–60 秒，後續增量更快；點擊「重試提取」會繞過緩存重新抓取。

適用場景與注意¶

適合誰： 長期在 DSH 裏用 OpenCode Go、需要同時對照官網賬戶明細與本機會話花費的開發者。

數據口徑： 官方配額按用量單位計算，部分模型可能按 2 倍計量，與美元明細不是同一口徑；面板中的「官方窗口 vs 本地明細」僅供參考，不宜直接當賬單對賬。配額接口走 OpenCode CLI key，官方明細依賴 Cookie 與 workspace ID——可能出現配額正常但官方明細加載失敗的情況，需先確認登錄狀態再點「重試提取」。

當前限制（README 已列）： v1.7.0 起主流程不再自動啓動瀏覽器或探測 CDP 端口，首次須手動填寫憑據；DSH 首次掃描會話事件通常需 10–60 秒；官方 usage.list 爲內部接口，上游格式變化時插件會報錯但無法保證永久兼容。

故障排查： 官方視圖顯示 NEED_CONFIG 表示尚未配置憑據；重啓後插件消失多半是用了動態加載而未加入 profile，請確認已執行 dsh plugin add；診斷日誌見 ~/.config/dsh-opencode-go-usage.log（約保留最近 200 行）。

結尾¶

dsh-opencode-go-usage 把 OpenCode Go 的配額、逐請求成本與 DSH 會話統計收進一塊可拖動的懸浮面板，數據留在本機處理。若你已在用 DSH 的 OpenCode Go 集成，可按上文 Bundle 方式安裝並配置一次官方憑據。

• SkillHub 目錄：https://www.skillhub.cn/plugins/Xenia0922/dsh-opencode-go-usage
• GitHub 倉庫：https://github.com/Xenia0922/dsh-opencode-go-usage