DeepSeek Harness (DSH) 是一个基于插件化架构的智能体开发框架。接入外部模型通常需要编写适配器或寻找现成方案。OpenCode Zen 提供了免费档模型，但官方接入方式较为繁琐，且通常需要管理 Key。dsh-connect-opencode-free 插件旨在解决这个问题。它把 OpenCode Zen 的免费档接入 DSH，无需 Key，并提供了可视化的管理界面。
核心功能¶
免 Key 接入 OpenCode Zen 免费档
认证固定为 Bearer public。为了通过免费档校验，适配器会伪装成 OpenCode CLI（特定的 User-Agent、x-opencode-session 会话 id，以及 bash/read 工具名）。注意，bash/read 是真实可执行的工具，不是占位符，模型调用时会实际执行这两个工具。
双源模型发现
实时合并两个数据源：opencode.ai/zen/v1/models（此刻真实存在哪些 id）与 models.dev/api.json 的 opencode 段（哪些免费、上下文多大、支持什么能力）。任一源不可达仍沿用上次结论，一次网络抖动不会让模型凭空消失。
设置页一键管理
在设置页可以搜索、逐个启停、全部启用/停用。同时显示公共额度的限流状态与恢复时间。
三档使用规则
默认仅使用公共额度。另外两档（公共优先 / 私有优先）需要先通过 Key 校验才能选用。这允许用户在需要时灵活切换计费来源。
一键写入 Provider
把当前免费模型列表写入 llm-pi-ai.providers.opencode-zen，方便在 DSH 的 Provider 管理中直接调用。
安装与启用¶
本插件是 DSH cordis 插件包，通过 profile 的 package.json 接入。
方式一：npm 安装（推荐）
1. 进入目标 profile 目录（如 ~/.dsh/profiles/<profile-name>/）。
2. 在 package.json 的 dependencies 中加入：
"dsh-connect-opencode-free": "^0.4.0"
- 在
dsh.profile.bundles数组中加入包名：
"dsh-connect-opencode-free"
- 在该 profile 目录执行安装：
pnpm install
- 重启 dsh（如
dsh web），打开「设置 → OpenCode 免费模型」即可使用。
方式二：从源码运行（开发态）
1. clone 本仓库到本地。
2. 在 profile 的 package.json 的 dependencies 中用 link: 指向源码绝对路径：
"dsh-connect-opencode-free": "link:/absolute/path/to/dsh-connect-opencode-free"
- 同样在
dsh.profile.bundles数组中加入包名。 - 执行
pnpm install，重启 dsh。
依赖要求：Node ≥ 18，且宿主提供 @deepseek-ai/dsh-llm（peer 范围 >=0.1.7-rc.1 <0.3.0）。
典型用法¶
- 打开「设置 → OpenCode 免费模型」。
- 点击「一键同步」，获取当前可用的免费模型列表。
- 根据需要配置三档额度策略（默认为
publicOnly）。 - 配置完成后，点击「一键写入 provider」，将模型列表写入 Harness 的配置中。
注意事项¶
- OpenCode Zen 是第三方公开服务，其可用性、模型清单与限流策略由其运营方决定。
- 认证固定为
Bearer public。 - 浏览器半边产物由
scripts/build.mjs生成，开发态运行前需先构建。
该插件为 DSH 用户提供了一种便捷接入 OpenCode Zen 免费模型的方式，适合需要低成本调用大模型且对 Key 管理敏感的场景。
