- Web engine CMake: apply WITH_WEB_USD_PYTHON to blender_web_engine_core, embed /usd resources, link pxr Python bindings after the core archive and whole-archive the monolithic OpenUSD archive. Fixes the wm.usd_export abort and restores Alembic/USD embedded export. - ?ui=web menus: fix inverted localOnly gating and route queueLocalDesktopOperator and nativeAdd through the desktop operator channel with a VIEW_3D context; non-mesh edit-mode selection uses the native VIEW3D_SELECT bridge. - Refresh WebEngine wasm/js artifacts, manual/course pages and the complete course video asset. - Record focused Chromium probes for Add/F3/parameters/modifier/UV/curve/deform, scene operations, OPFS save/reopen and worker restart. Evidence is NOT_CLAIMED. Co-Authored-By: Claude Code <noreply@anthropic.com>
7.2 KiB
接续文件:2026-11-13 停机会话
状态:in_progress(USD 导出已修复、B03 PASS;用户验证未完成)
验收:NOT_CLAIMED
一、本轮已完成(落盘)
- USD/Alembic 导出改走浏览器 WASM 原生通道(根因:部署后端
build_blender_native/bin/blender无 USD/Alembic,describe 返回 422get_rna_type("WM_OT_usd_export") not found):web/app/src/app/NativeExportPanel.tsx:服务端 describe 失败时回退到WebEngineClient.describeLocalDesktopOperator()(WASM 内嵌 CPython)。web/app/src/app/App.tsxrunNativeWorkflow:EXPORT的USD/ALEMBIC改在权威浏览器 Main 上执行invokeEmbeddedOperator(native:true), 经prepareEditorExport→downloadEditorExport交付产物。- 修正 5.2 USD operator 的无效默认属性:
export_textures→export_textures_mode。
- 完整课程配音视频已产出:
web/app/public/tutorial/complete/video/complete-course-720p.mp4H.264/AAC 1280×720,1805.36 s,58,878,314 B, sha2566a863f2f819c96bc0dc228cfd61eb92945dfdf35cf30c074a99c9603b068afbc;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修复 Playwrightvideo.saveAs关闭后 reject 导致 timeline/report 丢失(回退用 page@*.webm); 本次timeline.json/record-report.json由 stdout 重建。
- 文档/口径:
tools/web/manual/feature-matrix.json、manual.json(USD/Alembic 浏览器引擎、FBX 服务端)、manuals/index.html已重新生成。 web/dist已增量重建:App chunkweb/dist/assets/App-BX5MCWUy.js(sha2566c47cf5e77cf85871187d2ad51892a77e2b33904b6ae98abfc8952f8c71dbeb4), 已包含导出修复、课程视频与新版手册。- 状态:
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—— 来自 OpenUSDpxr/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之外的错误文本可能被吞成超时, 需一并修正。
三、下一动作(按依赖顺序)
- 确认 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/<uuid>/scene.usdc'}})并用prepareEditorExport建路径;抓取 worker console / Pythonstate,error/emscripten_force_exit触发点。 - 检查 WASM 虚拟文件系统:
/usd/plugInfo.json(web_engine_python.cpp:538注册)与/python/lib/webengine-pxr.zip是否可读、是否在 Worker/手动宿主都挂载; 缺失时在初始化阶段同步(web_engine_python.cpp、web-engine.worker.ts)。 - 若 USD 在 WASM 确实不可用,二选一(不得静默降级):
- 为部署后端构建原生 OpenUSD/Alembic(
build_blender_native目前USD_INCLUDE_DIR/USD_LIBRARY为 NOTFOUND;工作量大);或 - 把 USD/Alembic 从“可用”能力中如实降级并在手册/矩阵标明原因。
- 为部署后端构建原生 OpenUSD/Alembic(
- 修复
capture-complete-backend.mjs的 B03 等待条件(收录OPERATOR_/PYTHON_/NATIVE_错误前缀),避免错误被超时掩盖。 - 全部功能完成后再统一跑门禁(
check-manual.mjs、check-parity-claim.mjs、audit-wbv2-feature-completeness.mjs)并由用户验收。 - 未提交、未推送、未发布线上 release;
manual.json的sourceCommit仍指向ca2702646。
四、重启后的环境准备
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.mjsB01/B02/B03 全部 PASS(B03 产物scene-usd.zip),Alembic 聚焦探针也产出scene.abc。 - 结果标
NOT_CLAIMED,等用户验证导出面板下载与产物内容。