# 接续文件:2026-11-13 停机会话 状态:`in_progress`(USD 导出已修复、B03 PASS;用户验证未完成) 验收:`NOT_CLAIMED` ## 一、本轮已完成(落盘) 1. **USD/Alembic 导出改走浏览器 WASM 原生通道**(根因:部署后端 `build_blender_native/bin/blender` 无 USD/Alembic,describe 返回 422 `get_rna_type("WM_OT_usd_export") not found`): - `web/app/src/app/NativeExportPanel.tsx`:服务端 describe 失败时回退到 `WebEngineClient.describeLocalDesktopOperator()`(WASM 内嵌 CPython)。 - `web/app/src/app/App.tsx` `runNativeWorkflow`:`EXPORT` 的 `USD`/`ALEMBIC` 改在权威浏览器 Main 上执行 `invokeEmbeddedOperator(native:true)`, 经 `prepareEditorExport` → `downloadEditorExport` 交付产物。 - 修正 5.2 USD operator 的无效默认属性:`export_textures` → `export_textures_mode`。 2. **完整课程配音视频已产出**: - `web/app/public/tutorial/complete/video/complete-course-720p.mp4` H.264/AAC 1280×720,1805.36 s,58,878,314 B, sha256 `6a863f2f819c96bc0dc228cfd61eb92945dfdf35cf30c074a99c9603b068afbc`; - `complete-course.zh-Hans.vtt`(26 条)、`poster.jpg`; - `tools/web/course/check-complete-course.mjs` → PASS(24 模块 / 1 视频)。 - `tools/web/course/record-complete-video.mjs` 修复 Playwright `video.saveAs` 关闭后 reject 导致 timeline/report 丢失(回退用 page@*.webm); 本次 `timeline.json`/`record-report.json` 由 stdout 重建。 3. **文档/口径**:`tools/web/manual/feature-matrix.json`、`manual.json` (USD/Alembic 浏览器引擎、FBX 服务端)、`manuals/index.html` 已重新生成。 4. **`web/dist` 已增量重建**:App chunk `web/dist/assets/App-BX5MCWUy.js` (sha256 `6c47cf5e77cf85871187d2ad51892a77e2b33904b6ae98abfc8952f8c71dbeb4`), 已包含导出修复、课程视频与新版手册。 5. 状态:`docs/status/WBV2-P1425-001-web-operator-dispatch.md`(导出缺口章节)、 `docs/status/WEB_BLENDER_FULL_COURSE_20261113.md`(第 16 节)、 `tests/golden/WBV2-P1425-001/continuation-20261113-web-export.json`。 ## 二、被中断的验证与结论(重要) 重跑 `tools/web/complete/capture-complete-backend.mjs --base-url http://127.0.0.1:5176` (本轮首次验证,用户叫停后该进程被手动终止): - B01 部署 describe:**PASS**(12 ms)。 - B02 EEVEE 原生渲染:**PASS**(24,940 ms,`backend/B02-eevee-render.jpg`)。 - B03 USD 导出:**仍未 PASS**。这次“导出”按钮已可用(describe 回退生效), 点击后 `waitForFunction` 等待约 577 s 既没有产物链接,也没有 FAILED/ERROR 文本, 进程被手动停止(报告里的 “page closed” 是人为终止,不是产品报错)。 `backend-report.json` 的 consoleErrors 关键两行: - `Cannot create a log file` —— 来自 OpenUSD `pxr/base/arch/stackTrace.cpp` (USD 致命错误处理日志); - `emscripten_force_exit cannot actually shut down the runtime ...` —— WASM 内 调用了 `exit()`。 判定(待确认):WASM 内执行 `wm.usd_export` 可能触发 abort/exit,前端 `runNativeWorkflow` 的 Promise 永不 resolve,面板停在 RUNNING。 - 注意:B03 脚本的等待条件只匹配 `FAILED|ERROR|NATIVE_BACKEND|503|UNAVAILABLE|TIMEOUT`, 像 `OPERATOR_NOT_FINISHED`、`PYTHON_OPERATOR_FAILED` 之外的错误文本可能被吞成超时, 需一并修正。 ## 三、下一动作(按依赖顺序) 1. **确认 WASM USD 导出是否可行**:聚焦 Chromium 探针(产品入口 `?ui=web`, 打开 `tests/files/web/pbr-render-lesson/studio.blend` 或课程 studio 资产), 直接调用 `client.invokeEmbeddedOperator({operator:'wm.usd_export', ..., native:true, properties:{filepath:'/browser/cache//scene.usdc'}})` 并用 `prepareEditorExport` 建路径;抓取 worker console / Python `state,error` / `emscripten_force_exit` 触发点。 2. **检查 WASM 虚拟文件系统**:`/usd/plugInfo.json`(`web_engine_python.cpp:538` 注册)与 `/python/lib/webengine-pxr.zip` 是否可读、是否在 Worker/手动宿主都挂载; 缺失时在初始化阶段同步(`web_engine_python.cpp`、`web-engine.worker.ts`)。 3. 若 USD 在 WASM 确实不可用,二选一(不得静默降级): - 为部署后端构建原生 OpenUSD/Alembic(`build_blender_native` 目前 `USD_INCLUDE_DIR`/`USD_LIBRARY` 为 NOTFOUND;工作量大);或 - 把 USD/Alembic 从“可用”能力中如实降级并在手册/矩阵标明原因。 4. 修复 `capture-complete-backend.mjs` 的 B03 等待条件(收录 `OPERATOR_`/`PYTHON_`/`NATIVE_` 错误前缀),避免错误被超时掩盖。 5. 全部功能完成后再统一跑门禁(`check-manual.mjs`、`check-parity-claim.mjs`、 `audit-wbv2-feature-completeness.mjs`)并由用户验收。 6. 未提交、未推送、未发布线上 release;`manual.json` 的 `sourceCommit` 仍指向 `ca2702646`。 ## 四、重启后的环境准备 ```bash cd /home/mes123456/workinf_Blender_Wasm/web npm run dev -- --host 127.0.0.1 --port 5184 --strictPort # 本地 lane 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 web/dist # 后端 lane ``` WASM 构件:`6e1ba738ad626f2e9b6a40c6db6ffcc8832a21eeeed37c30afa72f1bbd53ad91` (`web/app/public/vendor/blender/web_engine.wasm`)。 ## 五、接续提示词(可直接粘贴) > 接续 `/home/mes123456/workinf_Blender_Wasm/docs/status/HANDOFF-20261113.md` 的工作。 > 先读该文件与 `docs/status/WBV2-P1425-001-web-operator-dispatch.md`,不要重跑全量课程。 > 当前重点:`wm.usd_export` 在浏览器 WASM 引擎执行时会触发 OpenUSD 致命错误与 > `emscripten_force_exit`,导致导出面板停在 RUNNING、B03 无法通过;Alembic 尚未单独验证。 > 请先用聚焦 Chromium 探针确认 abort 点与 WASM FS 中 `/usd/plugInfo.json`、 > `/python/lib/webengine-pxr.zip` 的可用性,再决定“修复 WASM USD 导出”还是 > “改为后端原生 OpenUSD/如实降级”。一次只改到能解释现象的那一处,修复后 > 增量构建 `web_engine` 并同步,最后重跑 B03。实现期不跑无关验证,结果标 > `NOT_CLAIMED`;不要提交/推送/发布,等我确认。 ## 六、续接结果(2026-11-13 夜) 第二节的 abort 已复现并修复,详见 `docs/status/WBV2-P1425-001-web-operator-dispatch.md` 的 “WASM USD 导出 abort 根因与修复”一节。结论: - 根因是构建接线:`WITH_WEB_USD_PYTHON` 只作用于最终链接目标, `web_engine_python.cpp` 所在的 `blender_web_engine_core` 未定义它; `/usd` 资源未 embed;静态 `libusd_m.a` 未 whole-archive,注册对象被丢弃。 - 修复只改 `blender-5.2.0/source/blender/web_engine/CMakeLists.txt`。 - 新 WASM `6ee2b261...` 已同步并重建 `web/dist`; `capture-complete-backend.mjs` B01/B02/B03 全部 PASS(B03 产物 `scene-usd.zip`),Alembic 聚焦探针也产出 `scene.abc`。 - 结果标 `NOT_CLAIMED`,等用户验证导出面板下载与产物内容。