文档更新项目文档，添加自动化上传功能说明

2026-01-19 11:52:37 +08:00
parent c85fe69b3b
commit f593b3ff7c
2 changed files with 372 additions and 81 deletions
--- a/IFLOW.md
+++ b/IFLOW.md
@@ -42,6 +42,8 @@
 ├── static/                # 静态资源文件
 │   └── assets/            # 静态图片资源
 ├── store/                 # 状态管理
+├── scripts/               # 自动化脚本
+│   └── upload-weapp.js    # 微信小程序自动化上传脚本
 ├── App.vue               # 应用入口
 ├── main.js               # 主入口文件
 ├── pages.json            # 页面配置
@@ -67,8 +69,9 @@
 ```json
 {
  "dependencies": {
-    "dotenv": "^17.2.2",
    "dayjs": "*",
+    "dotenv": "^17.2.2",
+    "uniapp-error-monitor": "*",
    "vue": "^3.5.21"
  }
 }
@@ -92,6 +95,71 @@ npm install

 同样，构建项目也需要使用 HBuilderX 或相应的 CLI 工具。

+### 自动化上传微信小程序
+
+项目提供了自动化上传微信小程序的功能，可以快速将编译后的小程序上传到微信开发者平台。
+
+#### 使用前准备
+
+1. **配置微信开发者工具CLI路径**
+   
+   需要设置环境变量 `WECHAT_CLI_PATH`，指向微信开发者工具CLI的路径：
+   
+   - **Windows**: `C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat`
+   - **macOS**: `/Applications/wechatwebdevtools.app/Contents/MacOS/cli`
+   
+   或者在 `scripts/upload-weapp.js` 中修改 `CONFIG.cliPath` 的值。
+
+2. **编译项目**
+   
+   使用 HBuilderX 编译项目，生成微信小程序代码：
+   - 打开 HBuilderX
+   - 点击"发行" → "小程序-微信"
+   - 等待编译完成
+
+#### 使用方法
+
+编译完成后，运行以下命令进行上传：
+
+```bash
+npm run upload:weapp
+```
+
+#### 功能特性
+
+自动化上传脚本会自动执行以下操作：
+
+1. **版本号自增**
+   - 自动递增 `manifest.json` 中的 `versionName`（如 1.0.0 → 1.0.1）
+   - 自动递增 `versionCode`
+
+2. **生成上传备注**
+   - 获取当前 git 分支名
+   - 获取最近 5 条 git 提交日志
+   - 将英文相对时间转换为中文格式（如 "3 weeks ago" → "3周前"）
+   - 每条日志前添加序号（1、2、3...）
+
+3. **更新配置文件**
+   - 更新 `manifest.json` 中的版本号
+
+4. **上传到微信**
+   - 调用微信开发者工具CLI上传编译后的小程序
+
+#### 上传描述格式
+
+上传备注的格式示例：
+
+```
+[master] (1) 新增IDE配置文件 (yuantao, 3周前) | (2) 优化工具函数 (yuantao, 6周前) | (3) 修复bug (yuantao, 7周前)
+```
+
+#### 注意事项
+
+- 上传前必须先使用 HBuilderX 编译项目
+- 确保项目是 git 仓库（用于获取日志）
+- 确保微信开发者工具CLI路径配置正确
+- 编译后的文件位于 `unpackage/dist/build/mp-weixin` 目录
+
 ## 代码规范与开发约定

 ## 样式规范
@@ -291,6 +359,7 @@ git commit -m "优化 接口请求性能"
    await tool.navigateBack()
  }
  ```
+* 项目集成了 `uniapp-error-monitor` 错误监控库，用于捕获和上报小程序运行时的错误信息。

 ## 最佳实践

