必须升级至Cursor v0.44.11或更高版本，因旧版modelRegistry.json硬编码白名单不包含deepseek-chat等标识符，导致配置后模型无法显示；升级后按规范填写Model Name、Base URL和API Key，并刷新注册表即可生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Cursor设置里明明填了DeepSeek模型名称和API Key，却在模型下拉菜单中完全找不到它，连模糊匹配都没有——这通常不是网络或密钥问题，而是模型注册机制被前端屏蔽导致的硬性缺失。
确认Cursor版本是否支持DeepSeek
打开Cursor → 左上角“Cursor”菜单 → “About Cursor”，查看当前版本号。【必须是v0.44.11或更高版本】。v0.44之前版本的modelRegistry.json是硬编码白名单，deepseek-chat、deepseek-reasoner等标识符根本不在其中，配置再正确也不会出现在UI里。
若版本过低，立即前往官网下载最新安装包并覆盖安装。旧版无法通过设置补救，必须升级。
检查模型添加路径与字段填写
关闭所有Cursor窗口，重新启动后进入：文件 → 首选项 → Cursor Settings → Models → Add Model。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
方法一：添加标准模型（推荐优先尝试）
在Model Name栏输入【deepseek-chat】（通用对话）或【deepseek-reasoner】（复杂推理），不要加空格、下划线或版本号后缀；Base URL填【https://api.deepseek.com/v1】；API Key粘贴时用鼠标双击全选再复制，避免末尾隐藏换行符。
方法二：启用Custom Model（适配v0.45+）
勾选“Use custom model”开关；Endpoint填【http://localhost:11434/v1】（仅限Ollama本地部署）；Model ID必须与ollama list输出的名称完全一致，例如deepseek-coder:6.7b，不能简写为deepseek-coder。
强制刷新模型注册表
第一步：彻底退出Cursor进程
macOS：打开活动监视器 → 搜索“Cursor” → 强制退出所有相关进程；
Windows：任务管理器 → 结束“Cursor.exe”及其子进程（包括GPU进程）。
第二步：清除缓存配置
删除以下目录：
macOS：~/Library/Application Support/Cursor/Local Storage/
Windows：%APPDATA%\Cursor\Local Storage\
⚠️ 注意：此操作会清空本地聊天历史，但不影响账户和API Key。
第三步：重启并验证
重新打开Cursor → Settings → Models → 点击右上角刷新图标（↻），等待3秒；若仍为空，手动点击“Add Model”再试一次。
终端验证API连通性
打开系统终端，执行以下命令：
curl -X POST https://api.deepseek.com/v1/chat/completions \-H "Authorization: Bearer YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"model":"deepseek-chat","messages":[{"role":"user","content":"hi"}]}'
如果返回JSON含"choices"字段，说明密钥和域名有效；若报401，密钥无效；若报curl: (7) Failed to connect，则企业防火墙拦截了api.deepseek.com，需联系IT开通HTTPS白名单。
