dsh-llm-opencode-zen

OpenCode Zen LLM 适配器 —— 给 DeepSeek Harness 接入 OpenCode Zen 网关的免费模型。零配置、零成本，Bearer public 匿名即用。

原包名 @dsh-external/dsh-llm-opencode-zen 已迁移至 dsh-llm-opencode-zen，两者代码一致，推荐使用新包名通过 npm 安装。

特性

• 零配置即用：不配任何 API Key，插件自动以 Authorization: Bearer public 匿名请求，走 27 个免费模型
• 27 个免费模型：DeepSeek / GLM / Kimi / MiniMax / MiMo / Nemotron / Ling / Laguna 等 *-free 模型，均 cost=0
• 完整适配器实现：注册标准 ctx.llm provider 路由 opencode-zen，支持流式输出、工具调用（tool_calls）、思考过程（reasoning_content → reasoning-delta）、用量统计
• 思考模型开箱即用：免费模型统一声明支持 high/max 思考强度，兼容全局 reasoningEffort: max 配置
• 可选付费解锁：配置 OPENCODE_API_KEY 后按需在 models 目录追加付费模型
• 零依赖运行时：纯 ESM JavaScript，直接 fetch + SSE，无第三方 SDK

工作原理

OpenCode Zen（https://opencode.ai/zen/v1，OpenAI 兼容协议）是 opencode 官方运营的 LLM 网关：

• 客户端无 Key 时，opencode 客户端按 cost.input === 0 过滤出免费模型，以 apiKey: "public" 占位请求
• 服务端对 public + allowAnonymous 模型放行，并按 IP 每日限流，额度用尽返回 429 FreeUsageLimitError
• 网关对 User-Agent 有要求（须为 opencode/ 前缀，否则 429），本插件据此设置请求 UA

免费模型/额度由 opencode（SST/anomaly）补贴运营，随时可能轮换或限流，属官方设计。请以实际可用为准。

安装

方式一：从 npm 安装（推荐）

dsh plugin --profile web add dsh-llm-opencode-zen
# 或从 GitHub 安装
# dsh plugin --profile web add github:zouyuanqing/dsh-llm-opencode-zen

重启 dsh web 后，插件注册 provider 路由 opencode-zen（显示名 OpenCode Zen (Free)），开箱即用。

方式二：开发/本地注入（dsh-super-injector 体系）

dev_inject_plugin {"dir": "<本插件目录绝对路径>"}

运行时注入即完整生效（免重启、可热重载、卸载即净）。

配置

1. 默认模型（~/.dsh/settings.yaml）

agent-default-model:
  provider: opencode-zen
  model: deepseek-v4-flash-free   # 或其他 *_free 模型
  reasoningEffort: high           # high / max 均可

2. 完整配置段（可选；不写则全部使用内置默认）

llm-opencode-zen:
  baseURL: https://opencode.ai/zen/v1   # 默认即此
  # apiKeyEnv: OPENCODE_API_KEY         # 留空 = 匿名免费；填写则带真实 Key 请求
  models:                               # 覆盖模型目录（默认 27 个免费模型）
    - id: deepseek-v4-flash-free
      name: DeepSeek V4 Flash Free
      contextWindow: 200000
      maxTokens: 128000
      reasoning: [high, max]
      defaultEffort: high

说明：设置页（设置 → Models）里该 provider 卡片会显示"其余字段在 settings.yaml 中，请直接编辑对应段"——这是 DSH 前端对非官方 provider 的固定行为（前端只内置 llm-deepseek / llm-pi-ai 两套编辑表单），不影响使用。模型选择器（对话输入框旁）可直接选择免费模型。

免费模型清单（27 个）

模型	上下文	最大输出	思考
deepseek-v4-flash-free	200K	128K	high/max
glm-5-free / glm-4.7-free	200K	64K	high/max
kimi-k2.5-free	262K	64K	high/max
qwen3.6-plus-free	262K	64K	high/max
minimax-m3-free	512K	128K	high/max
minimax-m2.5-free / minimax-m2.1-free	204K	131K	high/max
mimo-v2-flash-free / mimo-v2-pro-free / mimo-v2-omni-free / mimo-v2.5-free	200K	32-64K	high/max
nemotron-3.5-lightning-free / nemotron-3-ultra-free / nemotron-3-super-free	200K–1M	32-128K	high/max
ling-3.0-flash-free / ling-3.0-tiny-free / ling-2.6-flash-free	200-262K	16-32K	high/max
laguna-s-2.1-free	256K	32K	high/max
ring-2.6-1t-free	1M	128K	high/max
north-mini-code-free	256K	64K	high/max
trinity-large-preview-free	200K	64K	high/max
hy3-free / hy3-preview-free	256K	64K	high/max
grok-code	256K	128K	high/max
big-pickle	200K	32K	high/max
longcat-2.0-free	200K	32K	high/max

免费模型清单来自公开目录快照，服务端可能轮换/下架（例如部分模型会返回 401/503），以实际可用为准。

免费额度说明

免费模型在服务端按 IP 每日限流（allowAnonymous 模型无论是否带 Key 都走 IP limiter）：

• 额度用尽 → 429 {"type":"FreeUsageLimitError","message":"Error from provider (Console): Rate limit exceeded..."}
• 额度每日零点自动重置
• 代理/VPN 环境下，出口 IP 以代理节点为准；IPv4/IPv6 为两个独立出口额度

免责声明

• 本项目为独立开发的第三方插件，与 opencode 及其运营方（SST/anomaly）无任何关联、无官方背书；"OpenCode" 为 opencode 的商标，此处仅作技术指代。
• 本项目调用的是 opencode 公开提供的 API。使用者应自行遵守 opencode 的服务条款，包括但不限于免费额度的合理使用；不得利用本项目规避其限流、配额或其他技术保护措施。
• 免费服务可能随时变更、限流或停止，本项目不对此承担任何责任。
• 本项目按 MIT 许可发布，按"现状"提供，不附带任何明示或默示的担保。

本地验证

# 匿名免费模型（Bearer public）
node scripts/verify-live.mjs deepseek-v4-flash-free

# 带 Key（从 ~/.dsh/.credentials.yaml 读取 OPENCODE_API_KEY）
node scripts/verify-live-keyed.mjs deepseek-v4-flash-free

License

MIT