Zen Go 接入配置 IWAIBAOLI/dsh-opencode-go-setup

将 DeepSeek Harness 连接到 OpenCode Zen Go（opencode-go）

将 DeepSeek Harness 的 LLM 提供商接入 OpenCode Zen Go（opencode.ai 的 Go 会员服务），这样 harness 就能直接使用 Zen Go 模型（DeepSeek V4 Flash / Pro、GLM、Qwen、Kimi、MiniMax、Grok 等）。

注意：opencode-go（Zen Go，基于订阅）和 opencode（Zen，按量付费）是两个不同的服务，拥有各自的端点和计费方式。本指南仅涵盖 Zen Go。

前置条件

- OpenCode Zen Go 会员（opencode.ai）
- 有效的 OPENCODE_API_KEY（Zen 和 Zen Go 共用同一个密钥）
- 已安装 DeepSeek Harness

配置

编辑 ~/.dsh/settings.yaml：

llm-pi-ai:
providers:
opencode-go:
apiKeyEnv: OPENCODE_API_KEY
models:
- id: deepseek-v4-flash

将你的密钥放入 ~/.dsh/.credentials.yaml（或设置 OPENCODE_API_KEY 环境变量）：

OPENCODE_API_KEY: sk-your-key

要点：

- 不要设置提供商级别的 baseURL。 pi-ai 目录已经为每个模型携带了正确的端点（anthropic 协议的模型使用 https://opencode.ai/zen/go，openai 协议的模型使用 https://opencode.ai/zen/go/v1）。提供商级别的 baseURL 会覆盖每个模型的端点，是 404 错误的头号来源。
- 模型条目会与 pi-ai 目录合并：仅需 id 即可；上下文窗口 / 最大输出 token 数会自动从目录中获取。你可以显式声明 contextWindow / maxTokens，但不要超过目录中的值。
- 要使用更多模型，请将其 id 添加到 models 列表中（完整列表见下文）。
- 要让 harness 默认使用此提供商，请将 agent-default-model.provider 设置为 opencode-go。

更改设置后请重启 harness（正在运行的进程会缓存旧配置）。

验证

推荐：自检脚本（已包含，零依赖）

node verify.mjs # static config check (no key needed)
node verify.mjs --live # also send a real request (needs OPENCODE_API_KEY)
node verify.mjs --list-models # list supported models

静态检查会验证：提供商名称、模型 id 是否与目录匹配、意外的 baseURL 错误、容量合理性，并打印每个模型的真实请求 URL。--live 通过并返回 HTTP 200 意味着配置端到端可用。

手动：curl

curl -X POST https://opencode.ai/zen/go/v1/chat/completions \
-H "Authorization: Bearer $OPENCODE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"hi"}],"max_tokens":32}'

预期返回 HTTP 200 以及 chat.completion JSON 响应。

支持的模型权威列表是 node verify.mjs --list-models：它在运行时从 pi-ai 的官方 npm 发布 获取最新目录（离线时回退到内嵌快照并给出警告）——无需手动维护。

当前目录按协议分组（每个协议有自己的端点）：

| 协议 | 端点 | 示例模型 |
| openai-completions | https://opencode.ai/zen/go/v1/chat/completions | deepseek-v4-flash, deepseek-v4-pro, glm-5.2, kimi-k3, qwen3.6-plus, mimo-v2.5, ... |
| anthropic-messages | https://opencode.ai/zen/go/v1/messages | qwen3.7-plus, qwen3.8-max, minimax-m3 |
| openai-responses | https://opencode.ai/zen/go/v1/responses | grok-4.5, gpt-5.6-luna |

免费模型（deepseek-v4-flash-free 以及其他带 -free 后缀的 id）在 Zen Go 上不受支持——它们会返回 401 ModelError: not supported。它们仅在 Zen（/zen/v1）上可用。

故障排查

| 症状 | 原因 | 修复方法 |
| 404，返回 opencode.ai 的 HTML 页面 | baseURL 以 /chat/completions 结尾，而 pi-ai 又追加了一次，或者 URL 本身就是错的 | 移除 provider 级别的 baseURL；让目录端点生效 |
| 401 Insufficient balance | 使用了 opencode（Zen 按量付费）而不是 opencode-go | 将 provider 键重命名为 opencode-go；或在 opencode.ai 充值 |
| 401 ModelError: not supported | 模型 id 不属于 Zen Go（例如 -free 模型） | 使用目录中的模型；参见 node verify.mjs --list-models |
| 401 无效密钥 | 凭据/环境变量中缺少密钥 | 检查 ~/.dsh/.credentials.yaml 和 OPENCODE_API_KEY |
| 模型返回 404 | 模型 id 拼写错误 | 与 --list-models 的输出进行比对 |

相关链接

- OpenCode Zen 文档
- pi-ai（模型目录来源）
- DeepSeek Harness