# Web Blender 完整初学者课程 / 全功能走查 / 视频 任务:`COMPLETE-TUTORIAL-001`。资产: - `/home/mes123456/workinf_Blender_Wasm/re/5000PBR精简版/5000+ PBR catalog.blend`(sha256 `54942f05…c125`) - `/home/mes123456/workinf_Blender_Wasm/re/猴头.glb`(sha256 `60267d…e003`) - 派生库:`/home/mes123456/workinf_Blender_Wasm/web/app/public/assets/re-pbr/`(`library:re-pbr-v1`) - 高清库:`/home/mes123456/workinf_Blender_Wasm/web/app/public/assets/re-pbr-hq/`(`library:re-pbr-hq-v1`) ## 1. 启动本地 lane(WASM) ```bash cd /home/mes123456/workinf_Blender_Wasm/web npm run dev -- --host 127.0.0.1 --port 5184 --strictPort ``` 入口:`http://127.0.0.1:5184/?ui=web` ## 2. 启动后端 lane(server/native) ```bash cd /home/mes123456/workinf_Blender_Wasm/web npm run build cd /home/mes123456/workinf_Blender_Wasm BLENDER_BIN=/home/mes123456/workinf_Blender_Wasm/build_blender_native/bin/blender \ BLENDER_WEB_HTTP_PORT=5176 \ node /home/mes123456/workinf_Blender_Wasm/tools/web/deployment-http-server.mjs dist ``` 部署服务器代理 `/api/server-operator-job`、`/api/blender-workflow`、`/api/blender-session`、`/api/blender-resources`。 需要 `/usr/bin/bwrap`、`/usr/bin/prlimit`、`/usr/bin/xvfb-run` 与本机 Blender 二进制。 ## 3. 全功能走查(31 项能力) ```bash cd /home/mes123456/workinf_Blender_Wasm DISPLAY=:1 CHROME_PATH=/usr/bin/google-chrome GPU_MODE=hardware \ node /home/mes123456/workinf_Blender_Wasm/tools/web/complete/capture-complete-course.mjs \ --port 5184 --gpu hardware ``` 单模块:`--module M11`;报告: `/home/mes123456/workinf_Blender_Wasm/tests/golden/COMPLETE-TUTORIAL-001/capture-report.json` 截图: `/home/mes123456/workinf_Blender_Wasm/tests/golden/COMPLETE-TUTORIAL-001/walkthrough/Mxx/*.jpg` 课程图: `/home/mes123456/workinf_Blender_Wasm/web/app/public/tutorial/complete/steps/` ## 4. 生成 HTML 教案 ```bash cd /home/mes123456/workinf_Blender_Wasm node /home/mes123456/workinf_Blender_Wasm/tools/web/course/generate-complete-course.mjs node /home/mes123456/workinf_Blender_Wasm/tools/web/course/check-complete-course.mjs ``` 输出:`/home/mes123456/workinf_Blender_Wasm/web/app/public/tutorial/complete/index.html` ## 5. 完整带配音视频 ```bash cd /home/mes123456/workinf_Blender_Wasm python3 -I /home/mes123456/workinf_Blender_Wasm/tools/web/generate-re-pbr-narration.py --mode prepare \ --chapters /home/mes123456/workinf_Blender_Wasm/tools/web/course/complete-video-chapters.json \ --out /home/mes123456/workinf_Blender_Wasm/tests/golden/COMPLETE-TUTORIAL-001/video DISPLAY=:1 CHROME_PATH=/usr/bin/google-chrome GPU_MODE=hardware \ node /home/mes123456/workinf_Blender_Wasm/tools/web/course/record-complete-video.mjs \ --port 5184 --gpu hardware python3 -I /home/mes123456/workinf_Blender_Wasm/tools/web/generate-re-pbr-narration.py --mode mix \ --out /home/mes123456/workinf_Blender_Wasm/tests/golden/COMPLETE-TUTORIAL-001/video \ --video /home/mes123456/workinf_Blender_Wasm/web/app/public/tutorial/complete/video/complete-course-720p.mp4 ``` `mix` 会把 VTT 写到 `video/re-pbr-lesson.zh-Hans.vtt`,需要重命名为 `/home/mes123456/workinf_Blender_Wasm/web/app/public/tutorial/complete/video/complete-course.zh-Hans.vtt`。 ## 6. 注意 - 所有保存/重开/恢复使用 OPFS;本地 `.blend` 只由用户手动“下载 .blend”生成。 - Chromium only;`crossOriginIsolated` 必须为 true。 - 首次加载可能 30–193 秒;每步用 `engine-status`/`scene-stats` 等待,不用固定 sleep。 - 后端并发上限 2、源码 512 MiB、渲染 240 帧;缺失依赖返回 503。