功能说明基于最新版本 cursor-1.1.6

功能配置

功能配置方式和VSCode一致，可导入VSCode的配置，配置方式参考VSCode

AI聊天面板的唤起方式:
Ctrl+I: 调用对话框 chat
Ctrl+Shift+K: 调用嵌入式窗口，默认处理光标下方内容 也可选中代码后点击Edit按钮，精准处理选中内容。

特性菜单(关键配置项)
自动滚动到底部: 新内容生成时自动显示最新信息。
缺省的问答模式: 允许设置自定义的模式，默认为Agent.
Custom Modes: 允许使用自定义的模型。

AI对话模式

对话模式	自动文件操作	适用场景	关键操作步骤
Chat	需手动应用	精细修改、确认代码变更	生成代码->点击应用–>接受–>写入磁盘
自动补全	上下文提示	提升编码效率	输入片段->按Tab补全->连续操作
内嵌对话	选中内容处理	代码注释、即时知识查询	选中代码->调用对话->处理结果

Chat几种模式:

模式	特点	应用场景
Agent模式	自动化程度高 无需用户干预，AI会自动执行命令	需要快速原型开发、自动化重构、批量代码修改等
Ask模式	半自动化 安全性高	适合代码审查、逐步重构、AI辅助
Manual模式	完全手动 最高安全性	适合学习、查阅、代码片段生成等场景

内嵌窗口的核心应用场景:

• 代码生成，在光标位置生成指定功能代码(如快速排序函数)
• 代码注释，自动为选中代码添加详细注释，分析逻辑与潜在问题。
• 代码优化，生成try-catch异常处理结构，提升代码健壮性。
• 测试用例生成，针对函数生成全面测试场景(普通列表、重复元素、空列表等)。
• 函数注释生成，按规范生成包含参数、返回值、异常处理的详细注释。

配置远程仓库

操作环节	核心步骤	注意事项
环境安装	安装 Python(勾环境变量)、Git	Python 路径建议分层，Git 安装后重启 Cursor
码云配置	注册账号→创建仓库→生成私人令牌	令牌需妥善保存，仓库可设为私有
远程连接	修改 URL 为https://用户名:令牌@仓库地址，提交后发布	认证失败时通过终端命令修改URL，确保用户名和令牌正确
版本回滚	复制提交 ID→执行git revert→保存退出→重新发布	回滚到的是目标版本的前一状态，需通过命令行操作

自动补全

Tab自动补全
1.自动根据上下文，提供编码建议
2.代码格式化，自动补全会根据上下文内容，同时修改多个相同的位置
3.光标预测，自动补全会根据上下文内容，预测光标位置，并自动跳转到该位置

CodeBase用法

Cursor通过索引项目代码，建立文件关联关系，使AI能更精准理解项目结构与逻辑。
CodeBase作用

• 帮助AI分析项目功能、技术栈及文件关联;
• 支持通过功能描述或函数名快速定位代码位置;
• 提升对话时答案的准确性和上下文感知能力;

CodeBase配置
进入设设置–>indexing&Docs，可开启/关闭索引、重新生成或删除索引
还可以配置: 忽略特定文件/目录、检索Git历史、新建文件夹自动索引

项目文件过多时，避免频繁删除/重建索引，减少耗时

CodeBase应用场景

• 项目分析与理解(这个项目是做什么用的)
• 功能定位与代码查询(冒泡排序函数在哪)
• 跨文件关联查询(冒泡排序函数被哪些文件调用)

Rules for AI

通过配置规则规范AI生成内容的格式、逻辑及项目特定要求，确保AI输出符合开发者习惯。

配置规则

全局规则: 进入设置–> Rules，可添加多条规则。

• 规定代码格式: 函数名使用驼峰命名法，不包含下划线；
• 规范输出语言: 所有回答以中文回复;

项目规则: 在项目根目录创建.cursor_rules文件，通过勾选Enable Project Rules启用。
优先级：项目规则 > 全局规则，仅对当前项目生效。

生成规则

用chat-agent模式输入提示词(如 “生成网站项目的代码规范规则”), 自动生成.cursor_rules文件。

• 忽略配置: 排除node_modules、图片等无需索引的文件/目录；
• 代码风格: 缩进用4空格、字符串使用双引号、函数名驼峰命名等。

如果有什么规则不知道如何设置可以通过Chat模式咨询AI，然后根据答案调整对应的规则。

规则应用场景

代码规范: 统一团队代码风格(命名、缩进、引号等);
项目管理: 自动忽略无关文件(如依赖库、日志)，优化索引效率；
输出控制: 指定AI应答格式(如用Markdown表格返回结果)。

@提示符用法

@提示符用于在Chat对话框中快速引入各类上下文资源，包括文件、文件夹、代码段等，提升AI对话的针对性和准确性。

