前言¶
DSH 的插件思路是「一切皆插件」。如果你已經使用 OpenCode GO 訂閱，希望在 DSH web 的會話裏看到滾動 5 小時、每週、每月配額，dsh-opencode-go-usage 可以把這部分信息接到側邊欄和聊天命令中。
這是什麼¶
dsh-opencode-go-usage 是 yumusb 維護的 DSH 插件，許可證爲 MIT。它提供三件事：DSH web 側邊欄中的 OpenCode GO plan 配額小部件、同源 usage 代理，以及 /opencode-go 聊天命令。
它兼容 DSH 0.1.1-rc.2 和 0.1.2-alpha.2。
核心功能¶
1、側邊欄小部件固定在 DSH web sidebar 底部，使用 sidebar.footer.action slot，展示 rolling（5h）、weekly、monthly 三個用量條，並顯示對應窗口重置的相對倒計時。
2、側邊欄摺疊時，小部件收縮爲緊湊百分比 badge。
3、/opencode-go 命令可以在任意會話中以文本形式打印同一組用量數字。
4、插件註冊同源代理路由 GET /opencode-go/usage，由 host 攜帶 API key 轉發到官方 GO gateway；API key 不進入瀏覽器。
5、host 側對上游 usage 調用緩存 30s；瀏覽器端每 60s 輪詢同一同源路由。
前置條件¶
- DSH 已安裝，且
webprofile 至少啓動過一次，~/.dsh/profiles/web存在。 - Node.js
>= 18（用於fetch）。 - 擁有 OpenCode GO 訂閱及其 API key。
安裝與啓用¶
先安裝到 web profile：
dsh plugin --profile web add dsh-opencode-go-usage
然後保存 GO API key 爲 DSH credential。可寫入 ~/.dsh/.credentials.yaml：
OPENCODE_GO_API_KEY: <你的 API key>
最後重啓 dsh web，並在瀏覽器中強制刷新頁面。
典型用法¶
小部件：展開側邊欄時讀取三條進度條和重置倒計時；摺疊側邊欄時看百分比 badge。
聊天命令：在任意會話中輸入：
/opencode-go
會輸出 rolling（5h）、weekly、monthly 三個窗口對應的文本用量。
配置項¶
| 配置項 | 默認值 | 說明 |
|---|---|---|
apiKeyEnv |
OPENCODE_GO_API_KEY |
API key 對應的 credential / 環境變量名 |
baseUrl |
https://opencode.ai/zen/go |
gateway base URL |
cacheMs |
30000 |
host 側上游緩存 TTL |
適用場景與注意¶
適合已有 OpenCode GO 訂閱、使用 DSH web 插件生態，並希望在側邊欄或會話中查看配額的開發者。
插件會以當前 dsh 進程權限運行，安裝前建議先檢查源碼和 MIT 許可證。需要保持 Node.js >= 18、DSH web profile 可用，以及有效的 OpenCode GO API key。
相關鏈接¶
- 目錄頁：
https://www.skillhub.cn/plugins/yumusb/dsh-opencode-go-usage - GitHub：
https://github.com/yumusb/dsh-opencode-go-usage
