@dong-victor/dsh-opencodego-usage：DSH Web 插件查看 OpenCode Go 套餐餘額

在 DeepSeek Harness (DSH) Web 環境中，查看 OpenCode Go 套餐的剩餘額度通常需要手動檢查或進入設置。此插件通過在側邊欄直接顯示用量與倒計時，併爲 Agent 提供查詢工具，提供了一種即時的狀態可視化方案。

核心功能¶

插件包含以下功能：

側邊欄展示：自動在側邊欄顯示 rolling（5小時）、weekly（周）、monthly（月）三檔用量百分比與倒計時。
中央面板：點擊條目打開中央列面板，展示狀態徽章、重置時間、詳細進度條及每秒跳動的倒計時。
Agent 工具：提供 opencode_go_balance 工具，助手可直接回答套餐剩餘額度。
數據緩存與防護：內存緩存 30s TTL，API 路由帶回環防護（僅本機/同源），密鑰僅用於本機請求，響應返回掩碼 keyHint。
自動刷新：60秒自動刷新余額數據。

安裝¶

使用以下命令安裝插件：

dsh plugin --profile web add @dong-victor/dsh-opencodego-usage

安裝後需重啓 dsh web 使新的 bundle 層生效。

配置¶

插件支持可選配置項，在 cordis.patch.yml 的 config 字段中設置：

- insert:
    - id: opencode-go
      name: '@dong-victor/dsh-opencodego-usage'
      config:
        enabled: true
        announceToAgent: true
        # apiBaseUrl: 'https://opencode.ai'
        # apiKeyEnv: 'OPENCODE_GO_API_KEY'
        # cacheTtlMs: 30000
        # timeoutMs: 15000

前置條件¶

插件複用 DSH 已有的 LLM 接線，依賴 llm-pi-ai 的 opencode-go 路由配置。
密鑰通過 OPENCODE_GO_API_KEY 憑據引用提供（非 DEEPSEEK_API_KEY）。
端點默認爲 https://opencode.ai。

技術架構¶

宿主半面 (lib/index.js)：提供 GET /api/dsh-opencode-go/balance 迴環防護接口，解析密鑰與端點，註冊 Agent 工具與提示詞。
瀏覽器半面 (lib/client.js)：純 JS 零構建依賴，通過 MutationObserver 實現自愈，支持 React 重渲染適配。

開發與測試¶

插件依賴 @deepseek-ai/dsh-tools (peer 依賴)，測試需安裝 jsdom：

npm install
npm test

使用示例¶

查看餘額：打開 DSH Web，側邊欄「Go 餘額」條目直接顯示進度與倒計時。
Agent 查詢：在對話中詢問「opencode Go 套餐還剩多少」，Agent 會調用工具返回結果。