feat: update rules

Author: pany-ang

.cursor/rules/git.mdc

@@ -1,13 +1,11 @@
 ---
-description: 辅助生成 Git 提交信息
+description: 辅助生成 Git 提交信息和执行 Git 命令
 alwaysApply: false
 ---
 
 # Git 提交规范
 
-- 你是一位前端开发专家，精通 Git 操作
-
-## Commit 规范
+## Commit
 
 提交模板 `type: message`，具体要求如下:
 
@@ -27,11 +25,10 @@ alwaysApply: false
 
 3. 保持 `message` 简洁明了，描述清楚变更内容
 
-## 分支说明
+## 分支
 
-- `main / master`: 主分支
-- `4.x`: 已停止维护的 4.x 版本代码
-- `gh-pages`: GitHub Pages 构建分支
+- 优先创建个人分支进行编码
+- 禁止直接对主分支进行编码
 
 ## 其他
 

.cursor/rules/index.mdc

@@ -4,14 +4,18 @@ alwaysApply: true
 
 # 规则
 
+## 角色定义
+
+你是一位高级前端工程师，精通前端架构，精通 Vue3、Vue Router、Pinia 等前端框架，精通 TS、JS 等前端语言，精通 Git 操作
+
 ## 模型回复
 
 - 请简明扼要地回答，避免不必要的重复或填充语言
 - 始终以简体中文回复
 
 ## 细分规则文件
 
-- project.mdc: 项目开发规范
-- vue.mdc: Vue 开发规范
-- ts.mdc: TypeScript 开发规范
-- git.mdc: Git 提交规范
+- `project.mdc`: 项目开发规范
+- `vue.mdc`: Vue 开发规范
+- `ts.mdc`: TS 开发规范
+- `git.mdc`: Git 提交规范

.cursor/rules/project.mdc

@@ -4,87 +4,26 @@ alwaysApply: true
 
 # 项目开发规范
 
-- 你是一位前端开发专家，精通前端架构
-
-## 技术栈
-
-- 框架: Vue 3.5+
-- 打包构建工具: Vite 7+
-- 路由管理: Vue Router
-- 状态管理: Pinia
-- UI 组件库: Element Plus
-- CSS 预处理器: Scss
-- 代码校验与格式化: ESLint
-- 开发语言: TypeScript
-- 包管理工具: pnpm
-- 网络请求: Axios
-
-## 导入规范
+## 导入
 
 - 使用路径别名 `@` 指向 `src` 目录
 - 使用路径别名 `@@` 指向 `src/common` 目录
 
-## 目录结构
-
-```sh
-# v3-admin-vite
-├─ .husky                # commit 时进行代码校验和格式化
-├─ .vscode               # vscode 配置和插件
-├─ public
-│  ├─ favicon.ico        # 网站头像
-│  ├─ app-loading.css    # 首屏 loading 动画
-│  └─ detect-ie.js       # 检测 ie
-├─ src
-│  ├─ common             # 通用目录
-│  │  ├─ apis            # 通用目录 - 接口
-│  │  ├─ assets          # 通用目录 - 静态资源
-│  │  ├─ components      # 通用目录 - 组件
-│  │  ├─ composables     # 通用目录 - 组合式函数
-│  │  ├─ constants       # 通用目录 - 常量
-│  │  └─ utils           # 通用目录 - 工具函数
-│  ├─ http               # 网络请求
-│  ├─ layouts            # 布局
-│  ├─ pages              # 页面
-│  │  └─ login           # 登录模块
-│  │     ├─ apis         # 登录模块 - 私有接口
-│  │     ├─ components   # 登录模块 - 私有组件
-│  │     ├─ composables  # 登录模块 - 私有组合式函数
-│  │     ├─ images       # 登录模块 - 私有图片
-│  │     └─ index.vue    # 登录模块 - 页面
-│  ├─ pinia              # 状态管理
-│  ├─ plugins            # 插件（全局组件、自定义指令等）
-│  ├─ router             # 路由
-│  ├─ App.vue            # 入口页面
-│  └─ main.ts            # 入口文件
-├─ tests                 # 单元测试
-├─ types                 # 类型声明
-├─ .editorconfig         # 编辑器配置
-├─ .env                  # 所有环境
-├─ .env.development      # 开发环境
-├─ .env.production       # 生产环境
-├─ .env.staging          # 预发布环境
-├─ eslint.config.js      # eslint 配置
-├─ tsconfig.json         # ts 配置
-├─ uno.config.ts         # unocss 配置
-└─ vite.config.ts        # vite 配置
-```
-
-- 保持目录结构清晰，遵循现有目录规范
-- 同一个业务逻辑的代码和资源应当被收拢到了一起，避免在不同的目录间来回跳跃 (例如登录模块的接口应该放在 `@/pages/login/apis` 而不是 `@/common/apis`)
-
-## 代码
+## 编码
 
 - 编写整洁不冗余、可读性强的代码，始终提取共用逻辑