主要 @提示符各类用法解析

• @files 引入文件上下文
• @folders 引入文件夹上下文
• @code 引入代码段上下文
• @docs 引入外部文档(可以基于文档直接生成代码)
• @git 关联 Git 版本历史(该版本做了哪些修改)
• @past chats 引入历史的聊天对话作为上下文
• @web 联网搜索信息 AI会搜索网页并返回结果(不使用@web时仅基于本地知识回答)
• @lint errors 代码错误检查 输入@lint errors或@文件路径，AI会检查代码语法、缩进、SEO等问题并给出修改建议

Chat 支持@files、@folders、@code、@docs等全量提示符。
内嵌对话框: 新增@附近代码定义提示符，自动引入光标附近的函数、变量等上下文。

使用技巧

• 文件夹文件过多时，分批次引入或指定具体文件，减少上下文过载。
• 通过@docs索引API文档后，直接用Composer生成代码，提升开发效率。
• 在Notepad中记录需求，生成代码时用@notepad引入，确保功能对齐。

Compose保存机制

按钮	功能描述	反悔机制	会话状态
Save All	将所有生成的文件临时保存到本地磁盘，但不结束当前Composer会话	可继续修改、拒绝部分文件	会话保持活跃，支持后续操作
Accept All	永久保存所有生成的文件到本地磁盘，并结束当前Composer会话	无法反悔(需手动删除)	结束会话

对话一致性保持

多轮对话后大模型易遗忘上下文(如网站菜单、功能)，导致重复生成或文件混乱。

解决方案: 通过配置规则让Cursor自动总结每轮对话内容，写入项目文档(如README)，保持项目信息一致性。

配置Cursor Rules文件实现, 要求Composer每次会话后总结以下内容并追加到README文件

• 对话目的、完成任务、关键决策；
• 使用的技术栈(编程语言、框架)；
• 修改或新增的文件列表。

注: 大模型无法准确获取系统时间，总结中不包含真实时间戳。

{  
  "afterGenerate": {  
    "summaryToFile": {  
      "filePath": "README.md",  
      "append": true,  
      "include": ["purpose", "tasks", "decisions", "techStack", "modifiedFiles"]  
    }  
  }  
}  

关键注意事项
规则可定制: 当前规则为示例，可根据需求增减总结字段(如添加"未解决问题" “下一步计划”)
文件操作模式: 设置append: true确保 README内容累加，避免被覆盖。
时间戳限制: 大模型生成的日期不可靠，如需时间记录，建议手动补充。

Agent能力详解

Agent能力是Chat中的高级模式，除生成代码外，还能自动安装依赖、执行程序、调试代码并迭代优化。

Agent优点:

• 全流程自动化，无需手动安装依赖或运行程序，Agent自动完成;
• 智能迭代，发现代码问题后自动修复并重新执行，直至达到预期效果。

Agent安全配置与控制
启动Auto Run模式(自动执行开关)

• 开启 Agent自动执行命令(如安装依赖)，无需确认；
• 关闭 执行命令前弹出确认框(如Run Command按钮)，防止误操作。

命令白名单与黑名单
白名单 配置允许自动执行的命令(如python、pip install)提升效率；
黑名单 禁止自动执行危险命令(如rm、delete)，需手动确认；

删除文件保护
开启此选项后 Agent无法自动执行删除文件的命令，需手动确认。

Agent 与普通模式的区别

模式	代码生成	依赖安装	程序执行	错误迭代
普通模式	✔️	❌	❌	❌
Agent 模式	✔️	✔️	✔️	✔️

第三方模型

通过配置第三方平台的API接口(需兼容 OpenAI协议)，在Cursor中调用外部大模型。

前提条件:
注册第三方平台账号(如 Silicon Floor)，完成实名认证获取免费额度；
获取目标模型的API 钥和接口URL(需适配OpenAI格式)

添加步骤
进入设置–> Models，点击Add Model，输入第三方模型名称, 设置API密钥与URL
在Override OpenAI Base URL中粘贴第三方接口地址；
在API Key处填写平台生成的密钥，点击Save保存。

验证与启用
点击Verify验证配置，若提示模型不存在，需关闭其他未配置的模型，仅保留新添加的模型，验证通过后点击Enable启用模型。

注意事项

• 第三方模型可能存在功能限制(如仅支持对话，不支持代码生成);
• 配置错误时需检查模型名称、API密钥、URL是否完全匹配平台信息;
• 切换模型后需确认Override URL是否关闭，避免默认模型调用失败。

其它注意事项与安全提示

• 禁止上传公司机密项目或涉及隐私的代码，避免数据泄露；
• 开源项目分析仅用于学习参考，需遵守原项目的开源协议。