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，定期轮换。