本文意在总结Unity中使用Cursor的结论，实践，心得，信息来源以官网为主
一.Cursor下载安装
登录cursor官网下载cursor
下载完成后根据向导一路点下去安装即可
安装完成后回要求你登录账号，这里我选的是用GitHub账号登录
其中一步要求验证手机号，这里前面一定填+86，然后输入11位手机号
安装完登录后cursor打开就是一个基于VSCode的代码编辑器：
二.基础概念
2.1 Agent智能体
右上角这个Icon可以显示/隐藏一个界面
这个界面系统叫做Agent.不是代理的意思，而是应该译作智能体
在Agent中使用队列
在 Agent 处理当前任务时，将后续消息加入队列。你的指令会依次等待，并在就绪后自动执行。
- 当 Agent 正在工作时，输入你的下一条指令
- 按 Enter 将其添加到队列
- 消息会按顺序显示在当前任务下方
- 按需拖动以重新排序队列中的消息
- Agent 完成当前任务后会按顺序依次处理队列中的消息
Ctrl + Enter可以让消息立即执行，并中断当前正在执行的任务
2.2 概率性
传统软件是确定性的。给定相同输入，多次运行会得到相同输出。
AI 模型不是这样。它们具备概率性。这意味着在相同输入下，模型可能走出多种不同路径。
2.3 幻觉
"幻觉"是指 AI 模型自信地生成看似合理但实际错误的信息。
当 AI 模型不知道某件事时，它并不总会说"I don't know." 相反，它会基于见过的模式生成看起来最可能的内容。对编程来说，这可能意味着
模型提供商会收集大量互联网文本（以及其他专有数据）来训练模型，直到某个被称为"knowledge cutoff"的日期。这个日期是模型掌握的最新知识点。如果你询问的是该日期之后才出现的库，AI 模型可能会给出不正确的解决方案。
对模型返回的结果保持怀疑，并独立验证其建议是有必要的。高效使用 AI 的关键是建立验证思维。每条建议都是起点，而非最终答案。
2.4 Token
就像计算机并不真正理解字母"A"，而是用二进制（1 和 0）工作一样，AI 模型也不是直接处理"hello"或"world"这样的词。相反，它们会把一切拆分为更小的片段，称为令牌（tokens）。
例如，"hello"可能是一个令牌，但"understanding"可能会被拆分为多个令牌，如"under""stand""ing"。有时甚至词的部分、标点或空格也会单独成为令牌。
- 令牌决定了模型的计费方式。 按令牌计费，而不是按单词或字符。
- 令牌也是衡量模型速度的指标。 更快的模型具有更高的 TPS（每秒令牌数），并更快返回给用户。
由于 AI 模型按 token 计费，理解它们是控制成本的关键。
2.5 上下文
你的输入以及模型的输出都会成为"上下文"的一部分，输入的上下文可以是文本或图片，准确合理的输入上下文是高质量输出的关键。
当前打开的文件、终端输出等会自动被加入上下文，同一个Chat中的历史记录也是上下文的一部分，上下文的长度是有限制的。可点击Chat的圈圈按钮，查看Chat的Token使用.
2.6 工具
没有工具时，AI 模型只能使用你在上下文中明确提供的信息。有了工具，它可以主动探索并与代码库交互。
以下能力都由工具提供：
- 读取与写入文件 到你的代码库
- 搜索代码 以查找相关函数或模式
- 运行 shell 命令 来测试代码或安装依赖
- 访问文档 或在网上搜索最新信息
- 检查错误 通过运行 linter 或测试
三.使用Rule
3.1 Rule概述
Rule作用：统一编码风格，制定工作流，规范，约束
Rule工作方式：应用规则时，其内容会被添加到模型上下文的起始位置。这为 AI 提供一致的指导。
Rule种类：
1.User Rule：适用于Cursor打开的所有项目的规则，保存于Settings中，如下图创建
2.Project Rule：适用于当前项目的规则，以.mdc文件保存于.cursor/rules
- 优先级 ：Rule按以下顺序应用：项目规则 → 用户规则。所有适用规则会被合并；当Rule冲突时，较前的来源优先。
3.2 创建Project Rule
在Chat中输入： /create-rule: 规则1，规则2 ....
agent会创建一个*.mdc的文件保存该Rule, eg:
/create-rule:不要改Assets/Test下的lua文件，用尽可能少的代码实现功能，尽量少加新文件，不要删除现有的注释，重要代码要加注释, 文件命名为MyRules，用中文写
还可以在Settings中创建Project Rule(不推荐)
Settings的Rules视图会显示所有的Rule，悬浮于一个Rule可以点击垃圾桶将其删除
3.3 控制规则生效范围
Rule文件最上放的description，alwaysApply，globs用来控制规则生效范围
说明如下：
alwaysApply |
description |
globs |
行为 |
|---|---|---|---|
true |
--- | --- | 始终包含。会忽略 globs 和 description。 |
false |
--- | 已提供 | 当匹配的文件位于上下文中时自动附加。 |
false |
已提供 | 省略 | 智能体会读取 description，并在相关时引入该规则。 |
false |
省略 | 省略 | 仅当你在聊天中用 @ 提及该规则时才会包含。 |
四.Agents Window
2026 年 4 月 2 日发布的 Cursor 3 正式上线，推出了新功能Agents Window，点击右上角的Agents Window可新打开一个界面
Agents Window的特点如下：
1.可以打开多个Workspace目录，在Editor Window实现这点要打开多个Cursor
2.会显示Chat 历史，方便任务追踪追踪
3.支持agent分屏，可查看多个agent的进度
五.Cursor Settings设置
下面记录了一些应该调整的设置
1.Command Allowlist设置成RunEverything
让Cursor运行工具和命令更流畅，无需手动批准
2.Max Tab Count设置为Unlimited
不限制Chat Tab的数量
3.Auto-Approve Mode Transitions开启
允许Cursor自动调整模式，提高流畅性
4.恢复出厂的Settings
将C:\Users\Administrator\AppData\Roaming\Cursor下的User删除，重新打开Cursor可以将Settings的设置恢复成最初状态
六.Cursor降智
有时Cursor对代码的修改偏离预期，甚至怪异的编辑，比如增加很多空行，这种行为称为降智。出血这种情况的原因可能是Chat记录过长，或者输入的上下文混乱或是被Cursor服务器放入一个低优先级通道。在新窗口打开一个Chat重新提问即可。
七.最佳实践
1.明确需求
使用Plan模式，向Agent索要并回复澄清性问题，明确需求
- 降低Agent实现的功能的规模
对于一定规模的功能，先使用Plan模式，将其拆解为若干个子功能，逐一实现子功能并验证提交。使用小步快跑的方式完成整个功能。失败情况：Agent给出方案1->验证失败->要求修复->Agent给出方案2->验证失败->要求修复
- 让agent自行验证
要用 agent 交付功能，关键在于把工作拆分为 agent 能自行校验的步骤。每一步验证成功，再执行下一步。当 agent 能判断自己的代码是否正确时，它的表现最佳。让 agent 根据期望的输入和输出编写测试。
4.Review Agent的代码
agent的代码即使通过了测试，也需要你去review。可以让agent在改动的代码中加入注释，解释代码实现，从而加快你理解代码的速度，理解后再提交。未经review的代码可称为技术债务，持续累积会降低代码质量，bug频生。
- 要求Agent提供图表
可以在输入上下文中让Agent提供图标，给出可视化的输出