前言¶

DeepSeek Harness（DSH）採用「一切皆插件」的架構。在使用 OpenCode Go 進行開發時，頻繁切換瀏覽器查看訂閱配額與花費會打斷工作流。willwhi/dsh-opencode-go-meter 插件將 OpenCode Go 的用量監控（5小時滾動/每週/每月）與真實花費金額直接集成到對話輸入區，並在彈窗內提供登錄與憑據配置功能，無需接觸終端或修改代碼。

插件定位¶

這是一個 DeepSeek Harness（dsh）Web 界面插件，由 willwhi 維護，採用 MIT 協議。它解決了在本地開發時查看 OpenCode Go 訂閱狀態和成本的需求。

核心功能¶

• 用量與花費監控：顯示 5小時滾動窗口、每週、每月三個維度的訂閱使用量（百分比）與重置倒計時，並直接顯示本月真實花費（美元）。
• 數據來源：支持雙數據源自動回退，優先使用官方配額 API，失敗時自動回退至儀表盤 SSR 數據。
• 憑據安全：API Key 和 Cookie 僅在 Host 進程中使用，瀏覽器只讀取同源 JSON 端點，不會發送給瀏覽器或記錄日誌。
• 開箱即用：未配置時顯示 <noconfig>，點擊按鈕即可彈出登錄表單進行配置。
• 輕量級設計：前端 30 秒輪詢，Host 端 60 秒緩存及失敗冷卻機制。

安裝與啓用¶

安裝命令

dsh plugin --profile web add dsh-opencode-go-meter

前置要求
* DeepSeek Harness (web profile) 版本需在 0.1.0-rc.6 或更高。
* 系統環境變量 PATH 中需包含 pnpm（插件依賴）。
生效步驟
1. 執行上述安裝命令。
2. 重啓 dsh web 進程（結束當前進程並重新啓動）。
3. 在瀏覽器中強制刷新頁面（Ctrl+Shift+R）。

使用方式¶

• 查看摘要：在對話輸入區下方，可以看到三個窗口的使用率百分比及本月花費。
• 查看詳情：點擊輸入框內的「Go 用量」按鈕，彈出詳情窗口，包含進度條、重置倒計時及按天費用明細柱狀圖。
• 刷新與更新：彈窗右下角提供手動刷新功能；如需更新憑據，點擊彈窗內的「登錄」即可。

注意事項¶

• 卸載殘留：執行卸載命令不會刪除 ~/.dsh/opencode-go-meter.json 和 auth.json，憑據保留在本地。
• 權限安全：插件讀取的 auth cookie 是完整的 OpenCode 用戶會話，僅用於 Host 側抓取數據，絕不發送給瀏覽器或寫入日誌。
• 適用範圍：本插件僅適用於 DSH 的 Web Profile，需確保本地已安裝 OpenCode Go CLI（可選，若已安裝可自動讀取 Key）。

總結¶

該插件通過在 DSH 界面內集成監控，簡化了資源管理流程。更多細節可參考 GitHub 倉庫 或 社區目錄。