# ai_uniapp_v2

AIonline（奇想宇宙）多端应用 —— **uni-app + Vue 3** 重构版，替代 `ai_uniapp`（Vue 2）。

## 技术栈

- uni-app（HBuilderX 工作流，`manifest.json` 中 `vueVersion: "3"`）
- Vue 3 组合式 API（`<script setup>`）
- Pinia 状态管理（替代旧版 Vuex）
- SCSS（全局变量见 `uni.scss`，取自新版原型配色）

## 目录结构

```
ai_uniapp_v2/
├── api/                 # 接口层
│   ├── config.js        # 接口地址常量（INTERFACE_<动作>_<资源>）
│   └── index.js         # 按业务模块聚合的请求方法
├── components/          # 通用组件（easycom：ai-xxx 自动注册）
├── pages/
│   ├── toolbox/         # 工具箱（首页 tab）
│   ├── works/           # 作品（tab）
│   ├── profile/         # 个人中心（tab）
│   ├── login/           # 登录（微信手机号 / 验证码）
│   ├── tool/detail      # 通用工具详情页（按 type 渲染）
│   └── webview/         # 内嵌 H5
├── static/              # 静态资源
├── store/               # Pinia
│   └── user.js
├── styles/common.scss   # 全局公共样式
├── utils/
│   ├── config.js        # 环境与接口基址
│   ├── request.js       # 统一请求（沿用旧版鉴权：token/mac/client/nonce）
│   ├── auth.js          # 登录态存取
│   ├── util.js          # 通用工具
│   ├── useApp.js        # 交互组合式函数（toast/loading/返回）
│   └── filter.js        # 格式化工具
├── App.vue / main.js / pages.json / manifest.json / uni.scss
```

## 与后端对接

接口路径与旧项目及 `ai_api` / `ai_server` 保持一致，后端零改动。约定：

- 请求体 `application/x-www-form-urlencoded`，自动附加 `token` / `mac` / `client` / `source` / `version` 等公共参数。
- 响应结构 `{ code, data, list, msg }`：`code===0` 成功；`code===1009` 登录失效（自动清态并跳登录页）。

## 运行

推荐用 **HBuilderX** 打开本目录，选择运行到浏览器 / 小程序 / App。

H5 本地开发通过 `manifest.json` 的 `h5.devServer.proxy` 将 `/api` 代理到测试域名，规避跨域。

> appid 已沿用旧项目：uni 应用 `__UNI__CD107E4`、微信小程序 `wx6d948e86da551d48`、App 端微信 oauth `wx34fc0db30ace39bc`。
> 注意：`utils/config.js` 中的正式域名仍为占位，接入前请替换为真实值，切勿硬编码任何密钥。

## 迁移说明（相对 ai_uniapp）

| 项 | 旧（ai_uniapp） | 新（ai_uniapp_v2） |
| --- | --- | --- |
| Vue | Vue 2 | Vue 3 `<script setup>` |
| 状态管理 | Vuex | Pinia |
| 全局能力 | `Vue.mixin(base)` / `Vue.prototype.$xxx` | 组合式函数 `useApp()` |
| 过滤器 | `Vue.filter` | `utils/filter.js`（Vue3 已移除 filter） |
| 请求 | `utils/request.js`（回调拦截器） | `utils/request.js`（Promise + Pinia） |