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

119 lines
7.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 接续文件: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`,等用户验证导出面板下载与产物内容。