Cursor++ 轻指南 v0.0.7
- 内容介绍
- 文章标签
- 相关推荐
[!ERROR]- 错误提要
image1162×158 59.1 KB解决办法就是先给他关了！
MCP Tool name 不规范导致的 后面安排时间处理image1460×1396 316 KB
image1158×778 35.5 KB
image1255×635 166 KB
[!Note]CHANGELOG
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
- 修复该云控情况下的模型获取到空串的问题
image744×428 33.4 KBv0.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的问题
正文
虽然说是尽力做的简单好理解 傻瓜一些
但可能仍有一些基础的知识 可能我认为都不算知识 而只是通识 确实是有不了解的佬
所以在这里简单的列举和标注一些使用问题及其详情
- 安装Cursor最新版 （虽然是废话 但真的有佬直接就开始++了）
- 安装扩展
npx @cometix/ccursor install
- 卸载扩展
npx @cometix/ccursor uninstall
- 打开检查 然后确认状态
- 配置供应商
- Anthropic 直接写 除了
/v1/messages之外的那部份 - OpenAI 通常要加
/v1 - Gemini 查无此资源 没有测试 按官网要求填写
- 登录账号点一下开关就可以正常登了 这就是 OFF 态
image692×1460 80.6 KB
简化了填写逻辑 移除了 用户侧不必要填写的内容
直接输模型id 然后模糊匹配会发力 直接点选一个 看起来相近的 （上下文窗口值很重要）
能力部分基本会自己填上
思考等级自己选 会赋予到 模型选择列表显示
image630×492 34 KB
GPT 5.4 的上下文窗口 数据库给的都是1M 这是不确切的 应自己修改为 和 Codex一致的 272K 以保证 能够识别到 85% 触发自动压缩
image662×1204 64.3 KB
最后 你别配完了 选择的是官方的模型名 这个会遗留的 需要自己确认
就像这样
image622×466 35.7 KB
那肯定报错没模型啊！！
如果是更新的话 请直接将 ~/.ccursor （看清楚是两个c不是一个c） 下的文件全数删除
然后直接改到 3.1.14 最新版 （目前）安装增强的++
[!Warning] 注意
MilQcxe:
目前Cursor自身最新版 存在bug 自己拉取官方模型会阻塞式失败
如有需要同时使用官方模型服务且是全新安装的 降级到v2的最后一版(2.6.22)再升级上来
就可以解决问题https://forum.cursor.com/t/cant-see-choose-models/1577031567×426 58.3 KB
最后 你应该知道 这玩意是对 Cursor 的 Patch ！就像游戏汉化补丁
最有力的恢复行为就是 重新把 Cursor 装一遍
遇到问题多看提示信息 那么多字呢 能是写着玩的么
image1798×404 25.3 KB
改成 VSCode 的竖条侧边栏！
网友解答：--【壹】--：
哈哈哈现在哈雷佬一发帖子,都抢着来发表情包
--【贰】--：
--【叁】--：
--【肆】--：
好好好,属于是喂饭喂到嘴里了. 快做啊~哈雷
--【伍】--：
Cursor是不是只有pro可以byok?
普号 Cursor 用这个插件之后,可以用byok吗?
--【陆】--：
--【柒】--：
@neo 来来来把位置让开。给始皇个位置
--【捌】--：
一大波快做啊，哈雷佬(手动抽鞭).gif要来了
--【玖】--：
--【拾】--：
在用了，最近api开始收紧了啊，要找好路子才是
--【拾壹】--：
其实哈雷佬自己用的话估计早就ok了，分享出来有操作兼容性和认知兼容性，佬已经尽量抹平了，我记得有工具调用的可能算优化，其他是dirty work，辛苦了 吃一鞭吧
--【拾贰】--：
--【拾叁】--：
哈雷佬编写的挺详细的了 但是我不知道为啥还是想发～ 快做啊哈雷～
--【拾肆】--：
--【拾伍】--：
--【拾陆】--：
--【拾柒】--：
在用了呗，前天刚捣鼓好，已经在愉快的爽用了。
--【拾捌】--：
正在使用，这就更新上
--【拾玖】--： 一摩尔氚:
来来来把位置让开。给始皇个位置
[!ERROR]- 错误提要
image1162×158 59.1 KB解决办法就是先给他关了！
MCP Tool name 不规范导致的 后面安排时间处理image1460×1396 316 KB
image1158×778 35.5 KB
image1255×635 166 KB
[!Note]CHANGELOG
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
- 修复该云控情况下的模型获取到空串的问题
image744×428 33.4 KBv0.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的问题
正文
虽然说是尽力做的简单好理解 傻瓜一些
但可能仍有一些基础的知识 可能我认为都不算知识 而只是通识 确实是有不了解的佬
所以在这里简单的列举和标注一些使用问题及其详情
- 安装Cursor最新版 （虽然是废话 但真的有佬直接就开始++了）
- 安装扩展
npx @cometix/ccursor install
- 卸载扩展
npx @cometix/ccursor uninstall
- 打开检查 然后确认状态
- 配置供应商
- Anthropic 直接写 除了
/v1/messages之外的那部份 - OpenAI 通常要加
/v1 - Gemini 查无此资源 没有测试 按官网要求填写
- 登录账号点一下开关就可以正常登了 这就是 OFF 态
image692×1460 80.6 KB
简化了填写逻辑 移除了 用户侧不必要填写的内容
直接输模型id 然后模糊匹配会发力 直接点选一个 看起来相近的 （上下文窗口值很重要）
能力部分基本会自己填上
思考等级自己选 会赋予到 模型选择列表显示
image630×492 34 KB
GPT 5.4 的上下文窗口 数据库给的都是1M 这是不确切的 应自己修改为 和 Codex一致的 272K 以保证 能够识别到 85% 触发自动压缩
image662×1204 64.3 KB
最后 你别配完了 选择的是官方的模型名 这个会遗留的 需要自己确认
就像这样
image622×466 35.7 KB
那肯定报错没模型啊！！
如果是更新的话 请直接将 ~/.ccursor （看清楚是两个c不是一个c） 下的文件全数删除
然后直接改到 3.1.14 最新版 （目前）安装增强的++
[!Warning] 注意
MilQcxe:
目前Cursor自身最新版 存在bug 自己拉取官方模型会阻塞式失败
如有需要同时使用官方模型服务且是全新安装的 降级到v2的最后一版(2.6.22)再升级上来
就可以解决问题https://forum.cursor.com/t/cant-see-choose-models/1577031567×426 58.3 KB
最后 你应该知道 这玩意是对 Cursor 的 Patch ！就像游戏汉化补丁
最有力的恢复行为就是 重新把 Cursor 装一遍
遇到问题多看提示信息 那么多字呢 能是写着玩的么
image1798×404 25.3 KB
改成 VSCode 的竖条侧边栏！
网友解答：--【壹】--：
哈哈哈现在哈雷佬一发帖子,都抢着来发表情包
--【贰】--：
--【叁】--：
--【肆】--：
好好好,属于是喂饭喂到嘴里了. 快做啊~哈雷
--【伍】--：
Cursor是不是只有pro可以byok?
普号 Cursor 用这个插件之后,可以用byok吗?
--【陆】--：
--【柒】--：
@neo 来来来把位置让开。给始皇个位置
--【捌】--：
一大波快做啊，哈雷佬(手动抽鞭).gif要来了
--【玖】--：
--【拾】--：
在用了，最近api开始收紧了啊，要找好路子才是
--【拾壹】--：
其实哈雷佬自己用的话估计早就ok了，分享出来有操作兼容性和认知兼容性，佬已经尽量抹平了，我记得有工具调用的可能算优化，其他是dirty work，辛苦了 吃一鞭吧
--【拾贰】--：
--【拾叁】--：
哈雷佬编写的挺详细的了 但是我不知道为啥还是想发～ 快做啊哈雷～
--【拾肆】--：
--【拾伍】--：
--【拾陆】--：
--【拾柒】--：
在用了呗，前天刚捣鼓好，已经在愉快的爽用了。
--【拾捌】--：
正在使用，这就更新上
--【拾玖】--： 一摩尔氚:
来来来把位置让开。给始皇个位置