🎨 AI Rules Manager
让 AI 编程更智能、更专业的 VSCode 扩展 - 同时支持 Cursor 和 Cline
一个强大的 VSCode 扩展，专为 Cursor AI 编辑器和 Cline AI 助手设计，帮助您快速配置和管理专业的 AI 编程规则。通过预设的规则模板和智能管理功能，让您的 AI 助手更好地理解您的编码风格和项目需求。
✨ 功能亮点
🤖 支持多种 AI 助手
- 🎯 Cursor AI: 生成
.cursor/rules/ 目录下的 .mdc 格式规则文件
- 🤖 Cline AI: 生成
.clinerules/ 目录下的 .md 格式规则文件
- 智能转换: 自动将规则转换为目标 AI 助手的专用格式
🔧 丰富的内置规则
- 🌐 前端开发
- HTML/CSS/JS: 现代网页开发标准和最佳实践
- React: React 生态系统开发规范，包含 Hooks、组件设计模式
- Next.js: 全栈开发规则，涵盖 SSR、API 路由和性能优化
- ⚙️ 通用规则
- 适用于所有编程语言的基础开发规范
- 代码质量、安全性和可维护性指导
- 📋 版本控制
- Git Commit: 标准化提交格式、业务域管理和团队协作规范
- 🌍 国际化
- 智能i18n: 自动文案检测、翻译API集成和多语言管理
- 🛡️ 代码安全
- 📝 开发工具
🚀 快速开始
方式一：命令面板 (推荐)
1. 按 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (Mac)
2. 输入 "AI Rules" 或 "添加"
3. 选择 "添加 AI 规则到项目（支持 Cursor 和 Cline）"
4. 选择目标 AI 助手（Cursor 或 Cline）
5. 选择适合的规则类型
6. 确认添加到项目
方式二：右键菜单
1. 在资源管理器中右键点击文件夹
2. 选择 "ZA: 添加 AI 规则到项目（支持 Cursor 和 Cline）"
3. 选择目标 AI 助手和规则类型并确认
📂 文件结构
规则文件会根据选择的 AI 助手添加到不同位置：
Cursor AI 规则
your-project/
├── .cursor/
│ └── rules/
│ ├── general.mdc
│ ├── react.mdc
│ └── next.mdc
└── ...
Cline AI 规则
your-project/
├── .clinerules/
│ ├── general.md
│ ├── react.md
│ └── next.md
└── ...
🎯 AI 助手对比
| 特性 |
Cursor AI |
Cline AI |
| 规则目录 |
.cursor/rules/ |
.clinerules/ |
| 文件格式 |
.mdc |
.md |
| 元数据支持 |
YAML front matter |
Markdown 标题 |
| 多文件支持 |
✅ |
✅ |
| 规则合并 |
✅ |
✅ |
📋 规则冲突处理
当目标位置已存在规则文件时，扩展提供三种处理方式：
| 选项 |
说明 |
适用场景 |
| 🔄 覆盖 |
用新规则完全替换现有规则 |
想要使用全新的规则配置 |
| 🔗 合并 |
将新规则追加到现有规则 |
希望同时使用多套规则 |
| ❌ 取消 |
保持现有规则不变 |
不想修改当前配置 |
🎯 规则详情
📱 前端开发规则
HTML/CSS/JavaScript
- 现代 HTML5 语义化标签使用
- CSS3 最佳实践和响应式设计
- ES6+ JavaScript 特性和模块化开发
- 性能优化和无障碍访问指导
React 开发
- 函数组件和 Hooks 最佳实践
- 状态管理和生命周期优化
- 组件设计模式和代码复用
- 性能优化和错误边界处理
Next.js 全栈
- 服务端渲染 (SSR) 和静态生成 (SSG)
- API 路由设计和数据获取
- 图像优化和SEO最佳实践
- 部署和性能监控
🔧 通用开发规则
- 代码风格和命名规范
- 错误处理和日志记录
- 安全编码和最佳实践
- 文档编写和代码注释
⚙️ 系统要求
- VSCode: 1.93.0 或更高版本
- AI 助手:
- Cursor 编辑器 (用于 Cursor 规则)
- Cline 扩展 (用于 Cline 规则)
- 操作系统: Windows, macOS, Linux
🔧 生效方式
Cursor AI
- 添加规则文件后，重启 Cursor 编辑器
- 规则会自动应用到当前项目
- AI 助手将根据规则提供更精准的建议
Cline AI
- 添加规则文件后，Cline 会自动检测并加载规则
- 可通过 Cline 的规则管理面板切换规则
- 规则会立即应用到当前对话
🛠️ 常见问题
❓ 如何选择合适的 AI 助手？
选择指南：
- Cursor AI: 如果您使用 Cursor 编辑器进行开发
- Cline AI: 如果您在 VSCode 中使用 Cline 扩展
- 都支持: 两种助手都支持相同的规则内容，只是格式不同
❓ 规则文件无法添加
可能原因及解决方案：
- 确保已打开项目文件夹 (不是单个文件)
- 检查目录写入权限
- 尝试以管理员权限运行 VSCode
❓ 规则没有生效
解决步骤：
- Cursor: 确认规则文件在
.cursor/rules/ 目录，重启编辑器
- Cline: 确认规则文件在
.clinerules/ 目录，检查 Cline 规则面板
- 检查规则文件内容格式是否正确
❓ 可以同时使用两种 AI 助手吗？
答案：可以！
- 您可以为同一个项目同时生成 Cursor 和 Cline 规则
- 两种格式的规则可以并存，互不冲突
- 根据使用的 AI 助手自动应用对应的规则
🎯 使用技巧
💡 最佳实践
- 根据使用的 AI 助手选择对应的规则格式
- 为不同类型的项目使用对应的规则
- 定期更新规则以适应新的开发标准
- 团队开发时统一使用相同的规则配置
🔄 规则维护
- 定期检查和清理不需要的规则
- 备份重要的自定义规则
- 关注扩展更新以获取新的内置规则
🔗 相关链接
🎨 让 AI 编程更智能 | Made with ❤️
如果这个扩展对您有帮助，请给一个 ⭐️
| |
