Przeglądaj źródła

docs: 更新项目文档规范及开发命令

- 添加支付宝小程序开发命令和构建配置
- 明确全局组件和局部组件的存放位置
- 更新第三方组件库支持列表
- 补充项目功能说明和核心文件描述
- 修正页面配置宏定义说明
feige996 6 miesięcy temu
rodzic
commit
d53bf38274

+ 3 - 1
.cursor/rules/development-workflow.mdc

@@ -5,6 +5,7 @@
 2. 开发环境:
    - H5: `pnpm dev` 或 `pnpm dev:h5`
    - 微信小程序: `pnpm dev:mp`
+   - 支付宝小程序: `pnpm dev:mp-alipay`
    - APP: `pnpm dev:app`
 
 ## 代码规范
@@ -15,7 +16,8 @@
 
 ## 构建和部署
 - H5 构建:`pnpm build:h5`
-- 小程序构建:`pnpm build:mp`
+- 微信小程序构建:`pnpm build:mp`
+- 支付宝小程序构建:`pnpm build:mp-alipay`
 - APP 构建:`pnpm build:app`
 - 类型检查:`pnpm type-check`
 

+ 3 - 1
.cursor/rules/project-overview.mdc

@@ -8,7 +8,7 @@ alwaysApply: true
 ## 项目特点
 - 支持 H5、小程序、APP 多平台开发
 - 使用最新的前端技术栈
-- 内置约定式路由、layout布局、请求封装等功能
+- 内置约定式路由、layout布局、请求封装、登录拦截、自定义tabbar等功能
 - 无需依赖 HBuilderX,支持命令行开发
 
 ## 核心配置文件
@@ -26,9 +26,11 @@ alwaysApply: true
 - `src/http/` - HTTP 请求封装
 - `src/store/` - 状态管理
 - `src/tabbar/` - 底部导航栏
+- `src/App.ku.vue` - 全局根组件(类似 App.vue 里面的 template作用)
 
 ## 开发命令
 - `pnpm dev` - 开发 H5 版本
 - `pnpm dev:mp` - 开发微信小程序
+- `pnpm dev:mp-alipay` - 开发支付宝小程序(含钉钉)
 - `pnpm dev:app` - 开发 APP 版本
 - `pnpm build` - 构建生产版本

+ 3 - 3
.cursor/rules/uni-app-patterns.mdc

@@ -3,12 +3,12 @@
 ## 页面开发
 - 页面文件放在 [src/pages/](mdc:src/pages/) 目录下
 - 使用约定式路由,文件名即路由路径
-- 页面配置在仅需要在 `route-block` 中配置标题等内容即可,会自动生成到 `pages.json` 中
+- 页面配置在仅需要在 宏`definePage` 中配置标题等内容即可,会自动生成到 `pages.json` 中
 
 ## 组件开发
-- 组件文件放在 [src/components/](mdc:src/components/) 目录下
+- 组件文件放在 [src/components/](mdc:src/components/) 或者 [src/pages/xx/components/](mdc:src/pages/xx/components/) 目录下
 - 使用 uni-app 内置组件和第三方组件库
-- 支持 wot-design-uni\uv-ui\uview-plus 等多种第三方组件库 和 z-paging 组件
+- 支持 wot-ui\uview-pro\uv-ui\sard-ui\uview-plus 等多种第三方组件库 和 z-paging 组件
 - 自定义组件遵循 uni-app 组件规范
 
 ## 平台适配

+ 3 - 2
.cursor/rules/vue-typescript-patterns.mdc

@@ -4,10 +4,11 @@
 - 使用 Composition API 和 `<script setup>` 语法
 - 组件文件使用 PascalCase 命名
 - 页面文件放在 `src/pages/` 目录下
-- 组件文件放在 `src/components/` 目录下
+- 全局组件文件放在 `src/components/` 目录下
+- 局部组件文件放在页面的 `/components/` 目录下
 
 ## Vue SFC 组件规范
-- `<script setup>` 标签必须是第一个子元素
+- `<script setup lang="ts">` 标签必须是第一个子元素
 - `<template>` 标签必须是第二个子元素
 - `<style scoped>` 标签必须是最后一个子元素(因为推荐使用原子化类名,所以很可能没有)
 

+ 11 - 7
.trae/rules/project_rules.md

@@ -23,10 +23,12 @@
 - `src/http/` - HTTP 请求封装
 - `src/store/` - 状态管理
 - `src/tabbar/` - 底部导航栏
+- `src/App.ku.vue` - 全局根组件(类似 App.vue 里面的 template作用)
 
 ## 开发命令
 - `pnpm dev` - 开发 H5 版本
 - `pnpm dev:mp` - 开发微信小程序
+- `pnpm dev:mp-alipay` - 开发支付宝小程序(含钉钉)
 - `pnpm dev:app` - 开发 APP 版本
 - `pnpm build` - 构建生产版本
 
@@ -34,7 +36,8 @@
 - 使用 Composition API 和 `<script setup>` 语法
 - 组件文件使用 PascalCase 命名
 - 页面文件放在 `src/pages/` 目录下
-- 组件文件放在 `src/components/` 目录下
+- 全局组件文件放在 `src/components/` 目录下
+- 局部组件文件放在页面的 `/components/` 目录下
 
 ## TypeScript 规范
 - 严格使用 TypeScript,避免使用 `any` 类型
@@ -50,24 +53,25 @@
 
 ## UnoCSS 原子化 CSS
 - 项目使用 UnoCSS 作为原子化 CSS 框架
-- 配置在 [uno.config.ts](mdc:uno.config.ts)
+- 配置在 [uno.config.ts]
 - 支持预设和自定义规则
 - 优先使用原子化类名,减少自定义 CSS
 
 ## Vue SFC 组件规范
-- `<script setup>` 标签必须是第一个子元素
+- `<script setup lang="ts">` 标签必须是第一个子元素
 - `<template>` 标签必须是第二个子元素
 - `<style scoped>` 标签必须是最后一个子元素(因为推荐使用原子化类名,所以很可能没有)
 
 ## 页面开发
-- 页面文件放在 [src/pages/](mdc:src/pages/) 目录下
+- 页面文件放在 [src/pages/]目录下
 - 使用约定式路由,文件名即路由路径
-- 页面配置在仅需要在 `route-block` 中配置标题等内容即可,会自动生成到 `pages.json` 中
+- 页面配置在仅需要在 宏`definePage` 中配置标题等内容即可,会自动生成到 `pages.json` 中
 
 ## 组件开发
-- 组件文件放在 [src/components/](mdc:src/components/) 目录下
+- 全局组件文件放在 `src/components/` 目录下
+- 局部组件文件放在页面的 `/components/` 目录下
 - 使用 uni-app 内置组件和第三方组件库
-- 支持 wot-design-uni\uv-ui\uview-plus 等多种第三方组件库 和 z-paging 组件
+- 支持 wot-ui\uview-pro\uv-ui\sard-ui\uview-plus 等多种第三方组件库 和 z-paging 组件
 - 自定义组件遵循 uni-app 组件规范
 
 ## 平台适配