前言¶
DeepSeek Harness（DSH）是一個基於插件的智能體開發環境。在開發過程中，如果使用 OpenCode Go 套餐，需要關注剩餘額度。原生的 DSH 沒有提供額度監控能力，開發者需要自己記住或去網頁端查看。dsh-ocg-used 在 DSH 輸入框右側工具欄增加了一個膠囊控件，實時顯示剩餘額度，減少查看次數。
是什麼¶
windf1y/dsh-ocg-used 是一個 DSH 客戶端插件，用於在 DSH 的 Web 界面輸入框右側顯示 OpenCode Go 套餐的剩餘額度。插件在工具欄膠囊常駐顯示三個窗口的剩餘百分比，按餘量自動變色（充足 / 偏緊 / 告急），鼠標懸停可以查看更詳細的數據。
核心功能¶
- 工具欄膠囊常駐，逐個窗口顯示剩餘百分比，按餘量自動變色（充足 / 偏緊 / 告急）
- 懸停面板：每個窗口的剩餘、已用、重置時刻、距重置還剩多久，以及本次數據更新時間
- 點擊膠囊立即刷新；平時每 60 秒刷新一次
- 未配置 Key 或上游失敗時顯示「餘量不可用」，懸停給出具體原因
兼容性¶
- DSH
>= 0.1.7-rc.1 - Node
^22.19.0 || >=24.0.0 - 已驗證環境：DSH 0.1.7-rc.1 的 Web profile
安裝與啓用¶
從 GitHub 安裝不需要構建腳本授權，倉庫裏已經提交了構建產物 lib/：
dsh plugin --profile web add github:windf1y/dsh-ocg-used
dsh web
裝好後重啓 dsh web（bundle 列表的變化在下次啓動生效），工具欄就會出現膠囊。
更新到最新版本需要先卸載再安裝：
dsh plugin --profile web remove dsh-ocg-used
dsh plugin --profile web add github:windf1y/dsh-ocg-used
卸載：
dsh plugin --profile web remove dsh-ocg-used
確認當前 profile 裏裝了什麼：
dsh plugin --profile web list
配置 API Key¶
插件通過 DSH 的憑據 seam 讀 OPENCODE_GO_API_KEY，值本身不會進配置文件。查找優先級是：
- 啓動 dsh 的那個進程環境（
OPENCODE_GO_API_KEY=… dsh web） - 憑據存儲文件裏的
refs.OPENCODE_GO_API_KEY（GUI 設置裏保存的 key 也寫在這裏） - 項目根目錄的
.env - harness home 下的
.env
任選其一即可：
OPENCODE_GO_API_KEY=sk-… dsh web
或者在 GUI 的設置界面裏保存這個 key，或寫進項目根的 .env：
OPENCODE_GO_API_KEY=sk-…
典型用法¶
配置好 API Key 後，啓動 DSH Web 界面，輸入框右側工具欄會顯示一個膠囊。膠囊顯示三個窗口的剩餘百分比：5 小時、一週、一個月。根據剩餘比例，膠囊會自動變色：
- 充足：剩餘比例較高
- 偏緊：剩餘比例中等
- 告急：剩餘比例較低
鼠標懸停在膠囊上，會展開一個面板，顯示每個窗口的剩餘、已用、重置時刻、距重置還剩多久，以及本次數據更新時間。
點擊膠囊可以立即刷新數據。
適用場景與注意¶
適合經常使用 OpenCode Go 套餐、需要隨時掌握額度情況的 DSH 開發者。
插件以當前 dsh 進程權限運行，安裝前建議查看源碼與許可證（MIT）。同一個 composition 裏只能有一份註冊 /opencode-go/quota 的插件，如果 DSH 已經內置了同名路由（例如自己 fork 過 Web bundle），同時啓用兩邊會以 webserver: duplicate exact route "/opencode-go/quota" 啓動失敗，需要禁用其中一個。
總結¶
dsh-ocg-used 在 DSH 的輸入框工具欄提供 OpenCode Go 套餐餘量監控，通過膠囊和懸停面板展示三個窗口的剩餘、已用、重置時刻等信息，幫助開發者隨時掌握額度情況，減少去網頁端查看的次數。
目錄頁：https://www.skillhub.cn/plugins/windf1y/dsh-ocg-used
GitHub：https://github.com/windf1y/dsh-ocg-used
