dsh-opencode-go：DeepSeek Harness 的 OpenCode Go 和 Zen 實時目錄插件

下面介紹 dsh-opencode-go 插件。DeepSeek Harness（DSH）支持通過插件擴展功能。在管理 OpenCode Go 和 Zen 等模型時，動態獲取最新的模型列表、代幣費率、協議支持以及零費率限制是常見需求。dsh-opencode-go 插件旨在解決這些問題，它爲 DSH 提供了 Live OpenCode Go 和 Zen 目錄，包括當前代幣費率、零費率過濾器、協議選擇和會話親和性頭部。

功能定位¶

該插件屬於“模型推理”類別，由 gosomea 維護。它通過公共提供商 API，將 OpenCode Go 和 Zen 的模型目錄集成到 DSH 中。

核心功能¶

插件主要提供以下能力：

Live OpenCode Go and Zen catalogs：獲取最新的模型列表。
Token rates：顯示當前費率（輸入、輸出、緩存讀/寫）。
Zero-rate filters：支持零費率過濾。
Protocol selection：允許選擇協議。
Session affinity headers：通過 HTTP 頭部處理會話親和性。
KV Cache effect：利用會話親和性支持 KV 緩存。

安裝與配置¶

1. 構建與打包¶

在項目源碼目錄下執行以下命令進行構建和打包：

npm run build
npm pack

2. 安裝插件¶

使用構建生成的 tarball 文件安裝插件：

dsh plugin --profile web add /absolute/path/foreveryu-dsh-opencode-go-0.1.2.tgz

3. 配置提供者¶

安裝後，需要在 DSH 配置中設置 API Key 環境變量。配置示例如下：

opencode-go.providers: {
  opencode-go: {
    apiKeyEnv: OPENCODE_GO_API_KEY
  }
}

使用方法¶

打開 Settings → Models → OpenCode Go / Zen。
可以手動刷新、按模型 ID/名稱搜索，或啓用零費率過濾器。
配置完成後，提供者的模型會自動出現在列表中。

技術細節與注意事項¶

API 端點：Go 和 Zen 使用不同的 /models 列表，分別位於 /inference/go/v1 和 /inference/v1 端點。
數據來源：HTTP 傳輸、流式、工具、圖像和推理轉換均使用 DSH 的 PiAiAdapter。
緩存位置：緩存文件位於 $DSH_HOME/plugins/dsh-opencode-go/catalog-v1.json，該文件僅包含公共元數據。
休眠狀態：未配置的插件處於休眠狀態，不會生效。

系統要求與限制：

DSH 版本：支持 DeepSeek Harness 0.2.0-rc.2 和 0.2.1-alpha.3。
Node 版本：Node.js 版本必須滿足 ^22.19 || >=24。
包名差異：該項目的未限定範圍 npm 名稱（dsh-opencode-go）屬於不同作者，項目僅發佈於 @foreveryu/dsh-opencode-go 下。
遷移審查：自定義提供商端點或協議覆蓋需要在遷移前進行審查。
技能依賴：刷新、修復和遷移功能需要對應的技能支持（位於 $DSH_HOME/skills/dsh-opencode-go）。
輸入限制：插件僅支持 DSH 的文本和圖像輸入。

總結¶

dsh-opencode-go 通過提供實時目錄和過濾能力，簡化了 OpenCode Go 和 Zen 模型的管理。有關更多細節，請參閱GitHub 倉庫。