跳到主要内容

配置 Provider 与模型

AI Provider 属于当前桌面设备，不属于单个 app，也不会随 ZIP 或 Git 一起迁移。

先确认当前模式​

Theseus 根据当前 Qixin 账号权益显示两种模式：

  • Qixin AI 模式：只显示平台提供的 Qixin AI 模型，不显示第三方配置入口。
  • BYOK 模式：除 Qixin AI 外，可以配置 OpenAI-compatible Provider，或登录 Codex OAuth Provider。

如果预期可以使用 BYOK，但设置页没有入口，先登录 Qixin 账号并在 AI 设置中重新检查权益。不要通过编辑本地文件绕过界面状态。

使用 Qixin AI​

  1. 登录具有 AI 权益的 Qixin 账号。
  2. 打开系统设置 → AI。
  3. 确认 Qixin AI 行没有认证或网络错误。
  4. 刷新模型。
  5. 打开 AI Command Center，在模型选择器中选择可用模型。

添加 OpenAI-compatible Provider​

只有 BYOK 模式显示该入口。

  1. 在系统设置 → AI 中新增 Provider。
  2. 填写易于识别的名称、服务 endpoint 和 API Key。
  3. 保存 Provider。
  4. 刷新该行模型，确认服务返回的模型可见。
  5. 在 AI Command Center 中选择模型并发送一个不修改文件的测试问题。

模型 ID 以 Provider 实际返回为准。不要把文档示例中的模型名当成固定可用列表。

使用 Codex OAuth​

  1. 在 BYOK 模式下选择 Codex 登录。
  2. 按界面提供的设备登录流程完成授权。
  3. 返回设置页，确认 Codex 状态正常。
  4. 在 AI Command Center 中选择 Codex Provider 下的模型。

Codex OAuth 是独立 Provider，不需要填写 OpenAI-compatible API Key 或 endpoint。

模型怎么选​

任务优先考虑
跨 Page、Graph、Object 的复杂任务推理能力和较大的上下文能力
阅读错误、做小范围修改响应速度和稳定性
Vision 样本与图像任务明确支持图像输入的模型
只解释文档或生成短文案快速模型即可

模型选择器会根据当前 Provider 报告的能力显示可用选项。思考级别只在模型声明支持时生效。

安全与排错​

  • 不要把 API Key、密码或设备授权码发到聊天、截图、文档或 Git。
  • 某个 Provider 失败时，只修复该行，不要删除其他正常 Provider。
  • 保存配置后再刷新模型；未保存修改不会成为可用配置。
  • endpoint、认证或网络错误应在对应 Provider 行处理。
  • 完成后同时确认“设置页能看到模型”和“AI Command Center 能选择模型”。

下一步参见使用 AI Command Center。