DeepSeek模型在Cursor中不可用需逐层排查：先确认官方服务状态（访问status.deepseek.com），再核验API密钥与Base URL配置（https://api.deepseek.com/v1）、检查网络代理与防火墙拦截、验证Cursor版本≥0.44.11及模型注册状态，自托管场景还需确保Ollama服务正常运行且环境变量配置正确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Cursor提示DeepSeek模型不可用，说明AI服务通道已中断或未正确建立——可能是API密钥失效、模型路由未注册、本地服务未启动，也可能是企业防火墙悄悄拦截了请求。别急着重装，先按真实故障链路逐层排查。
确认DeepSeek官方服务是否宕机
打开浏览器访问 status.deepseek.com，查看当前状态页是否显示“Operational”（运行正常）。若显示“Major Outage”或“Degraded Performance”，所有配置都无效，需等待官方恢复。此时网页端会提示“服务器繁忙，请稍后重试”，API调用返回503错误码，【这不是你本地的问题】。
检查API密钥与基础地址配置
方法一：通过Settings → AI → Model Providers 验证
确保 Provider 选为 DeepSeek，Endpoint 填写 https://api.deepseek.com/v1，API Key 字段只填密钥字符串本身，【不能带前缀如sk-、Bearer、空格或换行符】。复制密钥时建议用纯文本编辑器粘贴一次再复制，避免肉眼不可见的U+3000全角空格。
方法二：终端直连验证（绕过Cursor）
执行命令：curl -H "Authorization: Bearer YOUR_API_KEY" https://api.deepseek.com/v1/models。若返回401，说明密钥无效或过期；若返回403，检查是否启用了IP白名单且当前出口IP不在许可范围内；若超时，进入下一步网络排查。
排查本地网络与代理干扰
第一步：关闭所有代理软件（Clash、Surge、SwitchyOmega等），禁用系统级HTTP/HTTPS代理设置。
第二步：在终端运行 curl -v https://api.deepseek.com，观察SSL握手是否失败。若出现 SSL certificate problem，说明企业防火墙做了中间人解密，证书被替换——此时必须联系IT部门将 api.deepseek.com 加入白名单或禁用SSL检测规则。
第三步：若使用公司WiFi，尝试切到手机热点重试。很多企业网络会拦截非白名单域名的CONNECT请求，【api.deepseek.com 默认不在传统白名单库中】。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
验证Cursor版本与模型注册状态
① 点击左上角 Cursor → About Cursor，确认版本号 ≥ 0.44.11。旧版本（如0.43.x）不包含 deepseek/deepseek-r1 的OpenAI兼容路由映射，即使密钥和地址全对也会报“Model not found”。
② 打开命令面板（Cmd/Ctrl+Shift+P），输入 Cursor: Test AI Connection 并执行。若返回空响应或401，说明身份未通过；若返回“Connection refused”，说明Base URL指向的服务根本没在监听。
③ 若你配置的是自定义模型（如 deepseek-v4-pro），请确认已在Settings → Models → Add Custom Model 中勾选 Use custom model，且Model Name字段严格填写为 deepseek-v4-pro（大小写敏感，无空格）。
本地Ollama服务专项检查（仅限自托管场景）
如果你走的是Ollama本地托管路径，请按顺序执行：
1. 终端运行 ollama list，确认输出中包含 deepseek-v4-pro 且状态为 running。
2. 运行 curl http://localhost:11434/api/tags，检查JSON响应里是否有该模型的name字段和model字段匹配。
3. 检查环境变量：执行 echo $OLLAMA_HOST 应返回 0.0.0.0；执行 echo $OLLAMA_ORIGINS 应包含 http://localhost:5353（Cursor默认前端端口）。
4. 在Cursor设置中，Base URL 必须设为 http://localhost:11434/v1，【不能漏掉/v1后缀，也不能写成/v1/】。
