cykj/hzdyjs

0 Fork 0

Files

T

- 🔥 完全重写 .cursor/cursorrules-mobile.md (940行)
  * 基于实际mobile工程Vue 3.4.21+uniapp+uview-plus架构
  * 移除所有JeeSite相关内容，精准匹配实际项目
  * 新增11个完整章节：技术栈、项目结构、页面开发、组件规范等

- 📚 创建完整规范文档 docs/开发文档/移动端开发规范总结.md (800+行)
  * 涵盖从项目架构到部署的全流程指导
  * 提供可直接使用的页面和组件模板
  * 包含现代CSS变量设计系统和用户体验优化

- 🔄 同步更新主配置文件 .cursorrules
  * 更新移动端技术栈描述
  * 调整为Vue 3.4.21+uniapp+uview-plus 3.4.45架构

- 📝 完善变更记录
  * 详细记录规范更新背景和技术价值
  * 为后续维护提供完整历史记录

核心价值：解决规范与实际项目不匹配问题，为Cursor AI提供准确的移动端开发上下文，确保生成代码完全符合实际项目架构。

2025-07-04 15:51:33 +08:00

4.0 KiB

Raw Blame History

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        # 移动端开发规范 (Vue 3 + uniapp + uview-plus)
└── 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

移动端开发规范
Vue 3 + uni-app + uview-plus 技术栈
现代化智慧校园移动应用架构
页面和组件开发规范（CSS变量设计系统）
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

🚀 性能优势

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

🔧 维护说明

规范更新原则

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

文件同步

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

📝 更新记录

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

🎯 使用建议

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

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

4.0 KiB Raw Blame History