dsh-llm-opencode-go-live：DeepSeek Harness 的 OpenCode Go 動態模型目錄插件

前言¶

DeepSeek Harness (DSH) 採用插件化架構來擴展功能。在集成 OpenCode Go 模型時，手動維護模型列表和路由配置較爲繁瑣。dsh-llm-opencode-go-live 插件解決了這一問題，它從 Models.dev 實時同步 opencode-go 目錄，註冊獨立的路由，並提供了設置卡片與訂閱監控面板。

這是什麼¶

這是一個爲 DeepSeek Harness 提供的模型推理插件，由 SkylerFee 維護，採用 MIT 許可證。

該插件的核心職責包括：
* 從 Models.dev 讀取 opencode-go 模型列表
* 註冊獨立的 opencode-go-live 路由
* 貢獻其自己的 Models 設置卡片
* 使用 pi-ai 進行模型請求

核心功能¶

動態目錄同步：插件會自動從 Models.dev 獲取最新的模型列表。
獨立路由：除了內置的 opencode-go 路由外，該插件註冊了專用的 opencode-go-live 路由，兩者互不影響。
設置卡片：在 DSH 的設置頁面中，該插件擁有獨立的配置卡片，用於管理 API 密鑰。
訂閱監控面板：提供浮動面板顯示 OpenCode Go 的訂閱使用情況。該面板在鼠標懸停時展開，鼠標離開時摺疊，且可通過開關控制顯示。
請求處理：基於 pi-ai 服務處理模型請求。

安裝與啓用¶

插件需要 DeepSeek Harness 0.1.7-rc.1 或更新版本，以及 Node.js 22.19 或更新版本。

在 Web 配置文件下安裝插件：

    dsh plugin --profile web add @skylerfee/dsh-llm-opencode-go-live

安裝並啓用後，重啓 Web 配置文件。
打開 設置 -> 模型。
點擊插件擁有的 OpenCode Go (Live) 卡片中的編輯。
輸入您的 API 密鑰並應用。

典型用法¶

在模型選擇器中，進入 opencode-go-live 組別，選擇一個模型即可發起請求。
DSH 會通過其憑證服務存儲該密鑰，默認引用爲 OPENCODE_GO_LIVE_API_KEY。

依賴與注意事項¶

依賴項：
- 需要主機提供 @earendil-works/pi-ai ^0.87.1。
- 需要 DeepSeek Harness 0.1.7-rc.1 或更新版本。
- 需要以下 peer 依賴：@deepseek-ai/cordis ~4.0.4 || ~4.0.5-alpha.1、@deepseek-ai/dsh-credentials、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-llm-pi-ai 和 @deepseek-ai/dsh-settings。
運行狀態：
- 目前僅已在 macOS 上驗證。Linux 和 Windows 尚未運行。
行爲細節：
- 刷新目錄失敗時，會保留最後一次成功的目錄快照。
- 若沒有目錄，提供者可見但沒有實時模型。
- 沒有憑證的調用會返回 MISSING_CREDENTIAL。
- 可見的模型並不代表上游 API 已授權其請求。
- 數據源：主機在調用時會查詢 https://opencode.ai/zen/go/v1/usage 接口獲取訂閱數據。

總結¶

該插件通過自動化目錄同步和獨立的路由配置，簡化了 OpenCode Go 模型在 DSH 中的接入流程。結合訂閱監控面板，便於開發者追蹤資源消耗。項目地址：GitHub