前言¶
DeepSeek Harness（DSH）採用插件化架構，允許開發者在不修改核心代碼的情況下擴展功能。在 Web 界面使用 OpenCode Go 進行開發時，開發者需要時刻關注 API 用量。常規做法通常是進入設置頁面查看，或者依賴外部工具，這會打斷工作流。本插件旨在解決這一問題，它將 OpenCode Go 的用量讀數條直接掛載在輸入框下方，與輸入欄同寬，確保在編寫代碼時能隨時看到用量狀態。
插件定位¶
這是一個 DeepSeek Harness 的 Web GUI 插件，由用戶 xv-chang 維護。它不依賴 OpenCode CLI 工具，完全基於 DSH 的運行時環境工作。該插件讀取 OpenCode Go 的套餐用量數據，並將其可視化爲三個維度的進度條常駐顯示在聊天界面的輸入框下方。
核心功能¶
- 常駐顯示：插件註冊在
conversation.composer.dock槽位（order 10），與 DSH 出廠的統計行並列，寬度嚴格對齊輸入框。 - 三檔用量窗口：分別顯示滾動（5小時）、每週、每月三個維度的用量百分比及重置時間。
- 健康度指示：根據用量百分比顯示不同顏色的圓點。綠色表示 <60%，黃色表示 60–85%，紅色表示 ≥85%。
- 交互詳情：鼠標懸停時，Tooltip 會顯示當前窗口的名稱、限額與重置時間。
- 手動刷新：提供小刷新按鈕，允許用戶手動觸發一次用量數據的重新請求。
- 靜默回退：當未配置 opencode-go 提供商或未找到 API Key 時，整條組件完全不渲染，避免界面噪音；僅在出現網絡、HTTP 或解析錯誤時顯示錯誤行和重試按鈕。
- 國際化：支持中英雙語，界面語言跟隨 DSH 設置。
安裝與啓用¶
安裝該插件需要使用 web profile。
dsh plugin --profile web add github:xv-chang/dsh-opencode-go-usage-dock
安裝完成後，重啓 dsh web 進程，使 Host 半與服務端的 client bundle 生效。該插件會在安裝時自動嘗試註冊爲 profile layer（需版本 0.1.2+）。
配置與典型用法¶
在使用前，需確保 DSH 中已配置好 OpenCode Go 的服務端點。
- 添加提供商：在 DSH 設置中找到“模型”選項，添加
opencode-go提供商。 - 配置 API Key：在憑據庫中配置有效的 OpenCode Go API Key（格式通常爲
sk-opencode-…）。 - 打開會話：插件槽位屬於會話作用域，必須先打開任意一個聊天會話，用量條纔會出現。
- 調整配置（可選）：如果默認接口地址或超時時間不滿足需求，可在插件配置中修改。
- id: opencode-go-usage-dock
name: dsh-opencode-go-usage-dock
config:
baseUrl: https://opencode.ai/zen/go/v1/usage # 默認值
timeoutMs: 15000 # 默認值
注意事項¶
- pnpm 警告：安裝時可能會出現 pnpm peer dependencies 警告（如缺少 react 或 @deepseek-ai/*），這屬於正常現象，可以忽略。這些依賴由 DSH 運行時提供。
- 401 錯誤：如果提示 “API Key 無效或已過期 (401)”，說明 API Key 錯誤或已過期，需前往 OpenCode 後臺重新簽發並更新憑據。
- 限額參考性：Tooltip 中顯示的限額數字跟隨 OpenCode Go 套餐，僅供參考；接口響應本身不包含限額數據。
- 無 CLI 依賴：本插件是 DSH 特性，不讀取任何 OpenCode CLI 的配置文件或本地憑據。
結語¶
該插件通過將用量監控下沉到輸入欄下方，實現了對 OpenCode Go 套餐用量的即時掌控，減少了切換頁面的操作成本。若需查看更多插件詳情或源碼，請訪問其 GitHub 倉庫。
