webUI/README.md

项目说明

本项目是基于 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。