前言¶
DeepSeek Harness (DSH) 的核心设计理念之一是「一切皆插件」。在使用 DSH 进行模型推理时,接入外部模型通常需要 API 密钥、注册账号或维护额外的进程。dsh-plugin-adapter 解决了这个问题,它将 OpenCode Zen 的匿名免费车道模型注册为 DSH 的原生 LlmAdapter,使这些模型无需密钥、无需注册即可直接在 DSH 的模型选择器中使用。
是什么¶
dsh-plugin-adapter 是一个为 DeepSeek Harness 提供的插件,用于直接接入 OpenCode Zen 的免费模型资源。
- 核心价值:Free OpenCode Zen models, natively inside DSH (DeepSeek Harness). No API key. No registration. No extra process.
- 维护者:1624318455
- 解决痛点:绕过了传统接入外部 API 需要的密钥管理和流程,利用 Zen 的匿名免费车道进行推理。
核心功能¶
该插件提供了以下能力:
- 零凭证、零设置:直接使用 OpenCode 的匿名免费车道,无需配置 API Key。
- 原生适配器:注册为 DSH 原生
LlmAdapter,不依赖 Sidecar 进程或本地端口。 - CLI 相似伪装:发出的请求头与 OpenCode CLI 保持一致(如 User-Agent 和会话标识),确保请求符合上游要求。
- 可选择思考级别:支持 Off/Minimal/Low/Medium/High 的思考强度选择,在 DSH 模型选择器中配置。
- 实时目录与回退:提供带有回退链的实时模型目录,支持自愈机制。
- 错误处理:能够将上游的限流、认证、超时等错误以清晰的分类返回给 DSH。
安装与启用¶
使用官方命令进行安装:
dsh plugin --profile web add github:1624318455/dsh-plugin-adapter
安装完成后,重启 dsh web,打开模型选择器,即可在 zen-free 组中看到可用的模型。
典型用法¶
默认配置即可使用。如需调整,可在对应 Profile 的 cordis.patch.yml 中覆盖配置:
- id: opencode2dsh
name: '@memef1f1y/dsh-plugin-adapter'
config:
mode: adapter # 使用原生适配器模式
providerId: zen-free # 在 DSH 中显示的提供商名称
适用场景与注意¶
- 环境要求:
- 需要运行 DeepSeek Harness (DSH) 并开启 Web Profile。
- 系统需安装 Node.js ≥ 20。
- 需要出站 HTTPS 连接至
opencode.ai和models.dev。
- 注意事项:
- Sidecar 模式是遗留模式,不包含在发布的插件包中。如需使用 Sidecar 模式,需自行构建
legacy/agent。 - 插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证。
- Sidecar 模式是遗留模式,不包含在发布的插件包中。如需使用 Sidecar 模式,需自行构建
总结¶
dsh-plugin-adapter 通过原生适配的方式,让 DSH 用户能够无缝访问 OpenCode Zen 的免费推理能力。它简化了接入流程,同时提供了完善的错误处理和模型目录管理。
- 项目主页:https://github.com/1624318455/dsh-plugin-adapter
- 插件目录:https://www.skillhub.cn/plugins/1624318455/dsh-plugin-adapter