lyf/frontend-miniapp
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

feat: refine guide explain UX and QA docs

Browse Source
This commit is contained in:
lyf
2026-06-12 17:20:39 +08:00
parent 2055b13b90
commit a7c1879f60
27 changed files with 2831 additions and 1362 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs/H5_DEPLOYMENT_GUIDE.md
View File

@@ -1,6 +1,6 @@
# H5 部署说明
最后更新：2026-06-10
最后更新：2026-06-12
## 目标环境
@@ -29,7 +29,7 @@ pnpm build:h5
构建后重点检查：
```powershell
Get-ChildItem -LiteralPath 'dist\build\h5\static\nav-assets\app_nav_assets_v2_clean_20260609_075339' -Recurse -File |
Get-ChildItem -LiteralPath 'dist\build\h5\static\nav-assets\app_nav_assets_v2_clean_20260611_093623' -Recurse -File |
Measure-Object Length -Sum |
Select-Object Count,Sum
```
@@ -111,9 +111,9 @@ ssh -o BatchMode=yes '自然博物馆-测试服务器' 'docker exec nginx-server
公网资源响应：
```powershell
curl.exe -I --max-time 30 https://guide.whaoyue.com/static/nav-assets/app_nav_assets_v2_clean_20260609_075339/app_nav_manifest.json
curl.exe -I --max-time 30 https://guide.whaoyue.com/static/nav-assets/app_nav_assets_v2_clean_20260609_075339/models_by_floor/L1.glb
curl.exe -I --max-time 30 https://guide.whaoyue.com/static/nav-assets/app_nav_assets_v2_clean_20260609_075339/models_by_floor/MISSING.glb
curl.exe -I --max-time 30 https://guide.whaoyue.com/static/nav-assets/app_nav_assets_v2_clean_20260611_093623/app_nav_manifest.json
curl.exe -I --max-time 30 https://guide.whaoyue.com/static/nav-assets/app_nav_assets_v2_clean_20260611_093623/models_by_floor/L1.glb
curl.exe -I --max-time 30 https://guide.whaoyue.com/static/nav-assets/app_nav_assets_v2_clean_20260611_093623/models_by_floor/MISSING.glb
```
预期结果：
@@ -164,7 +164,7 @@ SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON
处理：
1. 确认 `pnpm build:h5` 已执行资源复制脚本。
2. 确认服务器存在 `/dmdata/nginx/html/guide/static/nav-assets/app_nav_assets_v2_clean_20260609_075339`。
2. 确认服务器存在 `/dmdata/nginx/html/guide/static/nav-assets/app_nav_assets_v2_clean_20260611_093623`。
3. 确认 Nginx `/static/nav-assets/` 配置生效。
4. 强刷浏览器，避免继续使用旧 JS。
@@ -202,3 +202,4 @@ docker exec nginx-server nginx -s reload
- 2026-06-10：补齐 H5 模型资源打包，新增 `/static/nav-assets/` Nginx 规则，修复模型资源请求返回 HTML 的问题。
- 2026-06-10：室内 3D 默认加载当前楼层模型，减少首屏模型解析压力。线上备份：`/dmdata/nginx/html/_backups/guide-before-floor-first-20260610033959.tar.gz`。
- 2026-06-10：上传域名根目录校验文件 `gpL0svkeao.txt`，公网验证地址为 `https://guide.whaoyue.com/gpL0svkeao.txt`。
- 2026-06-12：按 H5 模式重新打包并部署功能更新，线上资源包为 `app_nav_assets_v2_clean_20260611_093623`。验证通过：`pnpm type-check`、`pnpm build:h5`、Nginx `nginx -t`、manifest 200 JSON、L1.glb 200 `model/gltf-binary`、缺失 GLB 404。线上备份：`/dmdata/nginx/html/_backups/guide-before-deploy-20260612032520.tar.gz`。