first commit

.cursor/rules/app-pages-mini-style.mdc

@@ -0,0 +1,68 @@
+---
+description: bdrp-app 页面写法（参考 bdrp-mini）
+globs: src/pages/**/*.vue
+alwaysApply: false
+---
+
+# bdrp-app 页面规范（按 mini 风格）
+
+- 使用 Vue SFC + `script setup`，不要混用 Options API。
+- 页面元信息统一写在 `definePage(...)`，并放在脚本顶部。
+- `layout` 只用三种：`home`（首页/资产/我的/推广类）、`default`（普通业务页）、`false`（登录/分享/维护等无壳页面）。
+- 站内路由跳转必须使用 uni 官方导航 API，不使用 `window.location.href`、`router.push`、`router.back`。
+- 跳转规范：普通页用 `uni.navigateTo`，替换当前页用 `uni.redirectTo`，回首页/重开流程用 `uni.reLaunch`，tab 页切换用 `uni.switchTab`，返回用 `uni.navigateBack`。
+- 接口调用使用 `async/await` + `try/catch`；失败统一 `uni.showToast({ title: 'xxx', icon: 'none' })`。
+- 页面不要直接硬编码产品枚举，优先后端配置 + 本地白名单兜底（与 mini 的动态加载策略一致）。
+- 页面模板优先使用 uni 标签：`<view>`、`<text>`、`<image>`、`<scroll-view>`、`<swiper>`；避免在页面层大量使用纯 H5 标签（如 `div/span/img`）。
+- 图片与资源使用 uni 写法：`<image :src="..." mode="aspectFill|aspectFit" />`，避免直接依赖 H5 行为。
+- 生命周期优先使用 uni 页面生命周期：`onLoad`、`onShow`、`onPullDownRefresh`、`onReachBottom`、`onUnload`；通用副作用再用 Vue 的 `onMounted/onUnmounted`。
+- 页面文件尾部允许并推荐使用 `<route ...>` 声明页面配置（如 `layout`、`style`、`title`、`auth`、`agent`）；与 `definePage(...)` 保持一致，避免冲突。
+- UI 组件库统一优先使用 `wot-design-uni`（`wd-*` 组件）；新增或重构页面时不再引入 `vant` 组件。
+- 历史页面若存在 `van-*` 组件（如 `van-button`、`van-icon`、`van-popup`、`van-field`），重构时应替换为 `wd-*` 或 uni 原生标签实现。
+
+## 示例
+
+```vue
+<script setup>
+definePage({ layout: 'default' })
+onLoad(() => {
+  // 页面参数初始化
+})
+
+onShow(() => {
+  // 页面每次可见时刷新
+})
+
+function toDetail() {
+  uni.navigateTo({ url: '/pages/help-detail' })
+}
+
+function back() {
+  uni.navigateBack()
+}
+</script>
+```
+
+```vue
+<script setup>
+// ❌ 不建议：站内页跳转使用 window/router
+function toDetail() {
+  window.location.href = '/pages/help-detail'
+}
+
+function toList() {
+  router.push('/pages/help')
+}
+</script>
+```
+
+```vue
+<route type="home" lang="json">
+{
+  "layout": "home",
+  "style": {
+    "navigationStyle": "custom"
+  }
+}
+</route>
+```