-
Vue3 UniApp项目开发规范总结:
## 页面类型规范
1. **系统原生导航栏页面**:使用 layout: 'default' + 自定义导航栏配置(如income.vue)
2. **自定义导航栏页面**:使用 navigationStyle: 'custom' + 手动处理安全区域(如referEarn.vue)
## 代码书写习惯
1. **UnoCSS样式**:完全使用UnoCSS原子类,避免传统CSS,优先使用内联样式避免动态类名问题
2. **组件库**:wot-design-uni (wd-前缀组件),包括wd-form、wd-input、wd-button等
3. **分页组件**:z-paging统一处理列表和滚动,配合useZPaging hook
4. **TypeScript**:严格类型定义,defineOptions命名规范
## 项目结构规范
1. **路由配置**:使用json5格式的route块,自动生成pages.json
2. **生命周期**:必须导入页面生命周期(即使未直接使用)
3. **插件配置**:自定义vite插件处理构建逻辑
4. **组件结构**:route配置 → script setup → template → style
## 具体编码规范
1. **安全区域**:自定义导航栏页面必须处理safeAreaInsets
2. **组件命名**:defineOptions中明确name属性
3. **表单处理**:使用wd-form + wd-input + 验证规则
4. **样式写法**:优先UnoCSS原子类,必要时使用:deep()修改组件样式
5. **背景图片**:统一使用/static/login-bg.png作为登录相关页面背景
#最佳实践
-
PromptX配置信息总结:
## 项目环境配置
- 项目路径:/Users/liangan/Documents/work_files/code/BandhuBuyUniBest
- IDE类型:cursor
- MCP实例:mcp-4121
- PromptX版本:v0.2.0 (dpml-prompt@0.2.0, Node.js v24.4.0)
## 配置文件结构
- 主配置:.promptx/pouch.json(记录状态历史和当前状态)
- 资源注册表:.promptx/resource/project.registry.json(项目级资源管理)
- 记忆存储:.promptx/memory/noface/declarative.dpml(角色记忆文件)
- 备份目录:.promptx/backup/(配置备份)
## 当前状态
- 系统状态:service_discovery
- 可用角色:assistant, luban, noface, nuwa, sean(5个系统角色)
- 项目资源:当前为空,可在domain目录下创建角色资源
- 支持多项目环境,项目间完全隔离
#其他