Files
workinf_Blender_Wasm/docs/status/HANDOFF-20261113.md
mes123456 4eb08faf31 chore(web): checkpoint export fixes, operator routing and three-domain evidence
- 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>
2026-11-14 06:12:44 +08:00

7.2 KiB
Raw Blame History

接续文件: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/<uuid>/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。

四、重启后的环境准备

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,等用户验证导出面板下载与产物内容。