前言¶
在 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,因此不在此列出目录页链接。