前言¶

在 DeepSeek Harness（DSH）裏做開發時，如果同時使用 OpenCode Go 訂閱，額度往往要單獨去控制台或 CLI 裏查：最近 5 小時、本週、本月各用了多少、何時重置，不容易和當前工作環境放在一起看。dsh-opencode-go-usage 是社區維護的客戶端插件，在 DSH 左側欄增加 OpenCode Go 入口，把三類用量窗口和重置時間直接展示在 Harness 界面裏；密鑰由 DSH 服務端解析，不進入瀏覽器。下面介紹它的能力、安裝方式與配置要點。

這是什麼¶

插件倉庫：ungurenko/dsh-opencode-go-usage，維護者 ungurenko，許可證 MIT，當前版本 1.0.0（package.json）。分類上屬於 DSH 客戶端插件：通過 cordis.patch.yml 註冊 bundle，在 Web 客戶端注入側邊欄頁面。README 寫明已在 DeepSeek Harness 0.2.2-rc.1 上驗證，並標註兼容 0.2.x。

核心功能¶

點擊左側欄 OpenCode Go 後，面板按三個時間窗口展示訂閱用量（README 中的對應關係如下）：

每個窗口包含使用百分比、進度條和重置時間；額度用盡時會顯示類似「限額已用盡 · 重置 …」的提示（具體文案隨語言包而定）。數據默認每分鐘自動刷新，並提供手動「刷新」按鈕。

界面支持俄語、英語、中文（locale/ 目錄）。在「插件」→「已安裝」中，插件名稱對應 README 中的「Лимиты OpenCode Go」/ _limits 類展示；側邊欄項名爲 OpenCode Go。

實現上，瀏覽器通過 DSH 調用服務端路由 /api/opencode-go/usage；服務端查找 API 密鑰後請求 GET https://opencode.ai/zen/go/v1/usage，請求頭爲 Authorization: Bearer <key>，再將響應整理爲 rolling、weekly、monthly，字段包含 percent、limited、resetsAt 等。插件面板底部會標明密鑰來自哪一個來源。

安裝與啓用¶

官方 README 的安裝路徑是：獲取插件源碼後，以 pnpm link 方式掛入 DSH 配置檔，而不是 dsh plugin add github:… 形式的單行命令。

1、獲取插件目錄（README 原文）：

git clone https://github.com/ungurenko/dsh-opencode-go-usage.git

2、編輯所用 DSH 配置檔的 package.json（示例路徑 ~/.dsh/profiles/<配置檔名>/package.json）。在 dependencies 與 dsh.profile.bundles 中各增加一條；link: 後改爲本機上的絕對路徑：

{
  "dependencies": {
    "@local/dsh-opencode-go-usage": "link:/完整/路徑/到/dsh-opencode-go-usage"
  },
  "dsh": {
    "profile": {
      "bundles": ["@local/dsh-opencode-go-usage"]
    }
  }
}

若 bundles 裏已有其他插件，只需把 "@local/dsh-opencode-go-usage" 追加到列表末尾。

3、在該配置檔目錄執行 pnpm install，然後重啓 DSH。

4、驗收：左側欄出現 OpenCode Go；「插件」→「已安裝」中能看到本插件。

API 密鑰從哪裏來¶

插件按順序嘗試以下來源，使用第一個找到的：

1. 插件配置中的 apiKey
2. DSH 憑證，名稱爲 OPENCODE_GO_API_KEY（默認與 apiKeyRef 一致）
3. 環境變量 OPENCODE_GO_API_KEY
4. macOS 鑰匙串，服務名 opencode-go-api-key（默認與 keychainService 一致）
5. 本機 opencode 登錄狀態：~/.local/share/opencode/auth.json

若本機已通過 opencode 登錄，通常無需額外配置。密鑰只在 DSH 服務端使用，不下發到瀏覽器。

可選配置¶

在插件的 config（cordis.patch.yml）中可覆蓋下列項（以下爲 README 表格摘要）：

典型用法與排錯¶

日常用法：安裝並重啓後，從左側欄打開 OpenCode Go，查看三檔用量與重置時間；需要即時數據時點「刷新」。

README 中列出的常見提示：

• No OpenCode API key found：五處來源均未找到密鑰。可登錄 opencode，或在 DSH 憑證 / 環境變量中配置 OPENCODE_GO_API_KEY。
• This key has no Go subscription：密鑰有效，但賬號無 OpenCode Go 訂閱。
• 側邊欄沒有該項：確認插件已在「插件」中啓用，且 pnpm install 後已重啓 DSH。

適用場景與注意¶

適合：在 DSH 中長時間編排智能體或腳本、同時又訂閱 OpenCode Go，希望在同一界面監控 5 小時 / 周 / 月額度、避免默默觸頂的用戶。

注意：插件以當前 DSH 進程權限運行，會向 opencode.ai（或你配置的 baseUrl）發起帶 Bearer 密鑰的請求；安裝前建議閱讀倉庫源碼與 MIT 許可證。DSH 生態主張「一切皆插件」；社區目錄站 SkillHub 插件頁 與 GitHub 倉庫爲社區分發渠道，並非 DeepSeek / 幻方官方應用商店。

結尾¶

dsh-opencode-go-usage 把 OpenCode Go 的三檔訂閱用量收進 DSH 左側欄，並複用 DSH 與本機 opencode 已有的密鑰來源，減少單獨查控制台的開銷。更多說明與截圖見 GitHub README，目錄索引見 SkillHub。