前言¶
DSH 的 web profile 可以在對話界面里加載擴展組件。使用 OpenCode Go 訂閱時，界面上不容易持續看到 5h 滾動、每週、每月三個用量窗口的剩餘比例和重置時間，往往到窗口接近耗盡、請求被限流前才發現問題。
下面介紹 dsh-opencode-go-usage。它是一個 dsh bundle，在 DeepSeek Harness web GUI 的 composer dock，也就是輸入框上方，顯示 OpenCode Go 訂閱用量。
這是什麼¶
dsh-opencode-go-usage 由 v587d 維護，用於 DSH web profile。它的定位很具體：在對話界面中增加一個用量 chip，把 5h 滾動、每週、每月三個窗口的百分比和重置倒計時顯示在輸入框上方。
它不是 DSH 的核心組件，也不替代 OpenCode Go 的賬戶管理。它只在當前 DSH web 界面中提供用量查看、閾值提示和憑據配置入口。
核心功能¶
三個用量窗口¶
顯示 5h 滾動、每週、每月三個窗口的百分比與重置倒計時。窗口接近上限時，可以提前看到剩餘時間，而不是等請求被限流後才處理。
按閾值着色¶
顯示狀態按閾值着色：
- 正常
- 黃色警告：
≥80% - 紅色錯誤：
≥90%或已限流
數據新鮮度¶
chip 上會顯示最近一次成功抓取時間，格式爲 upd HH:MM。這樣可以看到數據是否仍然有效。
輪詢與緩存¶
插件每 10s 輪詢一次，切回標籤頁時會立即刷新。host 端有 300s 緩存，TTL 可配置；失敗後有 60s 冷卻，避免頻繁請求。
Provider 感知¶
僅當會話當前模型走 opencode-go provider 時顯示。切換到其它 provider 後會自動隱藏，切回後會恢復。
詳情面板與手動刷新¶
點擊 chip 可以展開詳情面板。面板中可以看到各窗口的重置倒計時，並支持手動刷新。
內置 Set 憑據編輯器¶
詳情面板左下角有 Set 入口，可以配置 workspace id 與 cookie。已設置的值以掩碼形式展示，不需要直接查看完整憑據。
優雅降級¶
配置缺失或 HTTP 失敗時，插件會進入降級狀態。此時點擊 chip 可以直接進入 Set 面板處理憑據配置。
Cookie 只在 host 側¶
cookie 僅在 host 側使用。瀏覽器只訪問同源 JSON 端點，不把 cookie 發送到瀏覽器。
安裝與啓用¶
安裝前需要滿足：
- DeepSeek Harness
0.1.0-rc.6或更新，且使用 web profile PATH上有pnpm
先執行安裝命令，把插件加入 web profile：
dsh plugin --profile web add github:v587d/dsh-opencode-go-usage
安裝後重啓 dsh web 並刷新頁面。完成後，chip 會出現在輸入框上方的 dock。
如果只想先驗證插件層是否已經組合，可以運行：
dsh --profile web --dump-config
這一步用於檢查當前 web profile 的插件組合，不需要先打開瀏覽器頁面。
典型用法¶
在界面裏配置憑據¶
1、點擊輸入框上方 dock 中的 chip。
2、展開詳情面板。
3、點擊左下角 Set。
4、輸入 workspace id 與 cookie。
5、點擊外部、按 Esc 或保存確認。
配置完成後立即生效。編輯器中的憑據值會以掩碼形式展示，不會直接暴露完整字符串。
使用環境變量¶
也可以用環境變量提供憑據：
export OPENCODE_GO_COOKIE="<cookie>"
export OPENCODE_GO_WORKSPACE_ID="<workspace-id>"
環境變量優先級高於配置文件。
使用配置文件¶
也可以把憑據寫入配置文件：
$DSH_HOME/ocgo-usage.json
默認路徑是：
~/.dsh/ocgo-usage.json
寫入後建議設置文件權限：
chmod 600 ~/.dsh/ocgo-usage.json
配置優先級爲：環境變量 > 配置文件 > 內置默認。
可選覆蓋項¶
可以通過以下環境變量覆蓋部分行爲：
OPENCODE_GO_BASE_URL
OPENCODE_GO_CACHE_TTL
OPENCODE_GO_TIMEOUT_MS
其中 OPENCODE_GO_CACHE_TTL 用於調整 host 端緩存 TTL。組合層配置中的 enabled 是總開關，默認值爲 true。
適用場景與注意¶
這個插件適合在 DSH web profile 中使用 OpenCode Go 訂閱的用戶。如果你希望在輸入框附近持續看到 5h、每週、每月用量，並希望在閾值升高前發現，它可以作爲一個輕量入口。
需要注意的是，cookie 是 OpenCode Go 會話憑據。它是完整用戶會話，可以訪問賬戶內的所有 workspace、訂閱與賬單信息，應當像密碼一樣對待。
插件不記錄 cookie，也不把 cookie 發送到瀏覽器。配置編輯器只把新值寫入：
$DSH_HOME/ocgo-usage.json
如果 cookie 過期或被吊銷，頁面會 302 跳轉到登錄頁，chip 會顯示：
<err:http302>
重新登錄後，可以通過 Set 面板更新 cookie。
安裝前建議檢查源碼與許可證。該插件以當前 dsh 進程權限運行，許可證爲 MIT。
相關鏈接¶
目錄頁：
https://www.skillhub.cn/plugins/v587d/dsh-opencode-go-usage
GitHub 倉庫：
https://github.com/v587d/dsh-opencode-go-usage