-- 编写对开发者友好的注释
+- 针对关键步骤和方法编写对开发者友好的注释
 - 代码必须能够立即运行，包含所有必要的导入和依赖
 - 尽量避免使用兼容性不好的 JS、CSS 语法，使用时必须提供相应的注释
-- 建议参考项目已有代码的编码风格
+- 优先参考项目已有代码的编码风格
+- 优先使用项目内置的组件和工具，其次是已引入的第三方依赖，避免重新发明轮子
 
 ## 代码检查
 
 - 使用 ESLint 进行代码校验与格式化
 - 禁用 Prettier 进行代码格式化
 
-## 其他
+## 本地环境
 
-- 优先使用现有第三方依赖，避免重新发明轮子
+- 使用 node 版本 20.19+ 或 22.12+ 或最新稳定版
+- 包管理工具使用 pnpm 10+ 或最新稳定版

.cursor/rules/ts.mdc

@@ -1,11 +1,9 @@
 ---
-globs: *.ts,*.tsx,*.d.ts
+globs: *.ts, *.tsx, *.d.ts
 alwaysApply: false
 ---
 
-# TypeScript 开发规范
-
-- 你是一位前端开发专家，精通 TypeScript、JavaScript 等前端技术
+# TS 开发规范
 
 ## 类型
 
@@ -37,6 +35,6 @@ alwaysApply: false
 - 实现适当的空值检查
 - 避免不必要的类型断言
 - 为公共函数使用显式返回类型
-- 回调使用箭头函数
-- 启用 TypeScript 严格模式
+- 回调优先使用箭头函数
+- 启用 TS 严格模式
 - 禁止不必要的类型体操，以可读性为主

.cursor/rules/vue.mdc

@@ -5,8 +5,6 @@ alwaysApply: false
 
 # Vue 开发规范
 
-- 你是一位前端开发专家，精通 Vue、Vue Router、Pinia、Element Plus 等前端框架
-
 ## 代码风格
 
 - 组件: 使用单文件组件 (SFC)
@@ -41,14 +39,13 @@ alwaysApply: false
 
 - 对应目录: `@/router`
 - 路由名称必须与组件名称保持一致
-- 路由守卫逻辑缜密，应当避免频繁更改
+- 路由守卫逻辑缜密，非必要不修改
 
 ## 状态管理
 
 - 对应目录: `@/pinia`
-- 使用 Pinia
-- Store 应该按模块划分
-- 优先使用 Setup store 语法，而不是 Option Store 语法
+- 按模块划分 Store
+- 优先使用 Setup Store 语法，而不是 Option Store 语法
 - 避免无脑使用全局状态管理
 
 ## 样式
@@ -66,4 +63,4 @@ alwaysApply: false
 
 ## 参考示例文件
 
-@/pages/demo/element-plus/index.vue
+`src/pages/demo/element-plus/index.vue`

.trae/rules/git.md

@@ -0,0 +1 @@
+../../.cursor/rules/git.mdc

.trae/rules/index.md

@@ -0,0 +1 @@
+../../.cursor/rules/index.mdc

.trae/rules/project.md

@@ -0,0 +1 @@
+../../.cursor/rules/project.mdc