将 OpenWork 接入 XiuRouter | XiuAI 文档中心

在 OpenWork 工作区添加 OpenCode-compatible provider，并通过设置界面保存 Key。

OpenWork 使用 OpenCode 引擎读取自定义 provider，但配置保存在当前工作区。先写工作区配置，再重载工作区并在设置界面保存 API Key。

选择配置方式

首次配置：在工作区创建 provider.xiurouter。
替换已有：只合并 provider.xiurouter，保留其他 provider 和模型。
对话协助：不提供。工作区重载和凭据连接仍需在 OpenWork 中完成。

前置条件

已在 OpenWork 打开或新建目标工作区。
已创建一把 OpenWork 专用 XiuRouter API Key。
已从 XiuRouter 当前目录复制精确模型 ID。

添加工作区 provider

在当前工作区创建 .config/opencode/opencode.json。目录不存在时一并创建。已有文件时只合并 provider.xiurouter：

{
  "$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"
        }
      }
    }
  }
}

配置必须放在工作区内，不是全局 OpenCode 配置。文件中不写真实 Key。

重载并保存 Key

关闭当前工作区，再重新打开。
打开 Settings → Cloud Providers。
找到 XiuRouter 并选择连接。
粘贴 XiuRouter API Key。
在模型选择器中选择 YOUR_MODEL_ID。

OpenWork 不会热加载 provider。改完配置但没有重载时，设置页和模型选择器不会出现 XiuRouter。

验证

新建任务，让 OpenWork 只读取一个文件并总结。
确认任务使用 YOUR_MODEL_ID。
在 XiuRouter 控制台“检查实际请求”核对 Key、模型、/v1/chat/completions 和成功状态。
只读任务通过后，再测试可撤销的文件修改。

常见失败

现象	处理
模型选择器没有 XiuRouter	确认文件位于当前工作区的 `.config/opencode/opencode.json`，再彻底重载工作区
连接 provider 失败	回到 Settings → Cloud Providers，确认 Key 保存到了 XiuRouter
请求格式不兼容	确认 `npm` 使用 `@ai-sdk/openai-compatible`
其他工作区没有 XiuRouter	这是工作区级配置；需要在对应工作区单独添加

回滚

从工作区配置删除 provider.xiurouter，重载工作区并切回原模型。确认新任务恢复原路由后，再撤销 OpenWork 专用 XiuRouter API Key。

来源与核对日期

本文以 XiuRouter 产品集成页当前 OpenWork 工作区配置、凭据入口和验证路径为准，核对日期为 2026-08-22。本轮未使用真实 Key 运行 OpenWork 计费任务。