前言¶
如果日常通過 DeepSeek Harness (DSH) Web GUI 使用 OpenCodeGo，剩餘額度通常需要單獨查看。dsh-opencodego-usage 把這個信息放進 DSH Web GUI：在對話輸入框右下角顯示一個呼吸燈，點擊後展開面板，查看 rolling、weekly、monthly 三個窗口的用量、剩餘比例和重置時間。
這是什麼¶
BeiZi6/dsh-opencodego-usage 是爲 DeepSeek Harness (DSH) Web GUI 提供 OpenCodeGo 剩餘額度監控插件。倉庫 owner 爲 BeiZi6，package.json 中的 author 爲 Xu Yuanshan。它適用於 dsh web，許可證爲 MIT © Xu Yuanshan。
核心功能¶
- 在對話輸入框右下角顯示呼吸燈，按剩餘額度比例變色：>50% 綠、20–50% 黃、<20% 紅，並帶 3.6 秒呼吸動畫。
- 指示器顏色反映 rolling、weekly、monthly 三個窗口中最低的剩餘額度比例。
- 點擊呼吸燈展開液態玻璃面板，展示 rolling、weekly、monthly 三個窗口的進度條和重置時間。
- 自動從 DSH credentials 讀取 API key；僅當 active provider 爲
opencode-go時，解析llm-pi-ai.providers.opencode-go.apiKeyEnv指定憑據。 - 面板內可手動覆蓋當前會話 API key；清除後回退自動解析。
- 每 2 分鐘自動刷新 OpenCodeGo 配額。
- 面板具有鼠標跟隨高亮、磨砂模糊和窗口式斜向打開動畫。
- 在 DSH web server 註冊同源路由
/opencodego-usage，並查詢官方 OpenCodeGo quota API：
GET https://opencode.ai/zen/go/v1/usage
請求使用 Bearer 認證。
安裝與啓用¶
安裝前需要啓用 web profile 的 DeepSeek Harness。運行環境要求 Node.js >= 22.19，peer dependencies 爲：
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-host-webserver ^0.1.0-rc.6
從官方 registry 安裝：
dsh plugin --profile web add github:BeiZi6/dsh-opencodego-usage
安裝後重啓 dsh web，使插件生效。
移除插件：
dsh plugin --profile web remove dsh-opencodego-usage
典型用法¶
1、在 DSH Web GUI 的對話輸入框右下角查看呼吸燈。顏色表示當前最低剩餘額度：
| 剩餘額度比例 | 顏色 |
|---|---|
| >50% | 綠 |
| 20–50% | 黃 |
| <20% | 紅 |
2、點擊呼吸燈展開面板，查看三個窗口：
rolling：約近 5 小時weekly：約近 7 天monthly：約近 30 天
每個窗口展示用量、剩餘比例和重置時間。
3、如果當前會話需要使用另一個 API key，可在面板中輸入手動 API key override。清除後，插件回退到自動解析。
4、面板數據每 2 分鐘自動刷新，無需手動重複查詢。
API key 與狀態文件¶
手動覆蓋的 API key 會保存在狀態文件中。默認位於 $DSH_HOME 下，可通過 OCG_STATE_PATH 環境變量移動路徑。刪除該文件不會影響基於 DSH credentials 的解析。
API key 只會通過 HTTPS 發送到官方 OpenCodeGo quota endpoint。
適用場景與注意¶
適合在 DSH Web GUI（dsh web）中使用 OpenCodeGo，並希望在對話界面直接查看剩餘額度的場景。
注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 配額數值和重置時間按 OpenCodeGo API 返回原樣展示，不做本地估算。
- 插件在 DSH web server 註冊同源路由
/opencodego-usage，並在後端查詢官方 OpenCodeGo quota API。 - 需要
Node.js >= 22.19以及對應 peer dependencies。
結尾¶
dsh-opencodego-usage 把 OpenCodeGo 剩餘額度接入 DSH Web GUI，適合需要在輸入框附近快速判斷 rolling、weekly、monthly 配額狀態的使用場景。
倉庫地址：https://github.com/BeiZi6/dsh-opencodego-usage
如使用 DSH 社區目錄，可按插件名 dsh-opencodego-usage 檢索。
