前言¶
在 DeepSeek Harness（DSH）裏用 OpenCode Go 訂閱模型時，額度往往要另開頁面或靠記憶估算。官方底欄已有「上下文窗口」指示器，但不會在同一個位置告訴你 Rolling / Weekly / Monthly 各窗口用了多少。dsh-opencode-go-quota 是維護者 tiamo-Li 提供的客戶端小插件：在會話輸入框下方、上下文環右側插入一枚與原生同風格的額度指示器，只在當前會話屬於 Go 訂閱 provider 時顯示。
下面按定位、能力、安裝配置與注意事項說明如何用上它。
這是什麼¶
dsh-opencode-go-quota 面向已安裝 DSH、並配置了 OpenCode Go API Key 的用戶。Host 側用憑據請求官方額度接口，瀏覽器只收到百分比與重置時間，不在前端暴露 Key。插件分類爲客戶端，當前 GitHub 星標爲 0；許可證爲 MIT（© 2026 tiamo-Li）。與 OpenCode / DeepSeek 官方無隸屬關係，僅調用用戶自己賬號的額度接口。
核心功能¶
指示器掛在 conversation.composer.dock 統計條裏，位於「上下文窗口」百分比環的右側：
- 按 provider 顯隱：僅噹噹前會話模型屬於 OpenCode Go 訂閱（默認 provider 爲
opencode-go或dsh-opencode-go）時顯示；切換到其它 provider 自動隱藏。 - 摺疊態：顯示
Go標籤、迷你進度條，以及 5 小時滾動（Rolling） 窗口的已用百分比；加載中或不可用時顯示—。 - 展開態：鼠標懸停、鍵盤聚焦或點擊固定後，浮層列出 Rolling / Weekly / Monthly：各列含週期、用量（48px 進度條 + 百分比）、刷新時間；英文緊湊格式如
Resets in 4h 54m。 - 視覺與隱私：沿用 DSH 主題 token、字號、圓角與浮層陰影，跟隨明暗主題；Key 僅在 Host 使用，瀏覽器側不持有 Key。
若你同時使用 Duskriver/dsh-opencode-go 配置 API Key，README 建議：在 DSH 官方模型配置（llm-pi-ai → opencode-go）同樣添加該 Key（本插件讀取官方憑據名 OPENCODE_GO_API_KEY）；並可在官方模型配置處取消 Go 訂閱的全部可用模型、在該插件設置裏關閉「用量懸浮球」，以避免重複路由與重複顯示用量。
安裝與啓用¶
前置條件：DSH 0.2.2 及以上（桌面端已驗證 0.2.2-rc.1），並已配置 OpenCode Go 的 API Key（DSH 憑據默認名 OPENCODE_GO_API_KEY）。
方式 A：插件頁（推薦）¶
- 打開 DSH → 插件 → 添加插件。
- 填入倉庫地址：
https://github.com/tiamo-Li/dsh-opencode-go-quota - 安裝完成後點擊 立即啓用；若未開 HMR，刷新頁面或重啓 DSH。
方式 B：命令行¶
任選一種 spec 安裝（desktop profile 示例）：
dsh plugin --profile desktop add github:tiamo-Li/dsh-opencode-go-quota
dsh plugin --profile desktop add https://github.com/tiamo-Li/dsh-opencode-go-quota
安裝後到 插件 頁啓用組合包，或在 profile 的 cordis.patch.yml 中啓用。
API Key¶
插件默認讀取憑據引用 OPENCODE_GO_API_KEY（與 DSH 原生 pi-ai 的 opencode-go 路由一致）：
- 已用原生
opencode-goprovider 的用戶一般無需額外配置； - 否則在 DSH 憑據設置中保存該名，或使用環境變量
OPENCODE_GO_API_KEY=...。
配置¶
默認項來自包內 cordis.patch.yml，可在 profile 的 cordis.patch.yml 中按 id: opencode-go-quota 覆蓋：
| 字段 | 默認值 | 說明 |
|---|---|---|
apiKeyEnv |
OPENCODE_GO_API_KEY |
DSH 憑據 seam 引用名 |
baseURL |
https://opencode.ai/zen/go/v1 |
網關根地址，請求 ${baseURL}/usage |
providers |
["opencode-go", "dsh-opencode-go"] |
視爲 Go 訂閱的 provider id |
pollMs |
60000 |
瀏覽器輪詢週期（頁面隱藏時暫停，回前臺立即刷新） |
cacheMs |
20000 |
Host 短緩存，減輕多會話重複請求 |
timeoutMs |
10000 |
上游請求超時 |
示例：
- id: opencode-go-quota
name: dsh-opencode-go-quota
config:
pollMs: 30000
providers:
- opencode-go
典型用法與數據流¶
無需單獨「打開插件界面」：選好屬於 providers 列表的 Go 訂閱模型後，底欄右側即出現指示器。Host 使用 apiKeyEnv 指向的 Key 請求 GET {baseURL}/usage，讀取 usage.rolling / usage.weekly / usage.monthly 的 percent、resetsAt、status；請求失敗時顯示 —，不僞造用量，浮層內可手動重試。除 OpenCode 官方額度接口外，插件不向其它第三方發請求。額度數據經 DSH 本機 loopback Web 服務暴露給瀏覽器；同機其它進程理論上可讀聚合百分比，但拿不到 API Key，也不涉及會話內容。
適用場景與注意¶
適合誰：日常在 DSH 桌面端用 OpenCode Go 訂閱模型、希望在作曲欄一眼看到三檔額度窗口的用戶。
排障要點（摘自 README）：
- 看不到指示器：確認當前模型 provider 在
providers中、插件已啓用、OPENCODE_GO_API_KEY已配置。 - 一直爲
—：多爲 Key 無效、無 Go 訂閱權限或網關不可達；展開浮層查看錯誤摘要並重試。 - 升級後不生效：先刷新；仍無效則完全退出 DSH 再打開。
安全與信任：插件以當前 DSH 進程權限運行；安裝前建議在 GitHub 閱讀 index.js、client.js 與許可證。社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係——DSH 生態主張「一切皆插件」，自行審閱源碼後再啓用是合理習慣。
結尾¶
dsh-opencode-go-quota 把 OpenCode Go 的 Rolling / Weekly / Monthly 用量收到會話底欄，與原生上下文指示器並列，不搶焦點又便於對照。需要安裝說明與排障細節時，以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/tiamo-Li/dsh-opencode-go-quota
- GitHub：https://github.com/tiamo-Li/dsh-opencode-go-quota
