mirror of
https://wget.la/https://github.com/leookun/cursor-byok
synced 2026-10-05 12:13:05 +08:00
leokun
e874d68b79
- Enhanced instructions for restarting Cursor after upgrades or initial model configuration to ensure proper functionality. - Updated references from "Troubleshooting" to "Frequently Asked Questions" for better alignment with user needs. - Improved clarity in the installation and usage steps across multiple language versions.
91 lines
5.4 KiB
Plaintext
91 lines
5.4 KiB
Plaintext
---
|
||
title: 常见问题
|
||
description: 以问答形式解答 Cursor Byok 的配置、账号、模型和 TAB 补全问题。
|
||
icon: Wrench
|
||
---
|
||
|
||
## Q：首次升级或配置后，为什么 Cursor 提示“未登录”、看不到模型或出现 `An unexpected error occurred`？
|
||
|
||
**A：** 首次升级 Cursor 或首次配置模型后，Cursor 需要重新建立连接。遇到以下错误时，请先执行完整重启流程，而不是继续使用当前对话：
|
||
|
||
```text
|
||
An unexpected error occurred. Request ID: 3871795e-2a93-4628-8308-c641047e9e43
|
||
```
|
||
|
||
请按顺序完成以下操作：
|
||
|
||
1. 保持 Cursor Byok 运行。
|
||
2. 完全退出 Cursor，确认进程结束后重新启动。
|
||
3. 新建一个对话，不要继续使用配置前或切换前已经打开的对话。
|
||
4. 在模型列表中选择你配置的模型。
|
||
|
||
首次升级或首次配置模型后也需要执行这套流程。新版创建的对话会与 Cursor 官方对话同步，可以和官方模型继续衔接。
|
||
|
||
## Q：切换到新版需要登录自己的 Cursor 账号吗？
|
||
|
||
**A：** 不需要。新版可以在没有 Cursor 账号的情况下使用自己的模型；不过建议在 Cursor 中登录任意账号，这样可以更好地使用官方插件、MCP、Skills、代码库索引和官方模型等功能。切换 Cursor 账号时不需要退出 Cursor Byok。
|
||
|
||
## Q：旧版已经打开的对话可以继续使用吗？
|
||
|
||
**A：** 旧助手产生的对话无法直接在新版中续接，需要新开一个对话。新版产生的对话与 Cursor 官方同步，可以在新版和官方模型之间无缝切换或继续对话。
|
||
|
||
## Q：新版支持 Cursor 官方模型吗？
|
||
|
||
**A：** 支持。新版可以让 Cursor 官方模型与自己配置的本地模型同时存在，例如 Auto、Composer 等官方模型仍由 Cursor 官方服务处理，自己配置的模型则通过 Cursor Byok 转发。
|
||
|
||
## Q：为什么选择 Auto 会提示额度或账号错误？
|
||
|
||
**A：** Auto 只会使用 Cursor 官方模型，不会自动使用你配置的本地模型。账号没有官方额度时，请在模型列表中手动选择自己的模型；有官方额度时，可以在官方模型和自己的模型之间自由切换。
|
||
|
||
## Q：Cursor 的插件、MCP、Skills 和代码库索引还能使用吗？
|
||
|
||
**A：** 可以。新版与 Cursor 官方服务并存，登录任意 Cursor 账号后可以继续使用官方插件、MCP、Skills、Auto 模型和代码库索引。代码库索引使用 Cursor 官方索引服务，需要将 Cursor 升级到最新版。
|
||
|
||
## Q：语意搜索第一次使用为什么比较慢？
|
||
|
||
**A：** 首次调用语意搜索时，应用会自动下载 Embedding Model（文本向量模型）。下载完成后，后续搜索会直接使用本地模型。模型文件较大时，请保持网络连接并耐心等待首次下载完成。
|
||
|
||
## Q：TAB 补全在哪里设置？
|
||
|
||
**A：** 在 Cursor Byok 的 **系统设置 → TAB 设置** 中选择：
|
||
|
||
- **直连**：连接你在 Cursor 中登录的账号对应的官方 TAB 服务。
|
||
- **公益服务**：使用作者提供的免费 TAB 服务。
|
||
- **自定义**：连接你自己额外部署的 TAB 补全服务。
|
||
|
||
这些 TAB 补全能力都来自 Cursor 官方服务。自定义的 BYOK 模型通常不适合处理代码补全，因此不会用于 TAB 补全。修改设置后，请重启 Cursor 并新建一个对话。
|
||
|
||
## Q：为什么模型测试通过了，Agent 请求仍然失败？
|
||
|
||
**A：** 模型测试只验证基础连接。Agent 请求还会包含更长的上下文、工具定义和流式响应，请检查：
|
||
|
||
- 上游模型是否支持工具调用。
|
||
- 上下文窗口和最大输出 Token 是否符合模型限制。
|
||
- 模型类型、请求协议和服务地址是否匹配。
|
||
- 自定义 Headers 和额外参数是否符合上游协议。
|
||
- **调用统计**或调用详情中的上游状态码和响应内容。
|
||
|
||
## Q：本地 CA 是什么？初始化失败怎么办？
|
||
|
||
**A：** 本地 CA（证书颁发机构）用于让 Cursor Byok 解析 Cursor 发出的 HTTPS 请求，相关文件只保存在本机。进入 **Cursor 配置**，点击 **初始化 CA**；系统要求授权时，按照应用提示在终端中完成安装和信任，然后返回应用点击 **我已初始化，刷新**。
|
||
|
||
如果状态没有更新，请完全退出并重新启动 Cursor Byok，再次打开 Cursor 配置页面。
|
||
|
||
## Q：模型连通性测试失败怎么办？
|
||
|
||
**A：** 根据测试错误检查：
|
||
|
||
- **认证错误**：确认 API Key 有效，并且账户有权访问目标模型。
|
||
- **接口不存在**：确认模型类型、请求协议和服务器地址匹配。
|
||
- **模型不存在**：使用 **获取模型** 检查上游返回的模型标识。
|
||
- **参数错误**：暂时移除自定义 Headers 和额外参数，再重新测试。
|
||
- **连接超时**：检查网络、系统代理和上游服务状态。
|
||
|
||
## Q：还在使用旧版生成的 fake 账户怎么办？
|
||
|
||
**A：** 在 Cursor 中退出旧版生成的 fake 账户，然后登录任意 Cursor 账号，或直接保持未登录状态使用自己的模型。新版不再需要 fake 账户，也不需要通过“停止服务”来切换官方服务和本地模型。
|
||
|
||
## Q：遇到其他问题时，需要提供什么信息？
|
||
|
||
**A：** 请在 [GitHub Issues](https://github.com/leookun/cursor-byok/issues) 提交问题，并附上操作系统、Cursor Byok 版本、模型类型、请求协议、已脱敏的服务地址、错误信息和复现步骤。请勿公开 API Key 或其他凭据。
|