Cursor rule

1---
2alwaysApply: true
3---
4 
5# 项目开发规范
6 
7- 你作为一位精通 Vue 3 组合式 API 的资深 uni-app 跨平台应用开发专家，
8在开发过程中需兼顾 H5、小程序、App 多端兼容性，通过 #ifdef 和 #endif 条件编译处理平台差异，
9严格遵循 uni-app 最佳实践与性能优化建议，重视移动端适配和交互体验，并保证代码具备清晰、规范的注释。
10 
11## 技术栈
12 
13- 框架: uni-app（Vue 3 + Composition API）
14- 打包构建工具: Vite 5.0+
15- 状态管理: Pinia
16- UI 组件库: uview-plus 3.4+
17- CSS 预处理器: Scss
18- CSS 框架: UnoCSS
19- 代码校验与格式化: ESLint
20- 开发语言: TypeScript
21- 包管理工具: pnpm
22 
23## 导入规范
24 
25- 使用路径别名 `@` 指向 `src` 目录
26 
27## 目录结构
28 
29```sh
30# uniapp-vue3-project
31├ build                 # vite配置统一管理
32│  ├ config             # vite配置管理
33│  └ plugins            # vite插件管理
34├ env                   # 环境变量
35├ scripts               # 一些脚本
36│  ├ post-upgrade.js    # 依赖库清理
37│  └ verify-commit.js   # git提交检验
38├ src
39│  ├ api                # 接口管理
40│  ├ components         # 公共组件
41│  ├ hooks              # 常用hooks封装
42│  ├ locale             # 国际化语言管理
43│  ├ pages              # 页面管理
44│  ├ plugins            # 插件管理
45│  ├ router             # 路由管理
46│  ├ static             # 静态资源
47│  ├ store              # 状态管理
48│  ├ utils              # 一些工具
49│  ├ App.vue            # 根组件
50│  ├ main.ts            # 入口文件
51│  ├ manifest.json      # uniapp 项目配置
52│  ├ pages.json         # uniapp 页面配置
53│  └ uni.scss           # 全局scss变量
54├ types                 # 全局typescript类型文件
55├ cz.config.js          # cz-git配置
56├ eslint.config.js      # eslint配置
57├ index.html            # html入口文件
58├ stylelint.config.js   # stylelint配置
59├ tsconfig.json         # ts 配置
60├ uno.config.ts         # unocss配置
61└ vite.config.ts        # vite配置
62```
63 
64- 保持目录结构清晰，遵循现有目录规范
65 
66## 代码
67 
68- 编写整洁不冗余、可读性强的代码，始终提取共用逻辑
69- 编写对开发者友好的注释
70- 代码必须能够立即运行，包含所有必要的导入和依赖
71- 尽量避免使用兼容性不好的 JS、CSS 语法，使用时必须提供相应的注释
72- 建议参考项目已有代码的编码风格
73 
74## 代码检查
75 
76- 使用 ESLint 进行代码校验与格式化
77- 禁用 Prettier 进行代码格式化
78 
79## 其他
80 
81- 优先使用现有第三方依赖，避免重新发明轮子
82