f

content/integrations/cursor.mdx

@@ -0,0 +1,50 @@
+---
+title: Cursor 接入
+sidebarTitle: Cursor
+description: 在 Cursor 中配置海宇数科 API 与国内模型
+---
+
+# Cursor 接入
+
+[Cursor](https://cursor.com) 支持使用 **OpenAI 兼容** 自定义接口。将 Base URL 指向海宇数科网关后，可在 Cursor 中选择控制台已上线的 **国内模型 ID** 进行补全与对话。
+
+## 前置条件
+
+1. 登录 [控制台](https://console.haiyushuke.com)，完成 **实名认证**  
+2. 在 **API Key** 创建密钥，并确认 Key 的 **可用模型** 包含你要用的模型 ID  
+3. 在 **模型广场** 复制目标模型 ID（例如 `deepseek-chat`、`glm-5.1` 等，以实际列表为准）
+
+## 配置步骤
+
+1. 打开 Cursor → **Settings**（设置）  
+2. 进入 **Models** 或 **OpenAI API** 相关区域（版本不同菜单名可能略有差异）  
+3. 填写：
+   - **OpenAI API Key**：海宇控制台创建的 API Key  
+   - **Override OpenAI Base URL**（或 Custom OpenAI Endpoint）：`https://api.haiyushuke.com/v1`  
+4. 在模型列表中添加 **自定义模型名**，名称必须与模型广场 **模型 ID 完全一致**  
+5. 保存后在新对话中选择该模型进行测试  
+
+## 示例（settings.json 片段）
+
+若你通过 `settings.json` 管理配置，可参考（键名以 Cursor 当前版本为准）：
+
+```json
+{
+  "openai.apiKey": "YOUR_HAIYUSHUKE_API_KEY",
+  "openai.baseUrl": "https://api.haiyushuke.com/v1"
+}
+```
+
+自定义模型请在 Cursor 的 Models 界面添加，ID 使用控制台复制的字符串。
+
+## 使用建议
+
+- **不要** 使用 `gpt-4o`、`claude-sonnet` 等海外模型名；平台未提供这些模型。  
+- 生产环境 Key 不要提交到 Git；可配合 Key 的 **IP 白名单**。  
+- 若补全无响应，先在 **体验中心** 用同一模型 ID 验证，再查 [常见问题](/docs/faq)。  
+
+## 相关文档
+
+- [工具接入概览](/docs/integrations/overview)  
+- [API Key 管理](/docs/guides/api_keys)  
+- [计费与财务](/docs/guides/billing)