第一步：重新检测环境
启动工具箱后点击“重新检测”或按 F5，扫描本机已安装的 AI IDE 和已知项目。如果客户端显示未安装，先启动一次对应客户端，使其生成配置目录；仍无法识别时再手动添加项目目录。
第二步：选择部署作用域
项目级：推荐首次使用
只影响当前项目，更容易隔离问题、确认规则是否进入对话，也更适合 Cursor。
全局级：适合固定配置
对同一客户端的多个项目统一生效，适合已经验证稳定的长期规则。
第三步：检查变更预览
点击对应客户端卡片中的部署入口，认真对照“变更前”和“变更后”。确认目标文件、作用域和写入内容正确以后再继续。预览是避免误改配置的关键步骤。
第四步：确认写入与备份
确认后由工具按客户端规则写入配置。修改已有文件前通常会生成带时间戳的备份；首次创建的新文件不一定需要额外备份。如果目标文件曾被手动修改，建议先自行复制一份。
第五步：重启并验证
- 完全退出对应 AI IDE 进程后重新打开。
- 确认规则面板或项目目录中已经出现目标配置。
- 使用 Agent、Chat 等完整对话窗口验证，不要只依赖快捷输入模式。
- 对于按需加载规则的客户端，不保证每轮对话都采用所有规则，应以客户端行为为准。
第六步：撤销与恢复
需要恢复时点击撤销。工具只处理它写入的内容，不应整体覆盖或删除用户已有规则与项目文件。撤销后再次重启客户端，确认配置回到原有状态。
Cursor部署建议
项目级部署 → 完全退出 → 重新打开 → 完整对话验证
Cursor属于按需加载型客户端。仅做全局部署时，规则不一定稳定进入每一轮对话。优先对正在使用的仓库执行项目级部署，通常更容易确认效果。