前言¶
在 DeepSeek Harness（DSH）的插件体系里，扩展 LLM 提供方通常需要在 harness 的 LLM 接缝中注册对应路由、处理请求协议和模型目录。dsh-llm-opencode 面向这个环节：它为 DSH 增加 OpenCode Zen 提供方，使 DSH 中的编码任务可以选择 OpenCode Zen 免费模型，且免费模型不需要配置 API key。
这是什么¶
dsh-llm-opencode 是 bobowsh 维护的 DSH 插件，采用 MIT 许可证。
它的主要用途是在 DSH 的 LLM 接缝中注册 opencode-zen 提供方路由，并把 DSH 的请求翻译成 OpenAI 兼容的 chat completions 请求。插件同时处理 OpenCode Zen 的客户端身份校验和免费模型目录同步。
核心能力¶
- 在 DSH 的 LLM 接缝中注册
opencode-zen提供方路由。 - 支持 OpenCode Zen 免费模型；免费模型无需 API key。
- 内置免费模型目录，并在插件加载时后台从网关和
models.dev同步。 - 支持从网关
/models自动发现带free标记的模型。 - 将 harness 请求翻译为 OpenAI 兼容
chat completions请求，并解析 SSE 流式响应。 - 付费模型可通过
OPENCODE_API_KEY凭证或环境变量配置 API key。 - 可通过 DSH Web 设置或
settings.yaml的llm-opencode节覆盖baseURL、maxTokens、models、autoSyncModels等配置。 - 随附
cordis.patch.yml，用于把插件注册进 DSH bundle 加载器。 - 纯文本请求受支持；图片内容会被
UNSUPPORTED_CONTENT拒绝。 - 请求会携带
User-Agent: opencode/1.0.0等头，以满足 OpenCode Zen 客户端身份校验；默认的deepseek-harnessuser-agent 会被网关拒绝。
安装与启用¶
先确认 DSH 版本满足要求：
DeepSeek Harness >= 0.1.0-rc.7
@deepseek-ai/cordis ^4.0.1（peer dependency）
然后从 npm 安装：
dsh plugin --profile web add dsh-llm-opencode
也可以直接从 GitHub 安装：
dsh plugin --profile web add "github:bobowsh/dsh-llm-opencode#main"
安装完成后，在 DSH Web 设置 → 模型中选择 OpenCode Zen 作为提供方。随附的 cordis.patch.yml 会用于把插件注册进 DSH bundle 加载器，使插件作为当前 DSH profile 的一部分参与加载。
典型用法¶
1、把插件装进 DSH 的 web profile：
dsh plugin --profile web add dsh-llm-opencode
2、打开 DSH Web 设置 → 模型，选择 OpenCode Zen 作为提供方。
3、选择一个免费模型，例如 deepseek-v4-flash-free，直接开始编码。免费模型无需 API key。
4、如果需要使用付费模型，在 DSH 凭证中设置 OPENCODE_API_KEY，或将其作为环境变量导出：
export OPENCODE_API_KEY="..."
5、如需覆盖默认行为，可在 DSH Web 设置或 settings.yaml 的 llm-opencode 节中配置 baseURL、maxTokens、models、autoSyncModels 等字段。
适用场景与注意¶
适合以下场景：
- 在 DSH 中使用 OpenCode Zen 免费模型。
- 希望免费模型不配置 API key。
- 需要在 DSH 的 LLM 接缝中接入 OpenAI 兼容
chat completions和 SSE 流式响应。
使用前需要注意：
- 免费模型由 OpenCode Zen 公共网关提供服务，可用性可能变化。
- 免费模型无需 API key；付费模型需要 API key。
- 仅支持纯文本请求；图片内容会被
UNSUPPORTED_CONTENT拒绝。 - OpenCode Zen 网关会校验客户端身份；默认的
deepseek-harnessuser-agent 会被拒绝，插件会携带User-Agent: opencode/1.0.0等头。 - 启动目录同步失败时保留内置目录；设置中自定义的
models列表永不被覆盖。 - 环境要求：DeepSeek Harness
>= 0.1.0-rc.7；@deepseek-ai/cordis ^4.0.1（peer dependency）。 - 插件以当前
dsh进程权限运行；安装前应检查源码与许可证。许可证为 MIT ©bobowsh。
参考¶
目录页：https://www.skillhub.cn/plugins/bobowsh/dsh-llm-opencode
GitHub：https://github.com/bobowsh/dsh-llm-opencode
