wz-app（玩值移动端 · Vite + React）
不叫「微信小程序」：本仓库中「小程序／微信原生」指 Soul 目录
miniprogram/。本目录是 玩值用户侧移动端（H5 等） 的唯一新功能交付，智能体角色为 玩值移动端工程师。
不要用 HBuilderX 的「uni-app / 运行到浏览器」编译本目录
- 本工程是 Vite + React（
npm run dev），不是 DCloud uni-app 工程。 - 没有、也不需要 根目录
pages.json/manifest.json（uni 专用）。若在 HBuilderX 控制台看到项目下缺少pages.json文件/ 编译失败，请关闭该 uni 工作区，改为在本目录用 Cursor / VS Code 跑npm run dev。 - 若控制台报
Failed to load url /main.js：部分 uni Web 会固定请求根路径main.js；本工程入口为/src/main.tsx，已用public/main.js转发。仍异常时不要用 HBuilderX 内置 Web 运行，用npm run dev打开终端里的本地地址。 - 更完整的 IDE 说明见同目录
HBuilderX-非uni项目说明.md。
本地开发（必读，避免登录 /api 502）
-
先启动后端
new/wz-api（需DB_DSN等；PORT见new/wz-api/.env.development，与生产一致默认4040）。可访问http://127.0.0.1:4040/health确认存活。 -
本目录执行
npm install→npm run dev（Vite 默认 5173）。 -
.env.development中VITE_API_BASE_URL/VITE_WZ_API_BASE请留空（或不写），让浏览器走同源/api→ Vite 代理；若填成线上https://wzapi...，登录/注册会打到远端而非本机 wz-api。 -
前端请求
/api/...由 Vite 代理到WZ_API_PROXY_TARGET（必须与 wz-api 的PORT一致；与仓库默认对齐为 4040）。 -
手机/局域网访问 dev：使用
npm run dev（已配置--host时见package.json），用电脑 IP +:5173（或终端里给出的端口如5174）打开；此时/api仍由运行 Vite 的电脑本机代理到127.0.0.1:PORT（若手机需直连 wz-api，可设VITE_API_BASE_URL=http://电脑IP:PORT并保证 wz-api 监听0.0.0.0、防火墙放行 同一 PORT）。 -
GET /api/app/mall/point-cards在浏览器里 404：先绕过 Vite访问后端根地址（端口与 wz-api 的PORT一致，默认4040）：http://127.0.0.1:4040/api/app/mall/point-cards。- 若该直连仍是 404，而
GET /api/app/streamers为 200，说明当前正在跑的 wz-api 可执行文件过旧、未编进点卡路由，与仓库new/wz-api不一致；请在new/wz-api执行go build -o 你的路径/wz-api.exe ./cmd/server或go run ./cmd/server，停掉旧进程后用新构建重启。 - 若直连为 502/连不上 而前端 404，多为未启动 wz-api 或
WZ_API_PROXY_TARGET与 wz-apiPORT不一致（见上第 1、4 步）。
- 若该直连仍是 404，而
与请求封装、错误提示：src/lib/request.ts、src/lib/config.ts。
曾用说明（历史 uni-app 等）
仓库曾另有 uni-app 实现；当前本目录为 React 主线时以上开发步骤为准。考古与其它边界见：
与主线代码的关系
| 项 | 说明 |
|---|---|
new/wz-api |
玩值 Go 后端，C 端 /api/app/* |
new/wz-app/（本目录） |
玩值移动端唯一新功能交付（Vite + React） |
old/app/ |
Next 历史 C 端，仅对照 是否漏页/漏接口，不在此扩新功能 |
技术栈
React 19、Vite、TypeScript、Tailwind、react-router、Radix 等，见 package.json。