dsh-llm-opencode

August 29, 2026 · View on GitHub

DeepSeek Harness（DSH）的 OpenCode Zen 免费模型提供方适配器。

在 DSH 的 LLM 接缝中注册 opencode-zen 提供方路由，让你的编码 agent 直接使用 OpenCode Zen 的免费模型——免费模型无需 API key，无需信用卡，零配置开箱即用。

免费模型

内置目录（2026-08-29 已对网关 + models.dev 核实；每次启动自动刷新，每周六 CI 定时同步）：

模型	ID	上下文	最大输出	备注
DeepSeek V4 Flash Free	`deepseek-v4-flash-free`	200K	128K	DeepSeek V4 Flash，SWE-bench 约 79%
Nemotron 3 Ultra Free	`nemotron-3-ultra-free`	1M	128K	NVIDIA 旗舰，超大上下文
Nemotron 3.5 Lightning Free	`nemotron-3.5-lightning-free`	128K	128K	NVIDIA 快速版
MiMo V2.5 Free	`mimo-v2.5-free`	200K	32K	小米编码模型
Hy3 Free	`hy3-free`	190K	64K	腾讯混元 HY3
Laguna S 2.1 Free	`laguna-s-2.1-free`	256K	32K
Muse Spark 1.2 Free	`muse-spark-1.2-contributor-free`	128K	128K
Ling 3.0 Flash Fin Free	`ling-3.0-flash-fin-free`	128K	128K	金融向免费模型（models.dev 未声明上下文/输出上限，按 128K 兜底）
Big Pickle	`big-pickle`	200K	32K	隐身通用模型

免费模型由 OpenCode Zen 公共网关提供服务，可用性可能变化；适配器会从 /models 端点自动发现带 free 标记的模型，内置目录也会在每次启动时后台重新同步（见下文「启动目录同步」）。

安装

# 从 npm 安装（预构建，推荐）
dsh plugin --profile web add dsh-llm-opencode

# 或直接从 GitHub 安装
dsh plugin --profile web add "github:bobowsh/dsh-llm-opencode#main"

快速上手

把插件装进你的 DSH profile（见上文）。
打开 DSH Web 设置 → 模型 → 选择 OpenCode Zen 作为提供方。
选一个免费模型（如 deepseek-v4-flash-free）直接开始编码——无需 API key。

付费模型需要 API key：在 DSH 凭证中设置 OPENCODE_API_KEY（设置 → 凭证），或作为环境变量导出。

工作原理

本插件实现 @deepseek-ai/dsh-llm 的 LlmAdapter 接口，注册单个提供方路由 opencode-zen。当 DSH 把请求路由到该提供方时：

序列化——harness 消息被翻译为 OpenAI 兼容的 chat completions 请求（纯文本；图片会以 UNSUPPORTED_CONTENT 拒绝）。
流式——SSE 响应经 eventsource-parser 解析，翻译为 harness 的 StreamChunk 事件（block-start、text-delta、reasoning-delta、tool-call-delta、usage、finish）。
身份标识——请求携带 User-Agent: opencode/1.0.0 等头以满足 OpenCode Zen 的客户端身份校验（默认的 deepseek-harness/... user-agent 会被网关拒绝）。
凭证——从 DSH 凭证存储（环境变量 OPENCODE_API_KEY）或环境中解析 API key。免费模型无需 key；付费模型需要。
模型发现——注册发现处理器，从网关拉取 /models 并过滤带 free 标记的条目。
启动目录同步——每次插件加载时，在后台从网关（成员资格）+ models.dev（name / limit.context / limit.output 元数据）刷新免费模型目录。失败时保留内置目录；设置中自定义的 models: 列表永不被覆盖。可用 autoSyncModels: false 关闭。

配置

开箱即用，无需手动配置。 插件装入 profile 后自动注册（见「Bundle 补丁」），所有配置项都有合理默认值，settings.yaml 里不需要手工添加任何内容。

只有需要覆盖默认值时才配置：优先在 DSH Web 设置 → 模型页面修改（所见即所得），或在 profile 的 settings.yaml 的 llm-opencode 节中覆盖个别字段。改动立即生效，无需重启。

设置项	默认值	说明
`baseURL`	`https://opencode.ai/zen/v1`	网关端点
`apiKeyEnv`	`OPENCODE_API_KEY`	API token 的凭证存储键
`maxTokens`	`128000`	每次请求的默认最大输出 token 数
`defaultContextWindow`	`1000000`	未知模型的兜底上下文窗口
`streamIdleTimeoutMs`	`300000`	流被视为死亡前的最大空闲时间（毫秒）
`models`	（内置目录）	覆盖模型目录
`autoSyncModels`	`true`	每次启动时从网关 + models.dev 刷新免费模型目录
`retryPolicy`	（内置）	瞬时错误的重试行为

`settings.yaml` 示例（可选）

只有要覆盖默认值时才需要添加，以下仅为示意：

llm-opencode:
  baseURL: "https://opencode.ai/zen/v1"
  maxTokens: 64000
  models:
    - id: deepseek-v4-flash-free
      name: DeepSeek V4 Flash Free
      contextWindow: 200000
      maxTokens: 128000

完整带注释示例见 settings.example.yaml。

Bundle 补丁

随附的 cordis.patch.yml 会把 llm-opencode 插件行注册进 DSH bundle 加载器，插件装入 profile 后即自动加载。

开发

npm install
npm test
npm run lint

环境要求

DeepSeek Harness >= 0.1.0-rc.7
@deepseek-ai/cordis ^4.0.1（peer dependency）