--- a/README.md
+++ b/README.md
@@ -1,80 +1,302 @@
-# <EFBFBD><EFBFBD>Ŀģ<EFBFBD><EFBFBD>ʹ<EFBFBD><EFBFBD>˵<EFBFBD><EFBFBD> 
- 
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><EFBFBD><EFBFBD>ǻ<EFBFBD><EFBFBD><EFBFBD> UniApp + Vue3 + uView-Plus <EFBFBD><EFBFBD>С<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀģ<EFBFBD>壬<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>һЩ<EFBFBD><EFBFBD><EFBFBD>õ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>á<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>͹<EFBFBD><EFBFBD>ߺ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
-  
-## Ŀ¼<EFBFBD>ṹ  
- 
- ```
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> api/                   # <20>ӿ<EFBFBD><D3BF><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> modules/           # ҵ<><D2B5><EFBFBD>ӿ<EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> request.js         # <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>װ
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> common/                # <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> styles/            # ȫ<><C8AB><EFBFBD><EFBFBD>ʽ
-<EFBFBD><EFBFBD>   <20><>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> common.css     # codefunԭ<6E><D4AD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʽ
-<EFBFBD><EFBFBD>   <20><>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> base.scss      # ȫ<><C8AB><EFBFBD><EFBFBD>ʽ<EFBFBD><CABD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> utils/             # <20><><EFBFBD>ߺ<EFBFBD><DFBA><EFBFBD>
-<EFBFBD><EFBFBD>       <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> tool.ts        # <20><><EFBFBD>ù<EFBFBD><C3B9>ߺ<EFBFBD><DFBA><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> components/            # <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> uni_modules/           # uni-app <20><><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> z-paging/          # <20><>ҳ<EFBFBD><D2B3><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> lib/                   # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> luch-request/      # luch-request <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> uview-plus/            # uView-Plus <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> mixins/                # Vue <20><><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> global.ts          # ȫ<EFBFBD>ֻ<EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> store/                 # ״̬<D7B4><CCAC><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> index.ts           # Vuex store
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> pages/                 # <EFBFBD><EFBFBD><EFBFBD><EFBFBD>ҳ<EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> subPages/              # <EFBFBD>ְ<EFBFBD>ҳ<EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> App.vue               # Ӧ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> main.js               # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> pages.json            # ҳ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> manifest.json         # Ӧ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> uni.scss              # ȫ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʽ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> vite.config.js        # Vite <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> .nvmdrc              # Node.js <20>汾Ҫ<E6B1BE><D2AA>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> .env                  # <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-```
- 
-## ʹ<>÷<EFBFBD><C3B7><EFBFBD> 
- 
-1. <20><><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3>Ŀ¼<C4BF><C2BC><EFBFBD>Ƶ<EFBFBD><C6B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ĿĿ¼<C4BF><C2BC> 
-2. <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ҫ<EFBFBD>޸<EFBFBD> package.json <20>е<EFBFBD><D0B5><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD>ƺ<EFBFBD><C6BA><EFBFBD><EFBFBD><EFBFBD> 
-3. ʹ<><CAB9> npm install <20><>װ<EFBFBD><D7B0><EFBFBD><EFBFBD> 
-4. <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ҫ<EFBFBD>޸<EFBFBD> pages.json <20>е<EFBFBD>ҳ<EFBFBD><D2B3><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
-5. <20><>ʼ<EFBFBD><CABC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>¹<EFBFBD><C2B9><EFBFBD> 
- 
-## <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ҫ<EFBFBD><D2AA><EFBFBD><EFBFBD> 
-
-### <20><>Ҫ<EFBFBD><D2AA><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
- **dotenv** - <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ע<EFBFBD><D7A2>
- 
-### <20><>ʽ 
- 
- common.css: ȫ<>ֻ<EFBFBD><D6BB><EFBFBD><EFBFBD><EFBFBD>ʽ 
- base.scss: <20><><EFBFBD>õ<EFBFBD> SCSS <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- 
-### <20><><EFBFBD>ߺ<EFBFBD><DFBA><EFBFBD> (tool.js) 
- 
- alert: <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʾ 
- loading/hideLoading: <20><>ʾ/<2F><><EFBFBD>ؼ<EFBFBD><D8BC><EFBFBD><EFBFBD><EFBFBD>ʾ 
- ҳ<><D2B3><EFBFBD><EFBFBD>ת<EFBFBD><D7AA><EFBFBD>ط<EFBFBD><D8B7><EFBFBD>: navigateTo, redirectTo, reLaunch, switchTab, navigateBack 
- <20><><EFBFBD>ػ<EFBFBD><D8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>: storage, removeStorage, getStorageInfo 
- copy: <20><><EFBFBD><EFBFBD><EFBFBD>ı<EFBFBD><C4B1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- saveImageToPhotos: <20><><EFBFBD><EFBFBD>ͼƬ<CDBC><C6AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- requestPayment: ΢<><CEA2>֧<EFBFBD><D6A7> 
- upload: <20>ļ<EFBFBD><C4BC>ϴ<EFBFBD> 
- 
-### <EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- 
- App.vue: ȫ<><C8AB><EFBFBD><EFBFBD>ʽ<EFBFBD><CABD><EFBFBD><EFBFBD><EFBFBD>ͻ<EFBFBD><CDBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- main.js: Vue Ӧ<>ó<EFBFBD>ʼ<EFBFBD><CABC><EFBFBD><EFBFBD>ȫ<EFBFBD>ֲ<EFBFBD><D6B2><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- pages.json: ҳ<><D2B3>·<EFBFBD>ɺʹ<C9BA><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- uni.scss: ȫ<><C8AB><EFBFBD><EFBFBD>ʽ<EFBFBD><CABD><EFBFBD><EFBFBD> 
- 
-## ע<><D7A2><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- 
-1. <20><><EFBFBD><EFBFBD>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
-2. <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>޸Ļ<EFBFBD><EFBFBD><EFBFBD>չ<EFBFBD><EFBFBD><EFBFBD>ߺ<EFBFBD><EFBFBD><EFBFBD> 
-3. <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɸ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ҫ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>޸Ļ<EFBFBD><EFBFBD>滻 
-4. <EFBFBD><EFBFBD>ʽ<EFBFBD>ļ<EFBFBD><EFBFBD>ɸ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><EFBFBD><EFBFBD>ƹ淶<EFBFBD><EFBFBD><EFBFBD>е<EFBFBD><EFBFBD><EFBFBD> 
+# UniApp + Vue3 + uView-Plus 微信小程序项目模板
+
+这是一个基于 UniApp + Vue3 + uView-Plus 的微信小程序项目模板。它提供了基础的项目结构、常用的工具函数和自动化上传功能，方便快速开发微信小程序。
+
+## 技术栈
+
+- **UniApp**: 跨平台开发框架，用于构建微信小程序
+- **Vue3**: 渐进式 JavaScript 框架，用于构建用户界面
+- **uView-Plus**: 基于 UniApp 的 UI 组件库
+- **z-paging**: 高性能分页组件
+- **Vuex**: 状态管理库
+- **Vite**: 现代化构建工具
+- **luch-request**: 网络请求库
+- **uniapp-error-monitor**: 错误监控库
+
+## 项目结构
+
+```
+.
+├── api/                   # 接口相关
+│   ├── modules/           # 业务接口
+│   └── request.js         # 请求封装
+├── common/                # 公共资源
+│   ├── styles/            # 全局样式
+│   │   ├── common.css     # CodeFun 原子类样式
+│   │   └── base.scss      # SCSS 变量和 Mixins
+│   └── utils/             # 工具函数
+│       └── tool.js        # 常用工具函数
+├── components/            # 公共组件
+├── wxcomponents/          # 微信原生组件
+│   └── painter/           # 海报绘制组件
+├── uni_modules/           # uni-app 组件
+│   └── z-paging/          # 分页组件库
+├── lib/                   # 第三方库
+│   └── luch-request/      # luch-request 网络请求库
+├── uview-plus/            # uView-Plus 组件库
+├── mixins/                # Vue 混入
+│   └── global.js          # 全局混入
+├── pages/                 # 主包页面
+│   └── index/             # 首页
+├── subPages/              # 分包页面
+│   └── welcome/           # 欢迎页
+├── static/                # 静态资源
+│   └── assets/            # 图片资源
+├── store/                 # 状态管理
+├── scripts/               # 自动化脚本
+│   └── upload-weapp.js    # 微信小程序自动化上传脚本
+├── App.vue               # 应用入口
+├── main.js               # 主入口文件
+├── pages.json            # 页面配置
+├── manifest.json         # 应用配置
+├── uni.scss              # 全局样式变量
+├── vite.config.js        # Vite 编译配置
+├── .env                  # 环境变量
+├── .nvmdrc               # Node.js 版本要求
+└── package.json          # 项目依赖配置
+```
+
+## 快速开始
+
+### 环境要求
+
+- Node.js 24.0.1+（版本信息在 `.nvmdrc` 文件中）
+- npm 或 yarn
+- HBuilderX（推荐）或微信开发者工具
+- 微信开发者工具 CLI（用于自动化上传）
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 运行项目
+
+#### 使用 HBuilderX（推荐）
+
+1. 使用 HBuilderX 打开项目
+2. 选择"运行到小程序模拟器"或"运行到手机或模拟器"
+3. 选择微信开发者工具
+
+#### 使用微信开发者工具
+
+1. 使用 HBuilderX 编译项目：点击"发行" → "小程序-微信"
+2. 等待编译完成
+3. 使用微信开发者工具打开编译后的目录：`unpackage/dist/dev/mp-weixin`
+
+### 构建项目
+
+使用 HBuilderX 构建生产版本：点击"发行" → "小程序-微信"
+
+## 自动化上传微信小程序
+
+项目提供了自动化上传微信小程序的功能，可以快速将编译后的小程序上传到微信开发者平台。
+
+### 使用前准备
+
+1. **配置微信开发者工具CLI路径**
+
+   设置环境变量 `WECHAT_CLI_PATH`：
+   
+   - **Windows**: `C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat`
+   - **macOS**: `/Applications/wechatwebdevtools.app/Contents/MacOS/cli`
+   
+   或者在 `scripts/upload-weapp.js` 中修改 `CONFIG.cliPath` 的值。
+
+2. **编译项目**
+
+   使用 HBuilderX 编译项目：
+   - 点击"发行" → "小程序-微信"
+   - 等待编译完成
+
+### 使用方法
+
+编译完成后，运行以下命令进行上传：
+
+```bash
+npm run upload:weapp
+```
+
+### 功能特性
+
+自动化上传脚本会自动执行以下操作：
+
+1. **版本号自增** - 自动递增 `manifest.json` 中的版本号
+2. **生成上传备注** - 获取 git 日志并转换为中文格式，每条日志带序号
+3. **更新配置文件** - 更新 `manifest.json` 中的版本号
+4. **上传到微信** - 调用微信开发者工具 CLI 上传
+
+### 上传描述格式
+
+```
+[master] (1) 新增功能 (yuantao, 3周前) | (2) 优化性能 (yuantao, 6周前) | (3) 修复bug (yuantao, 7周前)
+```
+
+## 开发指南
+
+### 样式规范
+
+- 使用 `uni.scss` 中的全局样式变量
+- 优先使用 CodeFun 原子类样式（`common.css`）
+- 统一使用 SCSS 变量和 Mixins（`base.scss`）
+
+### JavaScript 规范
+
+- 严格遵循 ES6+ 语法规范
+- 优先使用函数式编程范式
+- 使用 `function` 关键字定义方法函数
+- 响应式数据：少于 4 个 `ref` 时直接使用，超过 4 个时使用 `reactive`
+- 生命周期：通过 `@dcloudio/uni-app` 按需导入，页面加载使用 `onLoad` 而非 `onMounted`
+- 变量命名：小驼峰命名法（`userName`）、常量全大写（`MAX_LENGTH`）、状态类变量（`isLogin`）
+- 注释规范：变量和方法必须有注释说明和类型说明
+- 异步处理：所有 Promise 类方法使用 `async/await` 写法
+- 字符串拼接：使用 ES6 模板语法
+
+### 工具函数 (tool.js)
+
+`common/utils/tool.js` 提供完整的工具函数库：
+
+#### 提示与加载
+- `alert()`: 文字轻提示
+- `loading()`: 显示加载状态
+- `hideLoading()`: 隐藏加载状态
+
+#### 页面跳转
+- `navigateTo()`: 跳转到指定页面
+- `redirectTo()`: 关闭当前页面并跳转
+- `reLaunch()`: 关闭所有页面并跳转
+- `switchTab()`: 跳转到 TabBar 页面
+- `navigateBack()`: 返回上一页面
+
+#### 本地存储
+- `storage()`: 设置或获取本地存储
+- `removeStorage()`: 移除本地存储项
+- `getStorageInfo()`: 获取存储信息
+
+#### 其他功能
+- `copy()`: 复制文本到剪贴板
+- `saveImageToPhotos()`: 保存图片到相册
+- `requestPayment()`: 发起微信支付
+- `upload()`: 文件上传
+- `loadFont()`: 动态加载字体
+
+### 网络请求
+
+- 使用 `lib/luch-request` 库进行封装
+- 全局配置在 `api/request.js` 中定义
+- 包含请求和响应拦截器，用于处理通用逻辑
+- 基础 URL 通过环境变量 `VITE_BASE_URL` 配置
+- 各业务接口存放在 `api/modules` 下
+
+### 组件使用
+
+#### uView-Plus 组件
+
+通过 `easycom` 自动导入，无需手动引入：
+
+```vue
+<template>
+  <u-button type="primary">按钮</u-button>
+  <u-icon name="home" />
+</template>
+```
+
+#### z-paging 分页组件
+
+```vue
+<template>
+  <z-paging ref="paging" v-model="dataList" @query="queryList">
+    <view v-for="item in dataList" :key="item.id">
+      {{ item.name }}
+    </view>
+  </z-paging>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+
+const paging = ref(null)
+const dataList = ref([])
+
+const queryList = async (pageNo, pageSize) => {
+  try {
+    const result = await api.getList({ pageNo, pageSize })
+    paging.value.complete(result.data.list)
+  } catch (error) {
+    paging.value.complete(false)
+  }
+}
+</script>
+```
+
+### 微信原生功能
+
+- **分享功能**: 使用 `open-type="share"` 属性
+- **头像获取**: 使用 `open-type="chooseAvatar"` 属性
+- **昵称获取**: 使用 `open-type="nickname"` 属性
+
+### 静态资源
+
+使用全局混入的 `ASSETSURL` 变量：
+
+```javascript
+// 在 template 中
+background-image: url($ASSETSURL + 'image.png')
+
+// 在 JavaScript 中
+const imageUrl = `${ASSETSURL}image.png`
+```
+
+## 代码提交规范
+
+### 提交信息格式
+
+- **新增功能**: `新增 功能描述`
+- **错误修复**: `修复 问题描述`
+- **性能优化**: `优化 优化内容`
+- **文档更新**: `文档 更新内容`
+
+### 示例
+
+```bash
+git commit -m "新增 推广海报生成功能"
+git commit -m "修复 购物车数量计算错误"
+git commit -m "优化 接口请求性能"
+```
+
+## 注意事项
+
+1. 项目使用 HBuilderX 进行编译和开发
+2. 上传前必须先使用 HBuilderX 编译项目
+3. 确保项目是 git 仓库（用于获取日志）
+4. 确保微信开发者工具 CLI 路径配置正确
+5. 编译后的文件位于 `unpackage/dist/build/mp-weixin` 目录
+6. 项目集成了 `uniapp-error-monitor` 错误监控库
+7. 项目集成了 promise 适配器 `uni.promisify.adaptor.js`
+
+## 最佳实践
+
+### 页面开发
+- 使用 Composition API (setup 语法糖)
+- 遵循 Vue3 响应式原理
+- 合理使用 computed 和 watch
+
+### 组件开发
+- 保持组件单一职责
+- 使用 props 进行父子通信
+- 合理使用 emits 进行事件派发
+
+### 状态管理
+- 合理划分 store 模块
+- 避免过度依赖全局状态
+- 及时清理不需要的状态
+
+### 性能优化
+- 使用 z-paging 进行列表优化
+- 合理使用图片懒加载
+- 避免不必要的重复渲染
+
+## 许可证
+
+MIT