jackyu66gitandCursor
57687de360
nh=1 隐藏 H5 顶栏并由 cover 承载 logo；H5 仅 4px 顶距避免重复留白。新增 dev:mp、deploy:h5 与联调文档。 Co-authored-by: Cursor <cursoragent@cursor.com>
1.6 KiB
1.6 KiB
愈心魔方 H5 · 本地联调（免每次改服务器）
改 H5 时不必先部署线上；用本机 Vite + 微信开发者工具即可预览。
日常流程
# 终端 1：H5（会打印局域网 IP）
cd digital-psychology
npm run dev:mp
# 终端 2（需要登录/接口时）
npm run dev:api
# 或仅数据库: npm run deps:up && npm run dev:api
微信开发者工具
├── 打开 yuxingu-Miniprogram-dev
├── 详情 → 本地设置 → 勾选「不校验合法域名、web-view…」
├── 编译运行（开发模式，非发行）
└── 打开 Tab「愈心魔方」→ 自动加载本机 http://<你的IP>:5173/psy/
小程序侧规则（已配置）：
- 开发编译（
import.meta.env.DEV）→util/yxgConfig.local.js里的局域网地址 - 发行 / 上传体验版 → 自动使用
https://h5.yuxingu.com.cn/psy/
只需改一次 yuxingu-Miniprogram-dev/util/yxgConfig.local.js：
export const LOCAL_H5_HOST = '192.168.x.x:5173' // 与 dev:mp 打印一致
浏览器自测 embed
http://localhost:5173/psy/?mp=1&sbh=88
确认要上线时（一条命令）
cp deploy.env.example deploy.env # 首次填写服务器
chmod +x scripts/deploy-h5.sh
./scripts/deploy-h5.sh
局限
| 项 | 说明 |
|---|---|
| 真机预览 | 手机与电脑同一 WiFi；开发者工具可勾选「真机调试」 |
| 业务域名 | 本地为 http，仅开发模式 + 关闭域名校验时可用 |
| 与线上一致 | 发行前仍建议在体验版走 HTTPS 域名验收一次 |