正文

虽然说是尽力做的简单好理解 傻瓜一些 但可能仍有一些基础的知识 可能我认为都不算知识 而只是通识 确实是有不了解的佬 所以在这里简单的列举和标注一些使用问题及其详情

1. 安装Cursor v3最新版 （虽然是废话 但真的有佬直接就开始++了）
2. 安装扩展 npx @cometix/ccursor@latest install

• 卸载扩展 npx @cometix/ccursor@latest uninstall

3. 打开检查 然后确认状态
4. 配置供应商

• Anthropic 直接写 除了 /v1/messages 之外的那部分
• OpenAI 通常要加 /v1
• Gemini 查无此资源 没有测试 按官网要求填写

5. 登录账号点一下开关就可以正常登了 这就是 OFF 态

6. 单纯更新Cursor++就是 先uninstall恢复未Patch状态 再install到新版本

直接输模型id 然后模糊匹配会发力 直接点选一个 看起来相近的 （上下文窗口值很重要） 能力部分基本会自己填上 思考等级自己选 会赋予到 模型选择列表显示

GPT 5.4 的上下文窗口 数据库给的都是1M 这是不确切的 应自己修改为 和 Codex一致的 272K 以保证 能够识别到 85% 触发自动压缩

[!Error]GPT模型请用 OpenAI-Responses 提供商类型

[!Warning]非GPT模型请用 Anthropic 提供商类型

[!Info]Gemini模型用Gemini

[size=150][color=red]不能交叉混用 因为赋予的 提示词和工具完全不一样[/color][/size] 如果混插使用带来任何问题请自行研究解决

这里还包括 使用官方会话和BYOK会话间也不能混用接续 也无法接续

最后 你别配完了 选择的是官方的模型名 这个会遗留的 需要自己确认 就像这样

那肯定报错没模型啊！！

最后 你应该知道 这玩意是对 Cursor 的 Patch ！就像游戏汉化补丁 最有力的恢复行为就是 重新把 Cursor 装一遍

遇到问题多看提示信息 那么多字呢 能是写着玩的么

改成 VSCode 的竖条侧边栏！

v0.0.9

Bug Fixes

• 长久以来一直逆天而行但忽视细微差异带来的 模型填了但却提示无法找到的问题

v0.0.8

Bug Fixes

• 子代理现并发执行
• 子代理递归禁止
• Agent Window 内置 MCP 工具 schema 规范化
• Edit 工具 CRLF 保留
• BackgroundComposerService 路由防御
• Provider 保存全量校验 修复仅校验当前 provider 导致无效数据被静默保存或无反应
• Catalog 模型 thinking 默认值，选中 reasoning 模型时自动初始化 到 level
• 解析 backgroundTaskCompletionAction + context token limit

New Features

• 远端模型列表拉取, Provider 面板 ↓ Fetch 按钮，调用 GET /v1/models 快速添加模型
• Agent Window 日志落盘, agent-{wid}.log
• 适配到 Cursor 3.2.21

v0.0.7

• Prompt Caching — 实现会话缓存 BYOK模型间可自由切换接续
• 自定义请求头 — Provider 配置新增 Headers 字段（JSON 编辑器），支持设置 anthropic-beta、代理网关 key 等自定义头
• User-Agent 对齐 — Anthropic 渠道默认 Claude Code UA，OpenAI Responses 渠道默认 Codex CLI UA，可通过 Headers 覆盖
• 子代理进度汇报 — 实现 updateCurrentStep 工具，子代理完成任务后可提交 finalSummary 给主代理，主代理获得完整结果内容而非短摘要
• 空窗期状态提示 — 模型输出文本后长时间无新事件时，自动注入信号让客户端显示 "Generating response" 而非冻结状态 （使得某些模型不遵循规范细节带来的空卡）
• 更新检查 — 启动时自动检查 npm 上的最新版本，有更新时弹窗提示
• 版本号显示 — Server 面板标题栏显示当前版本号
• BackgroundComposerService — 暂时拦截 Cloud Agent 轮询请求，消除 Privacy Mode 持续报错
• OpenAI 工具参数 — 工具执行以 done 事件携带的完整参数为权威来源，delta 流式仅用于 UI 预览，解决部分模型不流式传参时工具参数为空的问题 （GPT-5.3-Codex-Spark）
• thinking 跨模型 — 跨模型切换时 thinking 块保留原始类型（清空 signature），不再降级为 text，修复 DeepSeek V4 等要求 thinking 回传的模型
• 模型搜索排序 — 模糊搜索结果按发布日期降序，最新模型排在前面
• Revert 失效 — 恢复到对话起点时 LLM 仍记得之前的内容，现已正确“清空”历史
• Fuzzy Search 不填入 — 修复点击模型搜索下拉条目后 apiModel 输入框不更新
• 用户中断报错 — 主动停止对话时 stream destroyed 错误不再触发 error 日志和 retry banner
• Edit 卡片文件名 — 编辑预览内容和文件名的流式显示时序优化
• Windows编辑文件 — 通过重构和捕获各种路径处理 归一化 使得 Windows 编辑文件基本正常 不空换行 误报已编辑 空编辑
• 模式追加 — Ask / Plan / Debug 模式的完整实施
• Toast — 添加提示 配置情况反馈更友好
• 模型参数 — 思考等级配置的完整贯穿 模型切换按渠道切换 System Prompt
• SKILL.md — 修正为渐进式加载，contextTokenLimit 动态预算
• rules — 修正加载rules集合配置 存储到 ~/.ccursor/knowledge-base.json
• Metion — 各类@引用的装载实现 包括 @browser 不包括 @docs
• MCP — 修复MCP工作完全不正常的问题
• 消息丢失 — 通过将预期之外的毒帧拦截兜底 避免了历史消息被摧毁
• Browser Use — 全面实现Cursor内置浏览器Tab功能联动

v0.0.6

• 修复该云控情况下的模型获取到空串的问题

v0.0.5

• UI简化，移除用户侧迷惑字段
• UI优化，弃用浏览器默认组件
• V3跟进 实施多Variant 映射显示模型
• 热重载改进，Save后能很及时的刷新模型列表
• 日志大幅度详尽更改，多实例显示自己的日志内容
• revert 行为修正 llm正常不记得回滚部分内容
• 追加 openai responses 接口类型提供商
• 追加 LLM错误到客户端侧的错误类型包装，避免错误成为消息内容了显示到对话流当中 部分错误情况得以重试继续
• 子代理正确沿用主代理所使用的模型
• 通过对齐Tool定义 修正了 Qwen 3.5/6 模型的 DUMMY_TOOL_RESULT 持续性工具调用错误问题
• 同时大幅度改进GPT模型的修改文件动作 和diff显示
• 修复预期的 BYOK Mode关闭状态下 不能正确登录Cursor的问题