dsh-plugin-opencode-usage：OpenCode Go 訂閱用量懸浮面板

前言¶

DeepSeek Harness (DSH) 旨在通過插件化架構擴展功能。OpenCode Go 提供了滾動、每週和每月的訂閱額度，但官方接口通常不提供直觀的 Web 前端展示。該插件在 DSH Web 側邊欄的會話窗口左下角註冊了一個獨立的懸浮入口，用於展示這些訂閱的用量百分比和重置時間。

核心功能¶

• 獨立入口：懸浮按鈕位於會話窗口左下角，不佔用側邊欄入口或輸入框，避免與其他插件衝突。
• 用量展示：點擊按鈕彈出面板，展示滾動用量、每週用量、每月用量三個窗口。
• 數據細節：每張卡片顯示已用百分比、剩餘百分比以及重置時間。
• 面板定位：面板以按鈕爲錨點，左邊緣對齊按鈕，底部位於按鈕上方 12px，隨會話窗口或側邊欄變化自動調整。
• 自動刷新與關閉：打開期間每 60 秒自動刷新；支持 Esc 鍵或點擊面板外部關閉。
• 安全機制：API Key 僅在 Harness host 進程內解析，不會下發到瀏覽器。

安裝與啓用¶

1. 使用 npm 安裝插件：

dsh plugin --profile web add dsh-plugin-opencode-usage

2. 確認憑據。在 ~/.dsh/.credentials.yaml 中確認存在 OPENCODE_GO_API_KEY。

3. 可選：在 profile 的 cordis.patch.yml 中覆蓋 opencode-usage 條目，配置憑據引用和 API 地址：

- id: opencode-usage
  config:
    credentialRef: OPENCODE_GO_API_KEY
    apiBaseUrl: https://opencode.ai/zen/go/v1
    cacheMs: 30000

4. 重啓 dsh web 並刷新頁面。在會話窗口左下角會出現獨立的 “OpenCode Go 用量” 懸浮入口。

適用場景與限制¶

• 適用場景：使用 OpenCode Go 訂閱並在 DSH Web 環境下工作的開發者。
• Profile 限制：僅適用於 web profile，headless 模式下不註冊路由。
• 依賴要求：
• Node.js: ^22.19.0 || >=24.0.0
• DSH: >=0.1.5-rc.1 <0.2.0-0
• 安全說明：插件的 API 調用繼承 Webserver 的綁定地址。默認 profile 綁定 127.0.0.1，只有本機可訪問；若將 webServer.config.host 改爲 0.0.0.0，同一局域網內可讀取用量百分比。API Key 本身不會離開 host 進程。