Cursor
Cursor 是基于 VS Code 的 AI 代码编辑器。通过 Override OpenAI Base URL 将 OpenAI 提供方指向 Trinity,使用 xh-... Key 与 模型广场 中的模型 ID。
获取 API Key
- 在 控制台 · API 密钥 创建 Key(
xh-...)。 - 见 管理 API 密钥。
配置自定义模型
打开 Cursor Settings(
Cmd/Ctrl + ,)。进入 Models,展开 API Keys。
开启 OpenAI API Key,粘贴
xh-...。开启 Override OpenAI Base URL,设为:
texthttps://api.trinitydesk.ai/v1在 Models 中点击 + Add model,填入 模型广场 中的模型 ID(例如
gpt-5.4)。在 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 版本。
下载
- macOS(Apple 芯片):macOS 下载
- Windows(x64):Windows 下载
使用方法
- 下载并安装对应平台的安装包,打开 Cursor 助手。
- 首次启动时按引导完成 初始化 CA,将本机证书加入系统信任。
- 在 连接 Trinity API 中粘贴
xh-...API Key。 - 完全退出并重启 Cursor。
- 在 Cursor 的模型列表中选择 Trinity 模型开始对话。
使用桌面应用时,无需在 Cursor 中手动配置 Override OpenAI Base URL;模型请求由应用转发到 Trinity API。Beta 版本的功能与稳定性会持续调整。