dsh-zen-adapter
把 OpenCode Zen 的免费模型接入 DeepSeek Harness，
注册为原生 provider zen-free。
无需注册、无需 API key、无需额外进程。
English | 简体中文
特性
- 零配置 — 装上、重启、就能在模型选择器里选到免费模型
- 零依赖 —
dependencies 为空，运行时复用 DSH 自带的 pi-ai，因此可以和其他
provider 插件共存（详见为什么零依赖很重要）
- 动态模型目录 — 从上游实时发现，不是写死的清单，上游换模型不用等插件更新
- 可用性检测 — 区分「目录里在售」和「这台机器真的能调通」，避免选到用不了的模型
- 可视化面板 — 在插件详情页一键获取模型、检测可用性，并查看上下文大小
安装
dsh plugin --profile <你的 profile> add github:seonzzy/dsh-zen-adapter
# 或从本地目录安装：
dsh plugin --profile <你的 profile> add <本目录绝对路径>
装完重启 DSH，然后在模型选择器里选择 OpenCode Zen (free lane) 分组下的模型。
前提条件
| 条件 | 说明 |
|---|
| DSH 版本 | 需要带 llm.registerAdapter 与 webServer 的版本 |
| Node | ≥ 20（DSH 自带，无需另装） |
| 网络 | 能访问 opencode.ai 与 models.dev |
不需要安装 pi-ai、不需要 API key、不需要 npm/pnpm 下载任何东西。
使用
模型选择器
安装后在对话输入框的模型选择器里会出现 OpenCode Zen (free lane) 分组，
选择其中一个模型即可开始对话。
目录会动态获取：启动时后台拉取，之后每 30 分钟自动刷新一次。
插件面板
在「设置 → 插件 → dsh-zen-adapter」页面上有一个面板：
| 按钮 | 作用 |
|---|
| 获取模型 | 从上游重新拉取模型目录 |
| 检测可用性 | 逐个真实请求，测出哪些模型当前可用 |
下面的表格展示：模型名、上下文大小、输出上限、可用状态、判定依据。
「目录里有」不等于「能用」。 免费模型的实际可用性受上游端点状态、
地区限制、以及按 IP 计的配额影响，随时会变。建议在新环境里点一次
「检测可用性」。
模型是怎么来的
插件同时读取两个上游数据源，取交集：
| 源 | 提供 | 不提供 |
|---|
opencode.ai/zen/v1/models | 当前在售的模型 id | 价格、上下文 |
models.dev/api.json | cost、limit.context、limit.output | 是否在售 |
第二个源是必需的——Zen 的 /v1/models 只返回 { id, object, created, owned_by }，
无法从它判断某模型是否免费。
免费判定以 models.dev 的 cost 为准（input 与 output 均为 0）。
已弃用或收费的模型即使 id 带 -free 也不会放行——上游会把下架模型在目录里
继续挂一段时间。只有 metadata 缺失时（通常是刚发布的新模型）才退回看 -free 后缀。
上下文大小与输出上限同样来自 models.dev，所以界面上显示的是真实数值，
不是某个固定常数。
为什么零依赖很重要
本插件不声明任何 dependencies，@deepseek-ai/* 与 @earendil-works/pi-ai
全部声明为 peerDependencies 且标记 optional。
原因：DSH 宿主自带一份 pi-ai，插件运行时沿宿主的模块树解析，全局始终只有一份。
如果插件自带一份 pi-ai，机器上就会出现两个 pi-ai 世代。这不只是冗余——
某些插件（例如 dsh-workbuddy-xdpool）会校验宿主与插件用的是不是同一世代，
不一致时整个 provider 每次调用都会失败。
因此本插件可以和其他 provider 插件同时安装。
上游限制
OpenCode 的免费通道按 IP 计配额，部分模型还有地区限制。
可能遇到的情况：
| 现象 | 原因 | 怎么办 |
|---|
429 | 配额用尽或请求过密 | 等一会儿再试，或换网络节点 |
403 RegionError | 该模型不对你所在地区开放 | 无法绕过，换其他模型 |
5xx / 400 | 上游端点暂时故障 | 换其他模型，稍后再试 |
| 模型不在选择器里 | 尚未被判定为免费 | 点「获取模型」刷新目录 |
这些都属于上游侧行为，插件无法修复。用「检测可用性」可以看到每个模型的
当前状态。
配置
本插件没有需要配置的选项。如需调整可选行为，可修改 lib/index.js 顶部的常量：
| 常量 | 默认 | 说明 |
|---|
PROVIDER_ID | zen-free | 在 DSH 中显示的 provider id |
SEED_MODELS | 3 个模型 | 目录拉取完成前的占位列表 |
| 目录刷新间隔 | 30 分钟 | 见 lib/index.js 中的 refreshTimer |
卸载
dsh plugin --profile <你的 profile> remove dsh-zen-adapter
然后重启 DSH。
许可
MIT
