前言¶

在使用 DeepSeek Harness (DSH) 進行開發時，如果調用的模型屬於 OpenCode Go 套餐，需要隨時掌握額度消耗情況。手動切換或打開網頁查看效率較低。dsh-plugin-opencode-go-quota 插件在 DSH Web 界面右下角增加了一個懸浮窗，用於實時展示當前 OpenCode Go 套餐的剩餘額度。

核心功能¶

該插件提供以下功能：

• 懸浮窗展示：在 Web 界面右下角顯示圓形懸浮按鈕，點擊展開彈窗。按鈕支持鼠標拖動。
• 多週期額度：展示 5 小時滾動、每週、每月三個週期的額度（百分比、限額、重置時間）。
• 自動刷新：彈窗打開期間每 5 分鐘自動刷新數據。
• 智能顯隱：僅噹噹前會話選中的模型屬於 opencode go 系 provider 時顯示按鈕，切換到其他模型自動隱藏。
• 模型適配：按當前所選模型顯示限額，支持調價後高價模型的限額調整。
• 多賬號支持：支持配置多個 opencode go 賬號，自動對應各自的 API key 與額度。

安裝與啓用¶

使用官方 CLI 安裝插件包，並在配置文件中註冊。

dsh plugin --profile web add github:haipisao/dsh-plugin-opencode-go-quota

在 ~/.dsh/profiles/web/cordis.patch.yml 追加註冊行：

- insert:
    - id: opencode-go-quota
      name: dsh-plugin-opencode-go-quota
      config:
        timeoutMs: 15000
        visibleProviders: [opencode-go, opencode-go-2]
        providers:
          opencode-go:
            usageUrl: https://opencode.ai/zen/go/v1/usage
            keyRef: OPENCODE_GO_API_KEY
          opencode-go-2:
            usageUrl: https://opencode.ai/zen/go/v1/usage
            keyRef: OPENCODE_GO_API_KEY_2

配置與使用¶

1. 在 DSH 設置 → 模型中配置 API key（如 OPENCODE_GO_API_KEY）。
2. 將會話模型切換到 opencode go 系模型（如 opencode-go/deepseek-v4-flash）。
3. 右下角出現懸浮按鈕，點擊展開查看額度。
4. 切換到其他模型（如 deepseek-official），按鈕自動隱藏。

注意事項¶

• 首次安裝新 bundle 後若 HMR 未生效，需重啓一次 dsh web。
• 未顯式配置 keyRef 時，host 會回退讀 OpenCode CLI 的 auth.json（按平臺探測路徑）。
• 依賴、bundle 清單、node_modules 與註冊行全部清除後，重啓實例無任何殘留。
• 目前暫緩 dsh 相關插件的開發與更新。

參考資源¶

• GitHub：https://github.com/haipisao/dsh-plugin-opencode-go-quota
• 插件目錄：https://www.skillhub.cn/plugins/haipisao/dsh-plugin-opencode-go-quota