# Cursor 规范文件拆分说明

## 🎯 拆分目的

为了提升 Cursor 编辑器的运行效率和规范管理的便利性，我们将原本的大型`.cursorrules`文件（2359 行）拆分为多个专门的规范文件。

## 📁 文件结构

```
.cursor/
├── README.md                    # 本说明文件
├── cursorrules-docs.md          # 文档管理规范
├── cursorrules-frontend.md      # 前端开发规范 (Vue 3 + TypeScript)
├── cursorrules-backend.md       # 后端开发规范 (Spring Boot + MyBatis)
├── cursorrules-mobile.md        # 移动端开发规范 (uniapp + uView UI)
└── cursorrules-api-test.md      # API测试和登录方法
```

## 📋 文件说明

### 1. cursorrules-docs.md

-   **项目文档管理规范**
-   文档目录组织结构
-   强制性文档同步更新规则
-   变更记录管理规范
-   业务模块文档管理
-   API 文档管理规范
-   测试文档管理规范

### 2. cursorrules-frontend.md

-   **Web 前端开发规范**
-   Vue 3 + TypeScript 技术栈
-   Art Design Pro UI 规范
-   组件开发标准
-   API 接口定义规范
-   状态管理和路由配置
-   项目架构和性能优化

### 3. cursorrules-backend.md

-   **后端开发规范**
-   Spring Boot 技术栈
-   数据库设计规范（强制性）
-   API 接口规范（强制性）
-   菜单界面和权限配置
-   标准代码模板

### 4. cursorrules-mobile.md

-   **移动端开发规范**
-   uni-app + uView UI 技术栈
-   页面和组件开发规范
-   API 对接规范
-   状态管理和配置
-   性能优化和测试

### 5. cursorrules-api-test.md

-   **API 测试和登录方法**
-   AES+RSA 双重加密登录
-   API 测试最佳实践
-   自动化测试脚本
-   性能测试方法

## 🔄 使用方式

### Cursor 编辑器自动加载

Cursor 编辑器会自动扫描项目中的规范文件，包括`.cursor/`目录下的所有规范文件。拆分后的文件仍然能够被 Cursor 正常识别和使用。

### 手动引用

如果需要明确引用特定规范，可以在对话中提及：

-   "请按照前端开发规范..."
-   "遵循后端 API 接口规范..."
-   "参考文档管理规范..."

### 模块化开发

现在可以针对不同技术栈进行专门的开发：

-   前端开发人员主要关注 `cursorrules-frontend.md`
-   后端开发人员主要关注 `cursorrules-backend.md`
-   移动端开发人员主要关注 `cursorrules-mobile.md`
-   测试人员主要关注 `cursorrules-api-test.md`

## 🚀 性能优势

1. **加载速度提升**: 每个文件体积更小，加载更快
2. **内容精准**: 根据开发场景加载相关规范
3. **维护便利**: 不同技术栈的规范独立维护
4. **版本管理**: 便于跟踪不同模块的规范变更

## 🔧 维护说明

### 规范更新原则

1. **技术栈专门化**: 每个文件只包含相关技术栈的规范
2. **内容完整性**: 确保每个文件内容自包含，可独立使用
3. **交叉引用**: 在需要时明确说明与其他规范文件的关联

### 文件同步

-   当项目架构或通用规范发生变化时，需要同步更新相关文件
-   重要的跨模块规范变更需要在多个文件中保持一致

## 📝 更新记录

-   **2025-07-01**: 完成.cursorrules 文件拆分，创建 5 个专门规范文件
-   **拆分原因**: 提升 Cursor 运行效率，便于规范管理
-   **文件保留**: 所有原有内容完整保留，无任何删除

## 🎯 使用建议

1. **日常开发**: Cursor 会自动应用相关规范
2. **规范查阅**: 可直接打开对应的规范文件查看详细内容
3. **团队协作**: 不同角色的开发者可专注相关规范文件
4. **规范更新**: 按技术栈分别维护和更新规范内容

---

**维护人员**: wuzilong  
**创建时间**: 2025-07-01 16:15:00  
**文件总数**: 5 个专门规范文件  
**原文件行数**: 2359 行  
**内容完整性**: 100%保留