前言¶

如果你在 DSH 裏使用 OpenCode Go 的訂閱跑任務，滾動、周、月三檔用量和各自的重置時間分散在服務端接口裏。想確認還剩多少額度、什麼時候重置，就得中斷手頭的工作去另外查。

dsh-opencode-go-usage 把這塊信息做成一個懸浮小部件，常駐 DSH Web GUI 右下角，每 60 秒刷新一次，讓你不用離開當前頁面就能掌握用量。

這是什麼¶

dsh-opencode-go-usage 是由 kkishapppy 維護的一個 DSH Web 插件，當前版本 0.1.0，MIT 協議。它的定位一句話可以說清：在 DSH Web GUI 右下角即時顯示 OpenCode Go 訂閱的滾動/周/月用量百分比與重置倒計時。

它分服務端和瀏覽器兩個部分：服務端負責代理用量接口並保管 API key，瀏覽器部分負責渲染小部件。

核心功能¶

已實現的能力如下：

• 右下角懸浮膠囊顯示三檔用量與重置倒計時，形如 ⓖ 滾動 0% · 周 2% (2天13時) · 月 1% (30天18時)
• 每 60 秒自動刷新，窗口切回前臺時立即刷新
• 樣式跟隨 DSH 主題，基於 --dsw-alias-* token，深淺主題和皮膚自動適配
• API key 只存在服務端（經 dsh 憑據服務解析），不落瀏覽器

安裝與啓用¶

安裝只需要一條命令：

dsh plugin --profile web add dsh-opencode-go-usage

然後在 profiles/<profile>/cordis.patch.yml 中加入配置：

- id: opencode-go-usage
  config:
    apiKeyEnv: OPENCODE_GO_API_KEY   # 憑據名（默認 OPENCODE_GO_API_KEY）
    cacheMs: 60000                   # 服務端代理緩存毫秒

兩個配置項的含義：

1、apiKeyEnv 指定憑據名，默認爲 OPENCODE_GO_API_KEY。key 通過 dsh 憑據服務解析，可以在 .credentials.yaml 或 GUI Models 頁配置，與 llm-pi-ai 同源。

2、cacheMs 控制服務端代理的緩存時長，默認 60000 毫秒。

工作原理¶

插件的數據流分兩段：

1、服務端代理。插件在服務端請求 GET https://opencode.ai/zen/go/v1/usage（Bearer sk- 認證，OpenAI 兼容端點），並把結果暴露爲 /plugins/dsh-opencode-go-usage/usage，帶 60 秒緩存。API key 只在服務端出現，瀏覽器端拿不到。

2、瀏覽器渲染。小部件掛載在 document.body 頂層，使用 position: fixed 定位，不受容器 transform 或 backdrop-filter 的影響，保證始終顯示在右下角。

開發與構建¶

如果要自行構建：

npm i
npx -y tsdown@0.22.2 --config ./tsdown.config.ts

改動的生效方式不同：

1、服務端改動需要重啓 DSH。

2、client 改動硬刷新頁面即可生效。

依賴方面，package.json 標註 private: true，peerDependencies 爲 cordis ^4.0.0-rc.7 和 react ^18.2.0；client inject 依賴 @deepseek-ai/dsh-client-runtime 與 @deepseek-ai/dsh-client-ui-slots，platform 爲 web。

適用場景與注意¶

這個插件適合通過 OpenCode Go 訂閱使用 DSH、需要隨時掌握用量與重置時間的開發者。如果你只在偶發場景下調用，60 秒一次的常駐顯示可能不是必需的。

安裝前注意：插件以當前 dsh 進程權限運行，API key 會經 dsh 憑據服務讀取。建議安裝前檢查源碼與許可證，確認無誤再啓用。

結尾¶

dsh-opencode-go-usage 解決的問題很具體：把 OpenCode Go 訂閱的用量和重置時間放到眼前，不用額外操作。如果你正好有這個需求，可以試試。

• GitHub：https://github.com/kkishapppy/dsh-opencode-go-usage
• 社區目錄頁：https://www.skillhub.cn/plugins/kkishapppy/dsh-opencode-go-usage