bandhuBuy-uniapp/.promptx/memory/noface/declarative.dpml

<?xml version="1.0" encoding="UTF-8"?>
<memory>
  <item id="mem_1752633976293_138s3tkn5" time="2025/07/16 10:46">
    <content>
      Vue3 UniApp项目开发规范总结：
    
      ## 页面类型规范
      1. **系统原生导航栏页面**：使用 layout: &#x27;default&#x27; + 自定义导航栏配置（如income.vue）
      2. **自定义导航栏页面**：使用 navigationStyle: &#x27;custom&#x27; + 手动处理安全区域（如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作为登录相关页面背景
    </content>
    <tags>#最佳实践</tags>
  </item>
</memory>