math.miniapp/AGENTS.md

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 更新依赖。