dsh-go-usage：DeepSeek Harness 中的 OpenCode GO 訂閱用量監控

在 DeepSeek Harness (DSH) 的開發環境中，直接查看 OpenCode GO 的訂閱用量通常需要切換到外部控制台頁面，這增加了上下文切換的開銷。dsh-go-usage 插件通過在 DSH Web 界面右下角展示角標組件，將用量監控直接集成到開發流中。

插件定位¶

這是一個 DSH Web 插件，由開發者 shsr07 維護。它將 OpenCode GO 的滾動/每週/每月用量百分比與重置倒計時，以摺疊式角標的形式呈現，使開發者無需離開當前頁面即可掌握資源消耗情況。

核心功能¶

多維度用量展示：支持滾動、每週、每月三種用量桶，數據邏輯與 OpenCode 官方控制台保持一致。
可視化狀態反饋：進度條顏色隨用量變化。達到 80% 時變爲琥珀色，達到 100% 時變爲紅色（表示觸發限流）。
實時倒計時：顯示重置倒計時（格式如 “Resets in X days X hours”），每 15 秒更新一次數值。
自動刷新機制：界面每 60 秒自動重新獲取數據，同時也提供了手動刷新按鈕。
交互與主題適配：支持收起爲右邊緣的豎條標籤，點擊即可展開；界面會跟隨 DSH 的主題（淺色/深色模式）自動調整顏色。

安裝與啓用¶

前置要求¶

Windows 操作系統（插件通過 PowerShell 獲取數據）。
Node.js >= 24 和 pnpm。
DeepSeek Harness 已安裝。
本地 auth.json 中包含 opencode-go API 密鑰（通常位於 %USERPROFILE%\.local\share\opencode\auth.json）。

安裝步驟¶

使用 npm 包安裝：

dsh plugin --profile web add dsh-go-usage

從源碼安裝¶

如果需要從 GitHub 源碼安裝或進行本地開發：

git clone https://github.com/shsr07/dsh-go-usage.git
cd dsh-go-usage
pnpm install
pnpm build
dsh plugin --profile web add link:<絕對路徑>

安裝完成後，重啓 Web 服務：

dsh web

在瀏覽器中打開 DSH Web 界面，查看頁面右下角。初始狀態下會顯示用量卡片，點擊卡片上的 » 按鈕可將其收起爲右邊緣的豎條標籤。

配置說明¶

插件提供可選配置項，位於 cordis.patch.yml 中的插件行內。默認配置通常可直接使用，如需自定義可添加 config: 塊：

- id: go-usage
  name: 'dsh-go-usage'
  config:
    authJsonPath: 'C:\Users\me\.local\share\opencode\auth.json'
    apiUrl: 'https://opencode.ai/zen/go/v1/usage'
    powershellExe: 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'
    timeoutSec: 15

配置項	類型	默認值	說明
`authJsonPath`	string	`$USERPROFILE/.local/share/opencode/auth.json`	本地 opencode 認證文件路徑。
`apiUrl`	string	`https://opencode.ai/zen/go/v1/usage`	OpenCode GO 用量 API 端點。
`powershellExe`	string	`C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`	用於獲取數據的 PowerShell 執行路徑。
`timeoutSec`	number	`15`	API 請求超時時間（秒）。

注意事項¶

平臺限制：目前僅支持 Windows 系統。
隱私安全：API 密鑰僅在本地讀取，從機器上的 auth.json 中提取，不會發送至其他服務器。發送至 opencode.ai 的僅包含用量百分比和重置時間戳。
許可證：遵循 MIT 許可證，建議安裝前檢查源碼。

總結¶

dsh-go-usage 通過將 OpenCode GO 的用量監控無縫集成到 DSH 的日常開發流中，提供了直觀的視覺反饋和便捷的摺疊交互。對於依賴 OpenCode GO 訂閱進行開發或測試的用戶，這是一個實用的工具。

項目主頁：https://github.com/shsr07/dsh-go-usage
插件目錄：https://www.skillhub.cn/plugins/shsr07/dsh-go-usage