- 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>
119 lines
7.2 KiB
Markdown
119 lines
7.2 KiB
Markdown
# 接续文件: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`。
|
||
|
||
## 四、重启后的环境准备
|
||
|
||
```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`,等用户验证导出面板下载与产物内容。
|