前言¶
在 DSH 的插件式組織方式下,LLM provider 可以作爲一個 bundle 裝入指定 profile。對於需要在 DSH web profile 中使用 opencode-go 模型路由的場景,dsh-opencode-go-provider 提供了一個圍繞 OpenCode Go gateway 的 provider bundle。
下面介紹它的定位、運行要求、安裝方式,以及已給出示例的用法。
這是什麼¶
dsh-opencode-go-provider 是 edynasty 維護的 LLM provider 插件,許可證爲 MIT。它面向 DeepSeek Harness(DSH)rc.6,提供單一的 opencode-go 模型路由,幷包含 Web Connect 設置卡片、stale-while-revalidate 模型目錄和安全診斷命令。
需要特別說明:該插件是 community software,未發佈到 npm;npm registry 不是安裝路徑。支持的安裝方式是把 commit-pinned Git dependency 加入 DSH profile。
它也聲明不與 DeepSeek、OpenCode 或任何模型服務商存在從屬、背書或贊助關係。
運行要求¶
使用這個插件前,需要先確認以下環境:
- DSH
rc.6 - Node.js
^22.19.0 || >=24.0.0 - corepack 管理的 pnpm
11.7.0 - 一個 OpenCode Go API key
憑據引用名爲:
OPENCODE_GO_API_KEY
按照已覈實說明,這個 API key 只通過 DSH credentials service 存儲和解析,不會寫入設置、模型目錄、日誌、錯誤信息或包內容。
核心能力¶
這個插件主要提供以下能力:
- 一個 provider 路由:
opencode-go,用於 OpenCode Go gateway。 - Web Connect 設置卡片:可以 connect、test the connection、run diagnostics 和 disconnect。
- stale-while-revalidate 模型目錄:包含 embedded catalog、background refresh、offline fallback 和 quarantine。
- 安全診斷命令:
status、doctor、migration-dry-run、migration-apply。 - 憑據處理:
OPENCODE_GO_API_KEY只通過 DSH credentials service 處理。
安裝與啓用¶
安裝命令會把這個倉庫以固定 commit 的形式加入 DSH web profile:
dsh plugin --profile web add github:edynasty/dsh-opencode-go-provider#d2a447610a5dff4006ac966525effd9669342a78
如果後續需要移除,可以使用下面的卸載命令:
dsh plugin --profile web remove dsh-opencode-go-provider
典型用法¶
在 Web 側,可以直接使用 Connect 設置卡片完成連接、測試連接、診斷和斷開操作。
connect 和 disconnect 是 Host-only 操作;獨立 bin 會拒絕執行它們,因爲 DSH credential store 由運行中的 Host 管理。
如果舊配置中手工維護過 opencode-go 路由,可以先做遷移檢查,再執行遷移。下面的命令示例操作一個 settings.yaml:
dsh plugin --profile web exec dsh-opencode-go-provider migration-dry-run <settings.yaml>
檢查完成後,可以應用遷移:
dsh plugin --profile web exec dsh-opencode-go-provider migration-apply --revision <64-hex> <settings.yaml>
也可以直接調用插件入口:
dsh plugin --profile web exec dsh-opencode-go-provider
如果從源碼倉庫做本地檢查,可以按倉庫給出的本地 gate 執行:
corepack enable
pnpm install --frozen-lockfile
pnpm run check
適用場景與注意¶
這個插件適合在 DSH web profile 中需要 opencode-go provider 路由、Web Connect 設置卡片和模型目錄管理的場景。
它不適合作爲 npm 包安裝,也不建議繞過 DSH profile 直接把它當作普通 Node.js 依賴使用。
安裝前應確認 DSH 版本、Node.js 版本、pnpm 版本和 OpenCode Go API key 都滿足要求。由於插件會隨當前 dsh 進程權限運行,並涉及 provider 配置、憑據引用和診斷命令,安裝前建議檢查倉庫源碼、許可證、依賴和診斷行爲;採用前應確認其 MIT 許可證條款。
鏈接¶
GitHub 倉庫:
https://github.com/edynasty/dsh-opencode-go-provider
本次已覈實資料沒有給出獨立的社區目錄頁 URL,因此不在此列出目錄頁鏈接。