dsh-llm-opencode-go：DeepSeek Harness 的 OpenCode Go 模型推理插件

前言¶

DeepSeek Harness (DSH) 採用插件化架構，允許開發者通過組件擴展推理能力。針對 OpenCode Go 的模型接入，需要專門的適配器。dsh-llm-opencode-go 插件解決了在 DSH 環境中調用 OpenCode Go 服務的問題，它將 OpenCode Go 的協議與 DSH 的標準接口進行了橋接。

這是什麼¶

dsh-llm-opencode-go 是一個 DeepSeek Harness 插件，由用戶 NOirBRight 維護。它是一個 OpenCode Go 的集成層，旨在讓 DSH 能夠調用 OpenCode Go 的模型進行推理。該插件使用共享的 pi-ai adapter 處理聊天交互，同時利用原生 Go 端點處理模型發現和訂閱使用等非聊天協議功能。

核心功能¶

混合協議支持：聊天使用共享 pi-ai adapter，根據模型配置，支持 OpenAI Completions、Responses 和 Anthropic Messages 三種協議。
原生端點訪問：模型發現（GET /zen/go/v1/models）和訂閱使用情況檢查（GET /zen/go/v1/usage）通過原生 Go 端點實現，不依賴聊天協議。
Web 配置界面：在 Settings → LLM Providers 下提供卡片配置入口，支持設置 API Key、Base URL 和模型列表。
能力支持：支持視覺（Vision）和思考（Thinking）能力。
路由與加載：Host 路由爲 opencode-go，Loader entry 爲 llm-opencode-go。

安裝與啓用¶

安裝前需確保 DSH 版本兼容（支持 0.1.7-alpha.2 及以上），並安裝 dsh-llm-providers-ui 以在 Web 模式下顯示配置頁面。

dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-providers-ui/releases/download/v0.2.13/dsh-llm-providers-ui-0.2.13.tgz
dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-opencode-go/releases/download/v0.1.34/dsh-llm-opencode-go-0.1.34.tgz
dsh web

典型用法¶

安裝完成後，在 Web 界面配置插件。API 密鑰可通過環境變量 OPENCODE_API_KEY 設置。

設置 API Key：在 LLM Providers 設置中配置，通過 apiKeyEnv: OPENCODE_API_KEY 引入環境變量。
選擇協議類型：爲每個模型配置 api 字段，例如選擇 openai-responses。
獲取模型列表：通過 Host 端點 GET /zen/go/v1/models 獲取可用模型及其上下文窗口、視覺和思考能力。
檢查訂閱使用：通過 Host 端點 GET /zen/go/v1/usage 檢查剩餘配額。

適用場景與注意¶

該插件適合需要在 DSH 中統一管理 OpenCode Go 模型資源的開發者。

Web 模式依賴：在 Web 模式下，必須安裝 dsh-llm-providers-ui 才能顯示 Providers 頁面和該插件卡片，否則僅保留命令行路由能力。
環境變量配置：API Key 僅支持通過環境變量注入，不支持在配置文件中明文寫入。
已知限制：
- CodexHub 鎖文件衝突：如果存在 CodexHub 生成的鎖文件，可能會阻塞 DSH 的憑證操作。
- 參數不支持：GenerateOptions.stop 參數不被共享的 PiAiAdapter 支持。
- 註冊衝突：插件不調用 registerConfigurableProviders，這表明它與 llm-pi-ai 存在目錄或功能上的重疊。

短結尾¶

dsh-llm-opencode-go 提供了 OpenCode Go 模型在 DSH 中的標準接入方案。通過配置環境變量和原生端點，開發者可以充分利用該模型的視覺與思考能力。更多細節請參考項目主頁。