将 OpenCode 接入 XiuRouter

首次配置需要通过 /connect 保存凭据，并在 opencode.json 添加 xiurouter provider。已经在使用 OpenCode 时，不需要重装；保留其他 provider 作为回滚路径。

选择配置方式

• 首次配置：保存 xiurouter API Key，再添加 provider 和模型。
• 替换已有：更新同名凭据，只合并 provider.xiurouter。
• 对话协助：让 OpenCode 合并不含密钥的 JSON；API Key、重载和新任务仍需手动完成。

前置条件

• OpenCode 已可正常启动。
• 已创建一把 OpenCode 专用 XiuRouter API Key。
• 已从 XiuRouter 当前目录复制模型 ID。

保存 API Key

1. 在 OpenCode 中运行 /connect。
2. 选择 Other。
3. provider ID 填 xiurouter。
4. 粘贴 XiuRouter API Key。

已有 xiurouter 时更新同一项，不要创建重复 provider。不要把真实 Key 写入 opencode.json。

添加 provider

在项目或 OpenCode 当前读取的 opencode.json 中合并：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xiurouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "XiuRouter",
      "options": {
        "baseURL": "https://router-api.xiu.ai/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

npm 使用 @ai-sdk/openai-compatible，让 OpenCode 走 Chat Completions。自定义 provider 没有 Models.dev 目录，models 必须显式列出模型 ID。只新增 provider.xiurouter，不要覆盖其他 provider。

有配置文件权限的新 Agent 任务可以帮你合并这段不含密钥的 JSON。API Key 仍要通过 /connect 保存；合并后重新加载 OpenCode，并新建任务。

对话协助

先通过 /connect 手动保存 API Key，再把下面消息发给有配置文件权限的 OpenCode 任务：

保留当前 opencode.json 的所有 provider，只添加 provider.xiurouter，使用 @ai-sdk/openai-compatible、Base URL https://router-api.xiu.ai/v1 和模型 YOUR_MODEL_ID。不要读取或写入 API Key。修改后展示 diff。

验证

1. 在 OpenCode 中运行 /models。
2. 选择 xiurouter/YOUR_MODEL_ID。
3. 发起一个只读小任务。
4. 在 XiuRouter 控制台“检查实际请求”确认 Key、模型、/v1/chat/completions 和成功状态。

普通回复成功后，再验证文件读取、工具调用和编辑。不同模型的工具能力不同，不要给所有模型套同一组能力参数。

常见失败

回滚

先用 /models 切回原模型。确认新任务恢复原路由后，再删除 provider.xiurouter 和对应凭据。

来源与核对日期

内容核对于 2026-08-31。OpenCode 收到完整回复，并在 XiuRouter“检查实际请求”中出现对应模型、接口和成功状态后，基础接入才算完成。