Skip to content

Cursor ​

Cursor 是基于 VS Code 的 AI 代码编辑器。通过 Override OpenAI Base URL 将 OpenAI 提供方指向 Trinity,使用 xh-... Key 与 模型广场 中的模型 ID。

获取 API Key ​

  1. 在 控制台 · API 密钥 创建 Key(xh-...)。
  2. 见 管理 API 密钥。

配置自定义模型 ​

  1. 打开 Cursor Settings(Cmd/Ctrl + ,)。

  2. 进入 Models,展开 API Keys。

  3. 开启 OpenAI API Key,粘贴 xh-...。

  4. 开启 Override OpenAI Base URL,设为:

    text
    https://api.trinitydesk.ai/v1
  5. 在 Models 中点击 + Add model,填入 模型广场 中的模型 ID(例如 gpt-5.4)。

  6. 在 Chat / Agent 面板选择该模型。

故障排查 ​

问题排查
401 Unauthorized确认 API Key 以 xh- 开头且未过期
403 model_not_allowed在控制台确认 Key 有该模型的调用权限
连接超时确认 Base URL 为 https://api.trinitydesk.ai/v1
模型未找到在 模型广场 核对模型 ID

WARNING

不要将 API Key 提交到 Git 仓库。使用环境变量或配置文件管理 Key,定期轮换。

Cursor 助手(Beta) ​

Cursor 助手(Beta)是 Trinity 提供的桌面应用,将 Cursor 接入 Trinity API。安装后首次启动会引导初始化本机 CA、连接 Trinity API Key,并把已上架的生文模型导入 Cursor 的模型列表。当前提供 0.1.0 版本。

下载

使用方法

  1. 下载并安装对应平台的安装包,打开 Cursor 助手。
  2. 首次启动时按引导完成 初始化 CA,将本机证书加入系统信任。
  3. 在 连接 Trinity API 中粘贴 xh-... API Key。
  4. 完全退出并重启 Cursor。
  5. 在 Cursor 的模型列表中选择 Trinity 模型开始对话。

使用桌面应用时,无需在 Cursor 中手动配置 Override OpenAI Base URL;模型请求由应用转发到 Trinity API。Beta 版本的功能与稳定性会持续调整。

© Trinity AI