前言¶
在 DSH Web GUI 中使用 OpenCode Go 時，額度窗口、已用金額、重置時間和刷新狀態通常不在當前界面直接呈現。dsh-opencodego-quota 是一個 DSH Web GUI 插件，把 OpenCode Go 的額度信息放在左側欄常駐卡片中，減少來回切換查看的成本。
下面介紹它的功能、安裝方式、典型用法和需要注意的限制。
這是什麼¶
wellcover/dsh-opencodego-quota 是 DSH Web GUI 的 OpenCode Go 額度用量插件。它在左側欄展示日（近5小時）、周、月三個窗口的額度進度、已用金額、配額、重置時間，並顯示刷新時間。
該插件由 wellcover 維護，許可證爲 MIT。package.json 聲明 version 1.0.5，engines.node >=18。
數據來自 OpenCode 官方用量接口，非本地估算：
GET https://opencode.ai/zen/go/v1/usage
核心功能¶
左側欄常駐卡片¶
插件在 DSH Web GUI 左側欄展示常駐卡片。窄欄（圖標欄）模式下會自動隱藏；側欄寬度小於 110px 時，卡片也會自動隱藏。
卡片會跟隨 DSH 殼層渲染自動復位。
三窗口額度進度¶
卡片展示以下三個窗口的額度使用進度：
- 日（近5小時）
- 周
- 月
每個窗口顯示：
- 額度使用進度條
- 已用金額 / 配額
- 重置時間
額度進度條顏色隨已用額度 0→100% 由綠漸變到紅。
計費時段與刷新時間¶
卡片按北京時間顯示 DS 高峯/低谷計費時段、24 小時色帶與當前時刻標記，每 30 秒本地刷新。
卡片會顯示刷新時間，並支持自動刷新間隔設置：
- 間隔範圍：
5–3600秒 - 持久化位置：瀏覽器
localStorage - 手動刷新：支持
API Key 讀取¶
插件會自動從 DSH 憑據 OPENCODE_GO_API_KEY 讀取 Key；失敗時回退到環境變量與 OpenCode CLI auth.json。
Key 解析順序：
- DSH 憑據
OPENCODE_GO_API_KEY - 環境變量
OPENCODE_GO_API_KEY/OPENCODE_API_KEY ~/.local/share/opencode/auth.json
Key 僅經 HTTPS 發給 OpenCode 官方接口，使用 Authorization: Bearer 與 x-api-key。
安裝與啓用¶
先確認 DSH 環境中已有 web profile，並能在「設置 → 模型」中選擇 opencode-go 提供商。
然後運行：
dsh plugin --profile web add github:wellcover/dsh-opencodego-quota
無需額外配置。安裝後應能在左側欄看到卡片；如果卡片不出現，需確認 profile package.json 的 dsh.profile.bundles 含 dsh-opencodego-quota，並重啓後刷新頁面。
典型用法¶
下面是一個可復現的使用流程。
1、安裝插件：
dsh plugin --profile web add github:wellcover/dsh-opencodego-quota
2、確認已配置 OpenCode Go API Key，並能在「設置 → 模型」中選擇 opencode-go 提供商。
3、打開 DSH Web GUI，查看左側欄卡片中的日（近5小時）、周、月額度進度、已用金額、配額和重置時間。
4、如需調整自動刷新間隔，點擊標題欄 ⚙ 或卡片底部秒數，輸入 5–3600 秒，回車或保存生效。
5、如需立即更新數據，點擊 ⟳ 按鈕手動刷新額度數據。
適用場景與注意¶
適合在 DSH Web GUI 中使用 OpenCode Go 的開發者。安裝前建議檢查源碼與 MIT 許可證；插件以當前 dsh 進程權限運行。
注意：
- 卡片只在寬欄下展示；側欄寬度小於
110px的窄欄圖標模式會自動隱藏。 - 自動刷新間隔爲
5–3600秒，持久化到瀏覽器localStorage。 - Key 解析依賴
OPENCODE_GO_API_KEY、OPENCODE_API_KEY或~/.local/share/opencode/auth.json配置。 - 若卡片不出現，需確認 profile
package.json的dsh.profile.bundles含dsh-opencodego-quota，並重啓後刷新頁面。
相關鏈接¶
GitHub：
https://github.com/wellcover/dsh-opencodego-quota
目錄頁線索：
https://www.skillhub.cn/plugins/wellcover/dsh-opencodego-quota
