From a23b829323c9f680ae085b02cca2e6367d9e6379 Mon Sep 17 00:00:00 2001
From: wangys <3401275564@qq.com>
Date: Tue, 17 Mar 2026 14:49:40 +0800
Subject: [PATCH] first commit

---
 README.md | 149 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 149 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b480e00
--- /dev/null
+++ b/README.md
@@ -0,0 +1,149 @@
+# AI学习助手 - UNIAPP 多端应用
+
+## 项目概述
+企业级多端应用项目，基于 UNIAPP 框架开发，支持微信小程序、H5、App 三端运行。
+
+## 技术栈
+- **核心框架**：UNIAPP (Vue 3 + Vite)
+- **状态管理**：Pinia
+- **样式方案**：Scss + UniApp 内置样式变量
+- **网络请求**：统一封装的 request 工具
+- **代码规范**：ESLint + Prettier + Husky
+
+## 快速开始
+```bash
+# 安装依赖
+npm install
+
+# 运行微信小程序
+npm run dev:mp-weixin
+
+# 运行 H5
+npm run dev:h5
+
+# 运行 App
+npm run dev:app
+```
+
+详细说明请查看 [快速开始.md](./快速开始.md)
+
+## 项目特性
+✅ 模块化架构设计  
+✅ 统一的状态管理  
+✅ 完善的错误处理  
+✅ 多端适配方案  
+✅ 性能优化策略  
+✅ 代码规范约束  
+
+## 核心功能模块
+1. **AI助手** - 智能对话和心理辅导功能
+2. **咨询** - 在线咨询服务
+3. **测评** - 心理测评功能
+4. **课程** - 学习课程管理
+5. **我的** - 个人中心
+
+## 文档
+- [开发规范](./docs/开发规范.md)
+- [多端适配方案](./docs/多端适配方案.md)
+- [性能优化清单](./docs/性能优化清单.md)
+- [TabBar样式说明](./TabBar样式说明.md)
+- [图标准备说明](./图标准备说明.md)
+
+## 项目结构
+```
+├── src/
+│   ├── api/              # API 接口模块
+│   ├── components/       # 通用组件
+│   │   └── common/       # 公共组件（Loading、Empty、Error）
+│   ├── config/          # 配置文件
+│   │   ├── constants.js # 常量配置
+│   │   └── env.js       # 环境配置
+│   ├── mixins/          # Vue 混入
+│   │   ├── pageMixin.js # 页面混入
+│   │   └── listMixin.js # 列表混入
+│   ├── pages/           # 页面文件
+│   │   ├── aibot/       # AI助手页面
+│   │   ├── message/     # 咨询页面
+│   │   ├── target/      # 测评页面
+│   │   ├── library/     # 课程页面
+│   │   ├── cloud/       # 我的页面
+│   │   └── login/       # 登录页面
+│   ├── static/          # 静态资源
+│   │   ├── icons/       # 图标文件
+│   │   ├── images/      # 图片文件
+│   │   └── tabbar/      # TabBar 图标
+│   ├── store/           # Pinia 状态管理
+│   │   └── modules/     # 状态模块
+│   ├── styles/          # 全局样式
+│   │   ├── common.scss  # 公共样式
+│   │   ├── variables.scss # 样式变量
+│   │   ├── mixins.scss  # 样式混入
+│   │   └── tabbar.scss  # TabBar 样式
+│   ├── utils/           # 工具函数
+│   │   ├── request.js   # 网络请求
+│   │   ├── storage.js   # 本地存储
+│   │   ├── validator.js # 数据校验
+│   │   ├── platform.js  # 平台判断
+│   │   └── performance.js # 性能优化
+│   ├── App.vue          # 应用入口
+│   ├── main.js          # 主入口文件
+│   ├── pages.json       # 页面配置
+│   └── manifest.json    # 应用配置
+├── docs/                # 文档目录
+├── tests/               # 测试文件
+├── .eslintrc.js        # ESLint 配置
+├── .prettierrc.js      # Prettier 配置
+├── vite.config.js      # Vite 配置
+└── package.json        # 项目配置
+
+```
+
+## 开发注意事项
+
+### TabBar 配置
+- 字体：PingFang SC, Weight 600, Size 11px
+- 颜色：未选中 #A1A1AA，选中 #27272A
+- 图标位置：`src/static/tabbar/`
+
+### AI助手页面
+- 使用自定义导航栏
+- 背景图使用在线 URL
+- 功能卡片支持横向滚动
+- 暂时使用 emoji 作为图标占位符
+
+### 静态资源
+功能卡片图标需要准备以下文件（详见 [图标准备说明.md](./图标准备说明.md)）：
+- diary.png - 心情日记
+- emotion.png - 情绪分析
+- stress.png - 压力测评
+- meditation.png - 冥想放松
+- sleep.png - 睡眠助手
+
+## 环境配置
+项目支持三种环境：
+- **开发环境** (development)
+- **测试环境** (test)
+- **生产环境** (production)
+
+环境配置文件：`src/config/env.js`
+
+## 代码规范
+- 使用 ESLint 进行代码检查
+- 使用 Prettier 进行代码格式化
+- 使用 Husky 进行 Git 提交前检查
+- 遵循 Vue 3 组合式 API 最佳实践
+
+## 浏览器支持
+- Chrome >= 87
+- Firefox >= 78
+- Safari >= 14
+- Edge >= 88
+
+## 小程序支持
+- 微信小程序基础库 >= 2.10.0
+
+## 许可证
+MIT
+
+## 联系方式
+如有问题，请联系开发团队。