deploy 目录（与 api 相同：仅替换构建产物；web 容器除 web/public 外不挂源码目录）
- deploy/web/dist：前台构建产物，由
pull-and-restart.sh生成；替换此目录内容即可更新前台。 - deploy/admin/dist：后台构建产物，同上。后台 Vite 通过
@yh-web引用../web/src（如积木BlockRenderer），用 Docker 单目录挂载admin时会构建失败，须挂载项目根再在admin下执行npm run build（见pull-and-restart.sh）。 - deploy/api/server：API 二进制，同上；替换后重启 api 容器生效。
- deploy/web/default.conf、deploy/admin/default.conf：Nginx 配置，已纳入版本库。
日常更新：在服务器执行 ./pull-and-restart.sh 会拉代码、重新构建到上述目录并重启容器。若只改静态资源，也可在服务器上手动构建后只重启对应容器。
后台白屏 / 控制台 “MIME type text/html” 针对 index-*.js
表示浏览器拿到的不是 JS，而是 HTML（常见：/assets/*.js 被 SPA 回退成 index.html，或 404 返回了 HTML 错误页）。
- 确认 Nginx 配置已更新：
deploy/admin/default.conf须含location ^~ /assets/且try_files $uri =404（与仓库内admin/nginx.conf一致），挂载后重启admin容器。 - 确认 dist 完整：
deploy/admin/dist/assets/下须有与index.html中<script type="module">引用同名的哈希文件；发版后应整目录替换dist（勿只拷index.html）。 - 本地重建：在项目根按
pull-and-restart.sh方式在admin/执行npm run build，vite.config中base须为'/admin/'。 - 勿用旧版
nginx/admin.conf：若曾把仅含location /的旧配置拷到服务器，会导致/assets/*.js全部变成index.html（约 640B、MIME 错）。请以deploy/admin/default.conf或admin/nginx.conf为准，并docker compose restart admin nginx。 - 若出现 500：外层
yuheng.docker.conf.tpl仅用location /admin/反代即可（勿对/admin/assets/再写rewrite+ 变量proxy_pass，部分环境会 500）；白屏仍以 内层deploy/admin/default.conf的^~ /assets/为准。 restart.sh构建 admin 已与pull-and-restart.sh一致（挂载项目根到容器，否则@yh-web无法解析）。发版后脚本会执行scripts/verify-admin-dist.sh：若index.html引用的 chunk 在dist/assets/中缺失或过小（几百字节），会直接报错退出，避免白屏上线。