CLAUDE.md

1# CLAUDE.md
2 
3## 技术栈
4 
5uni-app（Vue 3 + Composition API）/ Vite 5+ / Pinia / uview-plus 3.4+ / UnoCSS / Scss / TypeScript / ESLint / pnpm
6 
7## 目录结构
8 
9```
10├ build/                # Vite 配置与插件
11├ env/                  # 环境变量（.env / .env.test / .env.production）
12├ scripts/              # 构建脚本（post-upgrade / verify-commit）
13├ src/
14│  ├ api/               # 接口（模块/index.ts + types.ts）
15│  ├ components/        # 公共组件
16│  ├ hooks/             # Composables
17│  ├ locale/            # i18n
18│  ├ pages/             # 页面
19│  ├ plugins/           # 插件
20│  ├ router/            # 路由（运行时解析 pages.json）
21│  ├ static/            # 静态资源
22│  ├ store/modules/     # Pinia Store（按模块划分）
23│  └ utils/             # 工具函数
24├ types/                # 全局 TS 类型
25└ uno.config.ts         # UnoCSS 配置
26```
27 
28## 常用命令
29 
30```bash
31pnpm install                 # 安装依赖（必须用 pnpm）
32pnpm dev:h5                  # H5 开发
33pnpm dev:mp-weixin           # 微信小程序开发
34pnpm build:h5-prod           # H5 生产构建
35pnpm build:mp-weixin-prod    # 微信小程序生产构建
36pnpm eslint:fix              # ESLint 自动修复
37pnpm stylelint:fix           # StyleLint 自动修复
38pnpm type-check              # TypeScript 类型检查
39pnpm cz                      # 引导式 Git 提交
40```
41 
42## 架构要点
43 
44- **条件编译**: `// #ifdef PLATFORM` / `// #endif` 处理多端差异
45- **路由鉴权**: pages.json 中设置 `"needLogin": true`；TabBar 页面在 `onShow` 中调用 `usePermission()`
46- **网络请求**: `src/utils/request/index.ts`，Token 在 header `token` 字段，`custom.auth = false` 跳过鉴权，401 自动刷新 Token
47- **状态持久化**: pinia-plugin-persistedstate + uni.getStorageSync/setStorageSync
48- **环境变量**: `VITE_API_BASE_URL` / `VITE_APP_PROXY` / `VITE_API_PREFIX` / `VITE_DROP_CONSOLE`
49- **Vite 插件**: 统一注册在 `build/plugins/index.ts`，CDN 替换和体积分析默认关闭