前言¶
在 DSH Web 裏使用 OpenCode Go 時，用量通常需要離開當前界面去外部接口查看。dsh-ocgo-usage 把這件事做成了 DSH 插件：在 Web 側邊欄左下角顯示常駐用量角標，懸停後展開用量明細和高峯時段時間軸。
DSH 採用「一切皆插件」的擴展方式。相關社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文按已覈實的插件資料介紹。
這是什麼¶
badai147/dsh-ocgo-usage 是一個 DSH Web 插件，維護者爲 badai147。它的作用是在 DeepSeek Harness Web 側邊欄左下角顯示 OpenCode Go 用量。
已覈實資料中，許可證爲 MIT。截至 2026-09-01，資料中 package.json 版本爲 0.2.0。
核心功能¶
常駐角標¶
左下角有一個常駐按鈕，與設置按鈕同列同款。角標顯示儀表盤圖標和本月剩餘用量百分比。
狀態顏色如下：
剩餘 ≤20%：橙色
剩餘 ≤0：紅色
懸停明細卡片¶
懸停左下角「Go 用量」按鈕後，會向上彈出明細卡片。卡片中包括：
DeepSeek 高峯時段時間軸（北京時間）
滾動 / 本週 / 本月三條用量進度
已用百分比
重置時間
高峯時段時間軸¶
高峯時段按北京時間展示。DeepSeek V4 Flash / Pro 的高峯時段爲：
09:00-12:00
14:00-18:00
對應 UTC 時間爲：
01:00-04:00
06:00-10:00
時間軸會高亮當前時刻所處區間，並顯示距下一切換點的剩餘時間。
數據刷新¶
激活後會先拉取一次用量，之後每 60 秒自動刷新。
讀取 API key¶
插件自動讀取 DSH 供應商配置中的 opencode-go API key，無需額外配置。讀取順序如下：
~/.dsh/.ocg-state.json → ~/.dsh/.credentials.yaml → 環境變量
運行方式¶
Host 端註冊一條 DSH web server 路由，用於給 Client 提供用量數據：
GET /api/ocgo-usage
該路由會代理請求到 OpenCode Go 的用量接口：
https://opencode.ai/zen/go/v1/usage
Client 端註冊兩個 UI 位置：
sidebar.footer.action
shell.overlay
Client 端爲手寫 __ModuleLoader__ bundle，Host 端爲純 Node ESM。跨平臺支持 Windows / macOS / Linux。
安裝與啓用¶
先安裝插件，再重啓 dsh web 生效。
執行以下安裝命令：
dsh plugin --profile web add @badai147/dsh-ocgo-usage
如果升級後仍是舊版，可以顯式指定版本重裝：
dsh plugin --profile web add @badai147/dsh-ocgo-usage@0.1.1
經過上面的步驟後，重啓 dsh web，側邊欄左下角應能看到「Go 用量」按鈕。
典型用法¶
1、在 DSH 設置中配置 opencode-go 供應商，包含 API key。插件會自動讀取，無需額外配置。
2、重啓 dsh web。
3、懸停左下角「Go 用量」按鈕查看明細。
4、常駐角標會顯示本月剩餘用量百分比。例如本月已用 5% 時，顯示：
95% (本月)
5、在懸停卡片中查看高峯時段。當前時刻會落在高峯或非高峯區間中，並顯示距下一切換點的剩餘時間。
適用場景與注意¶
適合以下場景：
- 需要在 DSH Web 中頻繁查看 OpenCode Go 用量。
- 需要按北京時間判斷 DeepSeek V4 Flash / Pro 高峯時段。
- 不想每次手動打開外部用量接口。
使用前注意：
- 插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證。
- opencode-go API key 只在本機處理，不下發瀏覽器。
- 自動讀取順序爲：
~/.dsh/.ocg-state.json → ~/.dsh/.credentials.yaml → 環境變量
- 自 0.1.1 起爲純 Node 實現，無需系統安裝 python3。
- 0.1.0 在 Windows 上可能觸發 shell 沙箱檢查；0.1.1 改用 Node 內置 https 後，Windows / macOS / Linux 均正常。
參考¶
- GitHub：https://github.com/badai147/dsh-ocgo-usage
- 目錄頁：已覈實資料中未給出可確認的目錄頁 URL；如需使用，請以插件來源頁面提供的鏈接爲準。
