前言¶

DSH 的插件機制支持把輔助能力掛到已有 profile 上，理念偏向「一切皆插件」。對於使用 OpenCode Go 的開發者來說，配額窗口和重置時間通常只在控制檯可見，在 DSH 的 Web 界面裏頻繁切換查看不夠順手。

@xueayi/dsh-opencode-go-usage 是爲 DeepSeek Harness（DSH）編寫的 DSH 插件，用來在 Web GUI 中顯示一個 floating dock，展示 5h-rolling / weekly / monthly quota windows 和 live reset countdowns。

這是什麼¶

下面先交代這個插件的定位：

• 插件名：@xueayi/dsh-opencode-go-usage
• 維護者：xueayi
• 許可證：MIT
• package.json 聲明版本：0.1.6
• Node 引擎：^22.19.0 || >=24
• 用途：OpenCode Go plan usage monitor for DeepSeek Harness

它通過官方 quota API 獲取數據，在 DSH 的 Web GUI 中提供一個 floating dock，用於查看 5h-rolling / weekly / monthly quota windows、剩餘配額、重置倒計時和刷新狀態。

核心功能¶

這個插件主要解決「在 Web GUI 中快速查看 OpenCode Go 配額」的問題。已覈實的能力如下：

1. 在 Web GUI 中顯示 floating dock。
2. 展示 5h-rolling / weekly / monthly quota windows。
3. 顯示 live reset countdowns。
4. 支持 collapsed badge 與 expandable panel。
5. 支持拖動 badge，位置保存在 localStorage。
6. 提供 minimal mode（極簡模式）。
7. 刷新失敗時保留最後一次成功數據並提示。
8. 不暴露 model-facing surface，不添加 prompt text 或 tool schema。

數據來源是官方 quota API：

GET https://opencode.ai/zen/go/v1/usage

該請求使用 Bearer API key，不需要 workspace id 或 cookie。

安裝與啓用¶

安裝目標是 DSH 的 Web profile。先執行安裝命令：

dsh plugin --profile web add @xueayi/dsh-opencode-go-usage

安裝後重啓 profile。瀏覽器界面通常重啓：

dsh web

後續升級到最新已發佈版本時，可以使用：

dsh plugin --profile web update @xueayi/dsh-opencode-go-usage

典型用法¶

推薦在 DSH 的 Web 配置中完成 provider 選擇：

1. 打開 Web Settings → Models。
2. 選擇 official-channel OpenCode Go provider。
3. 填入 API key。

API key 也可以通過以下位置提供：

• ~/.dsh/.credentials.yaml
• environment variable OPENCODE_GO_API_KEY

已覈實的配置示例如下：

- insert:
    - id: opencode-go-usage
      name: '@xueayi/dsh-opencode-go-usage'
      config:
        apiKeyEnv: OPENCODE_GO_API_KEY
        refreshMs: 60000

這裏：

• apiKeyEnv：憑據引用，默認指向 OPENCODE_GO_API_KEY
• refreshMs：自動刷新間隔

適用場景與注意¶

這個插件適合需要在 DSH Web GUI 中持續觀察 OpenCode Go 配額的開發者。它不進入模型請求路徑，不添加 prompt text 或 tool schema，也沒有模型請求、token 注入或 KV Cache 影響。

使用前需要注意：

1. 需要 OpenCode Go API key。
2. 單賬戶使用，限制爲 one API key per profile。
3. Poll latency：collapsed badge polls every 60s，open panel every 10s。
4. 刷新失敗後保留最後一次成功數據，數據可能變舊。
5. 拖動位置沒有 safe-area compensation。
6. 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與 MIT 許可證。

結尾¶

@xueayi/dsh-opencode-go-usage 的價值比較集中：把 OpenCode Go 的 5h-rolling / weekly / monthly quota windows 和 reset countdowns 放進 DSH Web GUI，減少爲了查看配額而離開當前界面的成本。

相關鏈接：

• GitHub：https://github.com/xueayi/dsh-opencode-go-usage
• 社區目錄頁：已覈實資料未提供可覈驗 URL；DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，可在目錄站點按插件名檢索。