56 lines
2.1 KiB
Markdown
56 lines
2.1 KiB
Markdown
# 项目说明
|
||
|
||
本项目是基于 Uni-App（Vue 3 + Vite）的多端前端应用，支持 H5 与多类小程序目标（如微信小程序）。项目采用 Pinia 管理状态，按“页面/组件/状态/工具”模块化组织，便于扩展与维护。
|
||
|
||
## 架构概览
|
||
- 技术栈：Vue 3、Pinia、Vite 5、Uni-App 3.x、vue-i18n。
|
||
- 路由与页面：通过 `src/pages.json` 定义多端路由和 TabBar，页面文件位于 `src/pages/**`。
|
||
- 状态管理：`src/stores/` 按领域拆分 Store（如 `useUserStore`）。
|
||
- 样式与资源：全局样式 `src/uni.scss`，通用样式在 `src/styles/`，静态资源在 `src/static/`。
|
||
- 关键入口：`src/main.js`（应用创建）、`src/App.vue`（全局生命周期与壳层）。
|
||
- 构建配置：`vite.config.js`（插件/构建）、`manifest.json`（应用与平台配置）。
|
||
|
||
目录结构示例：
|
||
```
|
||
src/
|
||
pages/ ... # 业务页面（splash, index, mine, chat, recharge 等）
|
||
components/ ... # 复用组件
|
||
stores/ ... # Pinia stores
|
||
utils/ ... # 工具函数
|
||
styles/ ... # 通用样式
|
||
App.vue, main.js, pages.json, uni.scss
|
||
```
|
||
|
||
## 主要功能
|
||
- 启动与协议：`pages/splash/splash`、`pages/agreement/agreement`。
|
||
- 首页与我的：`pages/index/index`、`pages/mine/mine`。
|
||
- 创作与脚本编辑：`pages/create/create`、`pages/script/editor`。
|
||
- 语音与聊天：`pages/voice/clone`、`pages/chat/chat`。
|
||
- 充值与记录：`pages/recharge/recharge`、`pages/recharge/history`。
|
||
|
||
## 本地开发与构建
|
||
- 安装依赖：
|
||
```
|
||
npm install
|
||
```
|
||
- 开发调试（H5）：
|
||
```
|
||
npm run dev:h5
|
||
```
|
||
- 开发调试（微信小程序）：
|
||
```
|
||
npm run dev:mp-weixin
|
||
```
|
||
- 生产构建（H5/微信小程序）：
|
||
```
|
||
npm run build:h5
|
||
npm run build:mp-weixin
|
||
```
|
||
构建产物输出到 `dist/`。
|
||
|
||
## 配置与环境
|
||
- 平台与路由：`src/pages.json`；应用配置：`src/manifest.json`。
|
||
- 环境变量：使用 `import.meta.env`（Vite），避免提交敏感信息。
|
||
|
||
如需更详细的接口与需求，可参考仓库中的 `API接口文档.md` 与 `产品设计需求文档.md`。
|