前言¶

在 DeepSeek Harness（DSH）中接入 OpenCode Go 後，用戶需要查看的不只是單個模型調用結果，還包括額度窗口、會話 token 用量、緩存命中情況和模型維度的消耗分佈。dsh-opencode-go-usage 是一個 DSH Web-GUI 插件，爲接入 OpenCode Go 模型的用戶提供完整用量觀測。

這是什麼¶

dsh-opencode-go-usage 由 yascitom 維護，許可證爲 MIT。它爲 DSH 用戶接入 OpenCode Go 模型後提供用量觀測能力：在設置側邊欄新增 OpenCode Go 欄目，內含「額度」和「DSH 會話明細」兩個標籤頁。

Host 端提供 Typert Remote opencodeUsage，包含 usage、dshUsage、dshSessionMessages 三個方法。插件依賴標準 web bundle 組合：api-gateway Client Remote 與 settings.section slot。

核心功能¶

額度窗口¶

額度頁展示 5 小時滾動、每週、每月三個窗口：

• 已用百分比
• 套餐參考限額
• 重置時間

其中 $12 / $30 / $60 限額只作展示參考，並非接口返回內容；它們隨 OpenCode Go 套餐而定，可能漂移。

DSH 會話明細¶

DSH 會話明細展示 DeepSeek Harness 中每個使用 opencode-go 模型的會話 token 用量，並可下鑽到每一次模型調用。

單會話下鑽展示每次模型調用的時間、模型與 token 計數；長會話保留最近 400 次調用。

緩存統計¶

緩存統計在以下三個層級展示：

• 會話累計
• 單會話
• 單次調用

展示內容包含緩存讀取、緩存寫入，並計算緩存命中率。

模型篩選¶

插件支持按模型分組篩選會話，查看每個模型的用量與緩存情況，並附按模型彙總對比表。

雙語界面¶

內置中文 / English 兩套文案，可一鍵切換語言並持久化。

底欄常駐掛件¶

輸入框下方有一行常駐掛件，即時顯示額度，並按閾值自動變色。

數據新鮮度¶

額度頁與底欄掛件標註最近成功更新時間；輪詢失敗保留最後一次成功數據並標註未更新。

診斷區塊¶

診斷區塊展示：

• HTTP 狀態碼
• 解析版本
• 憑證來源與掩碼 key
• 最近 3 次請求快照

DSH 明細會標註「本地統計僅供參考」。

安裝與啓用¶

插件以當前 dsh 進程權限運行，安裝前應檢查源碼與 MIT 許可證。

從 GitHub 安裝：

dsh plugin --profile web add github:yascitom/dsh-opencode-go-box

從本地源碼目錄安裝：

dsh plugin --profile web add file:/path/to/dsh-opencode-go-usage

本包聲明 dsh.bundle.patch，dsh plugin add 會自動將其 reconcile 進 dsh.profile.bundles，無需手動修改 cordis.patch.yml。

安裝後請重啓 dsh web，讓 Host 半部與託管的 Client bundle 生效。

配置¶

Host 端可調項位於插件行 id: opencode-go-usage。在 $DSH_HOME/profiles/web/cordis.patch.yml 中覆蓋：

- id: opencode-go-usage
  config:
    baseUrl: https://opencode.ai/zen/go/v1/usage
    timeoutMs: 15000
    warnPercent: 60
    dangerPercent: 85
    maxSessions: 30

可覆蓋配置項如下：

• baseUrl：默認 https://opencode.ai/zen/go/v1/usage
• timeoutMs：默認 15000
• warnPercent：默認 60，達到該百分比後掛件變橙
• dangerPercent：默認 85，達到該百分比後掛件變紅
• maxSessions：默認 30，作爲 DSH 會話明細掃描的最近會話數上限

用量接口¶

用量查詢接口爲：

GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer <API_KEY>

該接口返回 rolling、weekly、monthly 三個窗口的 status、percent、resetsAt。

用量接口未公開文檔，可能變更；解析做了防禦性處理，非 200 響應會以友好狀態提示而非崩潰。

適用場景與注意¶

這個插件適合在 DSH 中使用 opencode-go 模型、希望在 Web-GUI 內查看額度和會話用量的用戶。

使用前注意：

• 若設置中未添加 opencode-go，或未找到 API key，插件會顯示引導說明。
• API key 解析鏈依次爲：opencode-go provider 配置聲明的憑證引用、DSH 憑證層常規引用、OpenCode 的 auth.json。
• DSH 會話明細統計的是 DSH 會話日誌中的 token 記賬，不含花費金額，只覆蓋 DeepSeek Harness 內的對話。
• 本地 token 統計與服務端計費可能存在差異，以官方賬單爲準。

結尾¶

dsh-opencode-go-usage 將 OpenCode Go 的額度窗口、DSH 會話 token、緩存命中率和模型維度彙總放在同一處觀測。GitHub 倉庫：https://github.com/yascitom/dsh-opencode-go-box。