# math.miniapp

本目录是独立 Git 仓库，使用 pnpm；上级 `../AGENTS.md` 仍然适用。

- 先读 `README.md`、`config/environments.ts` 和 `package.json`。
- 当前仅提供本地前端展示，未经需求授权不引入 API、真实登录、上传或发布流程。
- 使用 Taro 小程序组件，避免引入依赖 DOM、Electron 或 PC Ant Design 的组件。
- `APP_ENV` 是业务环境，`NODE_ENV` 是编译优化模式；不要将 `NODE_ENV=test` 用于测试环境打包。
- 构建脚本必须显式传递 `--mode development/test/production`，由 Taro 原生加载 `.env.*`，不要在父进程预加载变量，避免 `build:all` 环境串用。
- 公开环境值放在已提交的 `.env.development`、`.env.test`、`.env.production`；`src/config/environment.ts` 只统一读取和转换类型。个人覆盖用 `.env.*.local`，不提交。
- 按用户要求，三个环境的小程序产物统一输出到 `dist/`，后一次构建覆盖前一次；根目录微信工程配置指向 `dist/`。H5 单独输出到 `dist-h5/`，避免覆盖小程序产物。
- 新增公开配置同步更新对应的 `.env.*` 环境文件和 README；共用变量可在本地 `.env` 中定义，不提交本地 `.env`、AppSecret、真实账号或生产地址。
- 验证：`pnpm typecheck`、`pnpm lint`、`pnpm test`；构建变化运行 `pnpm build:all` 后再运行 `pnpm test`；页面交互变化运行 `pnpm test:e2e` 并检查截图。
- `pnpm test:e2e` 使用本机 Chrome，H5 验证不能代替微信开发者工具和真机验证。
- 不手工改写 `dist`、依赖目录或锁文件；通过 pnpm 更新依赖。