前言¶

opencode-usage 是一個 DSH bundle 插件。它把 OpenCode Go 的 rolling / weekly / monthly 額度使用率和重置時間放進 dsh Web UI 的 composer dock，讓額度信息可以直接在會話界面中看到。

這是什麼¶

opencode-usage 由 AmaTsumeAkira 維護，採用 MIT 許可證。它遵循 dsh bundle 格式，核心目標是在 dsh Web UI 中展示 OpenCode Go quota badge，包括三個額度窗口的使用率、重置倒計時、最近一次獲取時間和刷新狀態。

核心功能¶

• 在 composer dock 中以顏色百分比展示 rolling / weekly / monthly 三個額度窗口，並顯示重置倒計時。
• 顯示最近一次獲取時間（updated M/D HH:mm），刷新時顯示 updating…。
• 點擊 OpenCode Go 標籤可手動刷新額度。
• 每 5 分鐘自動刷新。
• API key 僅在 harness 進程內通過 credentials service 解析，並通過環境變量傳給 curl，不會序列化到瀏覽器或日誌。

安裝與啓用¶

插件包是預構建 artifacts，lib/ 已提交到倉庫，無 install scripts，因此 git 安裝不需要 pnpm allowBuilds grant。

從 GitHub 安裝：

dsh plugin --profile web add github:AmaTsumeAkira/opencode-usage

也可以從本地目錄安裝：

dsh plugin --profile web add ./opencode-usage

卸載插件：

dsh plugin --profile web remove opencode-usage

典型用法¶

插件需要配置 OPENCODE_GO_API_KEY。可以通過環境變量或 ~/.dsh/.credentials.yaml 提供：

# ~/.dsh/.credentials.yaml
OPENCODE_GO_API_KEY: your-opencode-go-api-key

配置完成後，composer dock 中的 OpenCode Go 徽章會展示額度信息。未配置 API key 時，徽章顯示“獲取失敗”。

刷新方式有兩條：

1、等待每 5 分鐘自動刷新；
2、點擊 OpenCode Go 標籤手動刷新。

適用場景與注意¶

• 適合希望在 dsh Web UI 中直接查看 OpenCode Go 額度使用率、重置時間和刷新狀態的使用者。
• 使用前必須配置 OPENCODE_GO_API_KEY。
• 該插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 插件通過 credentials service 解析 key，不會暴露到瀏覽器或日誌；但仍應按環境要求管理憑據。

鏈接¶

GitHub：https://github.com/AmaTsumeAkira/opencode-usage