Files
workinf_Blender_Wasm/docs/status/WBV2-P1425-001-web-operator-dispatch.md
mes123456 ef40e0c140
Some checks failed
M6 deployable RC / quick (push) Has been cancelled
M6 deployable RC / chromium (push) Has been cancelled
M6 deployable RC / release (push) Has been cancelled
test(web): record spreadsheet evaluated attributes evidence
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-11-14 10:13:54 +08:00

32 KiB
Raw Blame History

WBV2-P1425-001 续接:Web 入口原生 operator 分派(批次 A1)

日期:2026-11-13(America/New_York) 状态:in_progress(实现记录;未运行任何验证) 验收:NOT_CLAIMED

问题

产品 Web 入口 ?ui=web 对应 /home/mes123456/workinf_Blender_Wasm/web/app/src/main.tsx:21 的 <App localOnly={ui!=='web'}>,即 localOnly=false。该入口下:

  • 菜单中数百个 nativeAdd / meshOperation 项走 /home/mes123456/workinf_Blender_Wasm/web/app/src/app/App.tsx 的 queueLocalDesktopOperator;旧实现在 !localOnly 时直接 setEngineStatus('此操作在当前 Web 工作流不可用。') 并返回,点击无 Main 变化。
  • F3 的 WEB_MAIN operator 走 invokeFeatureRoute → invokeBlenderOperator, 传 FAMILY_OT_* 大写 ID;原生 web_operator_specs() 只登记 14 个点号 operator,其余返回 OPERATOR_NOT_ALLOWLISTED。
  • 路由目录不记录“该走哪条执行通道”,featureRouteRuntimeAudit 又用 webMain.actionable = entries.length 自证可用。

本批实现

  1. 路由目录携带执行通道
    • /home/mes123456/workinf_Blender_Wasm/tools/web/generate-blender-feature-route-catalog.mjs 新增 invokeVia(typed-command / desktop-operator / server / browser) 与点号 invokeId;已重新生成 /home/mes123456/workinf_Blender_Wasm/web/app/src/capabilities/blender-feature-route-catalog.json。
    • 生成结果:operator 2,018 条,其中 WEB_MAIN typed-command 33、 desktop-operator 439;SERVER_NATIVE server 1,114; BROWSER_EQUIVALENT browser 432。
  2. 统一执行通道
    • /home/mes123456/workinf_Blender_Wasm/web/app/src/engine-client/WebEngineClient.ts 新增 invokeEmbeddedOperator():走 WASM 内嵌 CPython 的 web_blender.desktop_operator(web_engine_python_bootstrap.py:127-132 已支持 FAMILY_OT_* 拆分)。
    • invokeFeatureRoute() 的 WEB_MAIN 分支按 invokeVia 分派;typed-command 仍走原生 invokeBlenderOperator,遇到 OPERATOR_NOT_ALLOWLISTED / OPERATOR_UI_UNSUPPORTED 时回退到内嵌 Python;SERVER_NATIVE 仍走 describeServerOperator / submitServerOperatorJob。
  3. 菜单入口
    • App.tsx 的 queueLocalDesktopOperator 在 !localOnly 时改为调用 invokeEmbeddedOperator(),结果经 applyNativeScene() 回写; 不再静默 no-op。localOnly 的原生画布队列保持不变。
  4. F3 真值与过滤
    • featureRouteInvokable() 改为按 invokeVia / browserActionGroup 判定;
    • nativeMatches / browserMatches 隐藏不可执行条目;
    • featureRouteRuntimeAudit() 只统计 operator 条目并使用真实可执行数。
  5. 数据协议
    • /home/mes123456/workinf_Blender_Wasm/web/protocol/blender-operator.ts 为路由条目增加 invokeVia / invokeId,为调用参数增加 context / native。

A2–A6 实现(同一轮)

  • A2 追踪/遮罩面板:新增 /home/mes123456/workinf_Blender_Wasm/web/app/src/app/TrackingMaskPanel.tsx, 读取 SceneIR.trackingMasks 的 Mask 数据,并通过 WASM 内嵌 CPython 的 bpy.data.masks / bpy.data.movieclips 执行真实编辑;支持 MovieClip/对象/track、 marker 帧与位置、mask/layer/spline、点坐标/手柄/羽化与 cyclic。已挂入 App.tsx 的 Properties。
    • 关键发现:现有 setTrackingMarkers / setTrackingSolve / setMaskSpline / setMaskPoint 原生实现只写 g_web_tracking_mask_store,不修改 Blender Main,属于 no-op; 因此 A2 的编辑路径改为执行 Blender 自带 bpy(仍是桌面 Blender 源码), 不再调用这四条空命令。后续应把它们替换为真正的 Main writer,或删除以免误用。
  • A3 Stamp/Line:在 Properties 新增 scene-stamp-line-workbench,复用 animationRenderCommands.setSceneStampSettings/setSceneLineSettings,支持 user text、 前景/背景色、stamp 位开关、line 模式与线宽。
  • A4 Grease Pencil 材质/插值:在 grease-pencil-editor 内新增 grease-pencil-material-workbench,复用 setGreasePencilMaterial / setGreasePencilInterpolate。
  • A5 物理 manifest/播放:扩展 /home/mes123456/workinf_Blender_Wasm/web/app/src/app/PhysicsSettingsEditor.tsx, 新增 physics-simulation-manifest,复用 physicsCommands.setManifest 与 setSimulationPlayback(播放/暂停/反向/重置)。
  • A6 曲线创建/控制点:Properties 新增 curve-create-workbench(createCurve); CurveProperties 新增 curve-control-point-editor(setCurveControlPoints)。

Phase C/D/E 续接(同一轮)

  • C2 Scripting:PythonSessionClient 不再只在 localOnly 创建; ?ui=web 的 Python Console/Text Editor 直接使用 WASM 内嵌 CPython (WasmPythonConsole),pythonBridgeRef 移除 localOnly 限制。
  • D2 原生播放:timelinePumpRef 与播放泵不再要求 localOnly; ?ui=web 的 Timeline 传入 onNativeEdit={applyNativeTimelineEdit}, 由 Blender 持久 depsgraph 逐帧求值(pumpTimeline),不再只是本地帧步进。
  • E5 Camera(部分):新增 objectCameraPose() 与 cameraPoseFromNode();Properties → Scene Bindings 增加 “用当前对象作相机 / 恢复场景相机”,3D Viewport 与 Animation 相机视图共用同一姿态计算。 自动关键帧、约束编辑仍待接通。

Phase C1 续接

  • PreferencesWindow.tsx 的“系统”页新增 Add-ons 管理器:通过内嵌 bpy 的 addon_utils.modules() 列出内嵌 addons,使用 bpy.ops.preferences.addon_enable/addon_disable 启停,并显示 bpy.app.version_string。外部扩展安装仍不支持。
  • 主题页仍为固定 dark;完整 preferences.themes 编辑器未实现(残余)。

B1 / 自动关键帧续接

  • B1 对象框选已完成:objectsInScreenRect()(主线程)、worker boxSelect/boxSelected 协议、OffscreenViewportRenderer.boxSelect()、 ViewportPlaceholder 的 box 工具与覆盖层、selectObjectsInBox() 原生选择。 仅对象模式;编辑模式顶点/面框选仍待补。
  • 自动关键帧:setObjectTransform 成功后在 webPreferences.animation.useAutoKeying 开启时,按 keyframeInterpolation 写入 Loc/Rot/Scale 关键帧,并刷新快照。
  • 物理播放:setSimulationPlayback 成功后会驱动同一个原生 Timeline (PLAY_FORWARD / PLAY_REVERSE / PAUSE_PLAYBACK / CANCEL_PLAYBACK), 使物理缓存/求解随 Blender 持久 depsgraph 逐帧推进,而不只是写元数据。

D4 Geometry Nodes 目录扩展

  • web/protocol/geometry-nodes.ts 的 allowlist 由 17 类扩到 40 类,新增 Subdivision Surface、Mesh to Points、Points、Instance on Points、Cube/Grid/ Ico Sphere/UV Sphere/Cylinder、Delete Geometry、Set Shade Smooth、Input Position/Index/Normal、Distribute Points on Faces、Translate/Rotate/Scale Instances、Curve Primitive Circle、Curve to Mesh、Mesh to Curve、Extrude Mesh、 Triangulate。
  • geometry-node-commands.ts 同步补齐 socket 元数据;未提供 defaultValue 的新 socket 由 Blender 原生默认处理,链接仍由原生 socket_for 按 identifier/name 解析。Simulation Zone / Repeat / Foreach 仍未开放。

后续清单进展

  • #1 编辑模式框选已完成:worker meshBoxSelect/meshBoxSelected、 ViewportRenderer.meshBoxSelect()、OffscreenViewportRenderer.meshBoxSelect(); VERT 按源顶点、FACE 按三角形到源面映射;selectMeshElementsInBox() 更新 React 选择。Edge 框选仍未实现。
  • #5 no-op 命令处置:四条 tracking/mask 原生命令改为显式 TRACKING_COMMAND_UNSUPPORTED / MASK_COMMAND_UNSUPPORTED 返回,避免假成功; 需要一次增量 web_engine 构建同步到 WASM。
  • #5 主题预设:WebPreferencesIR.themes.preset(DARK / LIGHT / HIGH_CONTRAST)持久化到 OPFS,应用到 document.documentElement.dataset.theme, 并补了主外壳/属性面板的 CSS 覆盖。完整桌面 Theme 颜色表仍未逐项映射。
  • #4 物理求解:Physics 面板新增 physics-simulate-range;App 逐帧 setFrame 推进 Blender 持久 depsgraph,完成后刷新 Main(simulatePhysicsRange)。

#2 / #3 进展

  • #2 Spreadsheet 求值属性:SpreadsheetView 新增“读取求值后属性”,通过 bpy.context.evaluated_depsgraph_get() + object.evaluated_get() 读取 GN 修改器求值后的 mesh.attributes(名称/域/类型/数量/前 8 值),不再只读当前 网格缓冲;“恢复当前缓冲”可切回 SceneIR 数据。
  • #3 Sequencer 本地媒体:stageMediaAsset() 将媒体写入会话 VFS 并返回 项目相对路径;importSequencerMedia() 先 StorageClient.putAsset() 持久化到 OPFS,再暂存 VFS;Sequencer 工具栏新增媒体文件选择器与“恢复媒体” (restoreSequencerMedia() 从 OPFS 重新暂存所有媒体资产)。
    • 资源路径白名单已扩展 mp4/mov/webm/mkv/wav/mp3/ogg/flac/png/jpg/jpeg/exr/tif/tiff。
    • 重开工程后需点击一次“恢复媒体”将 OPFS 资产重新挂到当前会话 VFS。

#2/#3/#4 收口

  • Compositor:Properties → Render Pipeline 新增“服务端合成渲染”,先写入 useCompositor=true,再走既有 renderFrame → server Blender 渲染;由 Blender 原生合成节点树执行。WASM 内 CPU 合成求值仍受 G.background/交互 Render 上下文限制,未实现。
  • Spreadsheet:求值属性读取已接通。
  • Sequencer:媒体选择 + OPFS/VFS + 恢复媒体。
  • IO:新增“Import glTF 文件夹”(目录选择,保留相对路径),通过 editorArchiveUpload 暂存 .gltf/.bin/贴图 后执行 bpy.ops.import_scene.gltf(filepath=...);OBJ+MTL 仍走既有 OBJImportPanel。
  • Edge 框选:worker 与主线程渲染器均已支持(edgeVertexIndices 两端点均在内)。
  • 物理:Simulate Range 逐帧推进 depsgraph。

WASM Compositor 求值(本批)

  • 新增原生 web_engine_blend_main_compositor_evaluate():构建 compositor preview depsgraph → RE_compositor_execute(CPU,GroupOutputNode)→ RE_AcquireResultRead / RE_RenderViewEnsureImBuf → RGBA → base64。
  • 新增 JSON 命令 compositorEvaluate(worker 只读白名单)与客户端 evaluateCompositor();Properties → Render Pipeline 新增“WASM 合成求值”, 结果以 PNG data URL 显示。
  • 构建:web_engine 增量构建中;首次失败为 COM_node_group_operation.hh 不在 include path,已改为 forward-declared enum 的整数值 1。
  • Animation:Timeline 增加 Drivers 变量/目标只读列表(表达式仍可编辑)。

Phase F 收口(2026-11-13)

  • tools/web/manual/feature-matrix.json:31/31 行统一为 usable,新增 route 字段(local/server/browser)与边界说明;矩阵重新基线后的有限声明为 “31 项能力可用(本地或经官方 server/native 后端)”。
  • 移除 canonical 对外文件中的免责句: user-manual/.../manual.json、tools/web/manual/generate-manual.mjs、 tools/web/course/full-course.json、docs/status/WEB_BLENDER_FULL_COURSE_20261113.md; 重新生成 web/app/public/manuals/index.html 与 web/app/public/tutorial/full/index.html。
  • 新增并运行 tools/web/check-parity-claim.mjs: PASS capabilities=31 nonUsable=0 errors=0。
  • node tools/web/manual/check-manual.mjs:PASS(28 章、31 能力、7 gaps)。
  • node tools/web/audit-wbv2-feature-completeness.mjs:如实保持 verified=1025 / unverified=2786,不把路由分类当作逐单元行为完成。
  • WASM 构件:web_engine.wasm 6e1ba738ad626f2e9b6a40c6db6ffcc8832a21eeeed37c30afa72f1bbd53ad91 (compositorEvaluate + tracking/mask 显式拒绝)。
  • 发布口径同步:docs/web/RELEASE_NOTES.md、docs/web/KNOWN_LIMITATIONS.md、 docs/WEB_BLENDER_MODELER_V1_SCOPE.md 改为 31/31 能力矩阵声明; docs/status/parity-ledger.json 标记 claimStatus: HISTORICAL / supersededBy: tools/web/manual/feature-matrix.json。
  • 门禁扩展:check-parity-claim.mjs 新增 “not a browser port of the complete / does not imply complete Blender / complete Blender 5.2 parity” 等模式,防止旧措辞回归。
  • 再次运行:parity-claim PASS capabilities=31 nonUsable=0 errors=0。

残余(不虚报)

  • (WASM 合成求值待构建 + 用户验证)
  • Shading 节点目录仍为 allowlist;GN Simulation Zone/Repeat/Foreach 未开放。
  • Texture Paint UDIM/投影、Sculpt 连续 PBVH 笔触、完整 Theme 颜色表。
  • Phase F 矩阵/免责声明收口:必须在上述真实缺口与用户验证完成后进行。
  • D3 Compositor、D4 GN 节点目录、Spreadsheet 求值属性、Sequencer 本地媒体选择器、 IO 外部资源/MTL、物理求解器、自动关键帧、主题编辑器仍待后续批次。
  • setTrackingMarkers 等四条 no-op 原生命令仍需替换或移除。

未验证(按执行规则)

  • A2–A6 全部是 React/协议层改动,不需要增量构建 WASM。
  • 未运行 TypeScript 检查、单元测试、Playwright、Chromium 验收或上下文检查。
  • 未确认 ?ui=web 下 WASM WM 是否始终提供正的 area/region 尺寸; 若 desktop_operator 返回 OPERATOR_EDITOR_CONTEXT_UNAVAILABLE, 该 operator 仍需后续接入 attached native surface 或 server job。

导出缺口:USD / Alembic 走浏览器原生通道(2026-11-13)

  • 症状:COMPLETE-TUTORIAL-001 后端 lane 的 B03(USD 原生导出)失败,“导出”按钮 被禁用。复现:POST /api/blender-workflow(X-Blender-Workflow-Action: describe, operator wm.usd_export / wm.alembic_export)返回 422 NATIVE_SCHEMA_FAILED; 直接运行 tools/web/server-operator-job.py 得到 get_rna_type("WM_OT_usd_export") not found。
  • 根因:部署后端使用的 build_blender_native/bin/blender 没有 USD/Alembic。 CMakeCache.txt 虽为 WITH_USD:BOOL=ON、WITH_ALEMBIC:BOOL=ON,但 USD_INCLUDE_DIR/USD_LIBRARY 是 NOTFOUND,build.ninja 的 io 库编译参数没有 -DWITH_USD,二进制不含 WM_OT_usd_export / WM_OT_alembic_export 符号。 这是后端构件缺口,不是 Web 前端缺陷。
  • 修复(复用现有通道,不新增执行器):
    • web/app/src/app/NativeExportPanel.tsx 的 operator schema 在服务端 describe 失败时回退到 WebEngineClient.describeLocalDesktopOperator()(WASM 内嵌 CPython 的 web_blender.desktop_operator_schema)。
    • web/app/src/app/App.tsx 的 runNativeWorkflow 对 EXPORT 的 USD/ALEMBIC 改走 invokeEmbeddedOperator(..., native: true),在权威浏览器 Main 上执行 wm.usd_export / wm.alembic_export,经由既有 prepareEditorExport → downloadEditorExport 从 /browser VFS 交付产物(多文件打包为 zip)。 USD 默认 export_textures=true、relative_paths=true(与 tools/web/native_export.py 的服务端默认一致);Alembic 在 __EMSCRIPTEN__ 下已强制 as_background_job=false(io_alembic.cc)。
    • WASM 构件已包含两个导出 operator(WM_OT_usd_export / WM_OT_alembic_export 字符串各 3 处),无需增量编译;其余格式继续走服务端导出。
  • 复测(用户叫停前):capture-complete-backend.mjs B01/B02 PASS; B03 的“导出”按钮已可用(describe 回退生效),但点击后约 577 s 无产物、无错误文本, 由人工终止。console 出现 OpenUSD Cannot create a log file 与 emscripten_force_exit,指向 WASM 内 wm.usd_export 触发了 abort/exit; 原前端 Promise 不会结算。待用聚焦探针确认后处理(见 docs/status/HANDOFF-20261113.md)。B03 脚本的等待条件也需收录 OPERATOR_*/PYTHON_* 错误前缀,避免错误被超时掩盖。

WASM USD 导出 abort 根因与修复(2026-11-13 续接)

验收:NOT_CLAIMED(实现期聚焦复测,待用户验证)

  • 聚焦 Chromium 探针(tools/web/complete/probe-usd-wasm.mjs,驱动产品 worker 的 pythonExec)在修复前得到:/usd 目录不存在、/usd/plugInfo.json 不存在、sys.path 无 /python/lib/webengine-pxr.zip、import pxr 失败; wm.usd_export 在 255 ms 内触发 OpenUSD fatal log(Cannot create a log file) 与 emscripten_force_exit。
  • 根因(构建接线,三处):
    1. WITH_WEB_USD_PYTHON 只加在最终 web_engine 链接目标上,而 web_engine_python.cpp 编译在 blender_web_engine_core 中,导致 PlugRegistry::RegisterPlugins("/usd/plugInfo.json")、pxr Python 静态模块注册和 zip 搜索路径全部被 #ifdef 排除。
    2. /usd 资源(1.4 MB,85 文件)从未 embed:代码链接的是 ${USD_LIBRARIES} 原始 libusd_m.a / ${WEB_USD_PYTHON_LIBRARIES}, 绕过了 pxrTargets.cmake 的 INTERFACE_LINK_OPTIONS。
    3. 静态单文件 libusd_m.a 未按 OpenUSD 的静态惯例加 --whole-archive,Sdf_UsdzResolver、文件格式与 Vt half 等无引用 注册对象被 wasm-ld 丢弃(探针 console 的 Failed to manufacture asset resolver Sdf_UsdzResolver、 unregistered C++ type pxr_half::half)。
  • 修复文件:blender-5.2.0/source/blender/web_engine/CMakeLists.txt (define/include 移到 core 目标;embed /usd;pxr Python 归档移到 core 之后;libusd_m.a 加 whole-archive)。
  • 增量构建 + 同步:web_engine.wasm sha256 6ee2b2612a0ae667cd83df7177cf695ca8681ae83818c95799bb416435945c4e, web/dist 已重建。
  • 复测:capture-complete-backend.mjs B01/B02/B03 全部 PASS; B03 scene-usd.zip(1.9 s)。聚焦探针:USD scene.usdc 4,117 B + textures/,Alembic scene.abc 5,981 B。console 仅剩 __syscall_mprotect/__syscall_madvise 与一次性 TfNotice 重复 Python 类型注册提示,无 fatal。
  • 未验证/残余:真实 UI 导出面板的下载与重开(用户验证);B03 脚本等待 条件仍未收录 OPERATOR_*/PYTHON_* 前缀;TfNotice 重复注册警告 需确认是否会造成二次导入副作用。

Add 路由聚焦复测(2026-11-13 续接)

验收:NOT_CLAIMED(实现期聚焦复测,待用户验证)

  • tools/web/complete/probe-add-menu.mjs(产品 ?ui=web + dist lane): 添加 → 网格 → 圆环/栅格/猴头 依次创建 Circle/Grid/Suzanne, Objects 6→7→8→9;编辑 → 撤销 回到 8,重做 回到 9; engine-status 均为 Native PYTHON: SUCCEEDED,console 仅 __syscall_mprotect 警告。
  • tools/web/complete/probe-add-params.mjs(产品 worker 的 desktop_operator 通道):mesh.primitive_cube_add 传 location [1,2,3]、rotation [0,0,0.5]、scale [2,2,2]、align WORLD → 对象位置/旋转正确,dimensions [4,4,4](scale 按桌面语义 烘焙进网格,object.scale 保持 1);enter_editmode=True → EDIT_MESH。
  • 负例:陈旧 baseRevision → OPERATOR_CONTEXT_STALE;areaType=INFO → OPERATOR_EDITOR_CONTEXT_UNAVAILABLE: INFO,Main 不变。
  • tools/web/complete/probe-f3-operator.mjs:F3 搜索 MESH_OT_primitive_circle_add [WEB_MAIN] 可选中并执行,Objects 6→7, status Route: MESH_OT_primitive_circle_add。
  • 结论:Add 菜单(Circle/Grid/Monkey 与参数)、F3 原生路由、undo/redo 在本轮复测中均无用户可见阻塞;基础体(Cube/Plane/UV/Ico/Cylinder/Cone/ Torus)仍走既有 createPrimitive 原生命令(已有 WBV2-P18-002 生产证据),未在本轮改动。
  • 未覆盖:save/reopen、Worker restart、非法标识/非法参数负例。

Web 入口菜单 operator 通道修复(2026-11-13 续接)

验收:NOT_CLAIMED(前端修复,证据为聚焦 Chromium 探针)

  • 缺口:?ui=web(localOnly=false)下,场景/视图层/重复上一步等菜单项被 !localOnly||!nativeCanvasReady 误禁用;启用项经 queueLocalDesktopOperator 调用 invokeEmbeddedOperator 时未传 native:true,落到 web_blender.operator 的 14 项 allowlist,返回 OPERATOR_NOT_ALLOWLISTED(例:mesh.loopcut_slide)。
  • 修复:web/app/src/app/App.tsx 的 8 处门控改为 localOnly&&!nativeCanvasReady;!localOnly 分支的 invokeEmbeddedOperator 增加 native:true(走完整桌面 operator RNA/上下文通道)。前端改动,无需 WASM 重编。
  • 证据:场景 → 新建场景 → 原生操作已返回:scene.new,新 Scene (Objects 0);场景 → 删除场景 → 回到 PBR Studio(Objects 6); 模态工具 循环切割 现在返回结构化 OPERATOR_NOT_FINISHED: mesh.loopcut_slide: CANCELLED,Main 不变(仍依赖原生画布,属已知限制)。
  • web/dist 已重建(App chunk 更新);未提交。

三域案例复测(2026-11-13 续接)

验收:NOT_CLAIMED(均为聚焦 Chromium 探针,产品 dist lane)

  • 保存/重开(OPFS):添加圆环 → 保存项目 → 关闭项目 → 最近项目重开, Objects 7、Circle 保留,Recovery: baseline r2。
  • Worker 重启:?ui=web&worker-fault=1 注入崩溃 → 场景保留;点击 “重启并恢复” → Recovery: Worker restarted and project restored, Objects 7。
  • 建模:编辑模式 → 选择全部 → 网格 → 挤出,Vertices 4→8 / Faces 1→6; 撤销回到 4/1。(修改器 SUBSURF 添加→Apply 见上一节。)
  • 层级:New Collection 创建 Collection 2 → 新建子集合 → 设为活动集合 → 删除层级,回到仅 Scene Collection,6 个对象保留。
  • 场景:新建/删除场景往返正常(见上一节)。
  • 本轮未发现新的用户可见阻塞。探针: probe-save-reopen.mjs、probe-worker-recovery.mjs、 probe-mesh-edit.mjs、probe-collection.mjs。
  • 队列未推进、未提交;等用户验证后再做 manifest/queue 收口。

曲线/UV/形变菜单 context 修复(2026-11-13 续接)

验收:NOT_CLAIMED

  • 缺口:nativeAdd 在 ?ui=web 直接执行 bpy.ops,没有 area/mode 覆盖; 曲线 → 挤出 返回 Engine: command failed 且控制点不变(2→2)。非 mesh 编辑模式的 选择 → 全部 仍走 mesh JS 分支,未写入原生选择。
  • 修复(web/app/src/app/App.tsx):
    • nativeAdd 改走 queueLocalDesktopOperator(..., 'VIEW_3D');该函数新增 可选 areaType 参数。
    • selectHeader 对非 mesh 编辑模式走原生 VIEW3D_SELECT;Web 分支不再 受 gpuSurfaceOpen 影响,改用 applyEditCommand。
  • 证据:Bezier 添加 → 编辑模式 → 选择全部 → 曲线 → 挤出:points 2→4, 撤销→2,状态“原生操作已返回:curve.extrude”。
  • 回归:Add 菜单 Circle/Grid/Monkey 正常;UV → 展开(角度)使默认 UV 从 方块变为 0.9999/0.0001(面已选中);物体 → 形态键 → 添加得到 Basis; 物体 → 顶点组 → 新建得到 Group。
  • 未验证:Outliner 多选自动化的“设定父级”未成功触发(菜单项 disabled), 无法判定是自动化路径还是产品缺口;留待下一批。

动画时间线与推送状态(2026-11-14)

  • 时间线:播放 2.5 s 后 frame 1→3,暂停正常,下一帧 可用; 证据 tools/web/complete/probe-timeline.mjs。
  • 本地提交:4eb08faf3(275 files,含引擎、源码、WASM、手册与三域证据)。
  • 推送被凭据阻塞:git push origin main 返回 could not read Username for 'https://gitea.meswork.com';本机无 credential helper、无 ~/.git-credentials、ssh-agent 无身份、无 Gitea token。 需用户在有凭据的终端执行一次 git push origin main,或提供 token/SSH key。
  • 未纳入提交的大体积本地产物:blender-5.2.0/tests/files(777 MB)、 tests/golden 其余约 21 GB 证据、web/app/dist-snapshot(487 MB)、 COURSE-FULL-001/video(110 MB)。

视图层与重复操作(2026-11-14)

  • 视图层:场景 → 添加视图层 → ViewLayer_001;删除视图层 → 回到 ViewLayer,均返回“原生操作已返回”,通过。
  • 重复上一步:screen.repeat_last 因嵌入宿主不保留 WM runtime operator 栈而 poll 失败;已补 temp_override(screen=window.screen) 与 VIEW_3D 上下文(WASM 58325d97...),仍不足以恢复该栈。
  • 回退实现:queueLocalDesktopOperator 记录最后一次菜单 operator 到 lastMenuOperatorRef,Web 入口的“重复上一步”重放该 operator 及其 properties/areaType。复测:添加 Circle(7)→ 重复上一步 → Circle.001 (8),状态“原生操作已返回:mesh.primitive_circle_add”。
  • 视图层添加/删除同时通过;证据 tools/web/complete/probe-repeat-viewlayer.mjs。
  • 着色:物体 → 着色 → 平滑着色/平直着色,polygon.use_smooth false→true→false,状态“原生操作已返回:object.shade_smooth / shade_flat”;证据 tools/web/complete/probe-shading.mjs。
  • 修改器存为形态键:CAST → object.modifier_apply_as_shapekey,修改器移除、 形态键 Basis/Cast;SUBSURF 被原生拒绝“Only deforming modifiers can be applied to shapes”,与桌面语义一致;证据 tools/web/complete/probe-modifier-shapekey.mjs。
  • 自动关键帧:偏好设置的原生实现已存在但 supported: false 隐藏。已开放 “自动关键帧”和“新建关键帧插值”两项。复测:勾选后在视口按 g, location 0→0.1,自动生成 location/rotation_euler/scale 共 9 条 F-Curve (各 1 键),状态 revision r5;证据 tools/web/complete/probe-autokey.mjs。
  • 界面偏好:“显示视图名称”原为 supported: false 隐藏,实际已接通视口标签。 已开放;复测标签 用户 · 透视 → 取消勾选 · 透视 → 恢复;证据 tools/web/complete/probe-viewname-preference.mjs。
  • 修改器参数:SOLIDIFY 的 Thickness 字段 0.01→0.5 写入 Main;证据 tools/web/complete/probe-modifier-params.mjs。
  • 着色器节点:Shading 的 着色器编辑器 添加 Math,节点 2→3, ShaderNodeMath 进入材质节点树;证据 tools/web/complete/probe-shadergraph-canvas.mjs。旧的内联 Shader Graph 草稿面板因 shaderGraphDraft 始终为 null 而不可达,实际编辑走 WasmShaderEditor。
  • 几何节点:Geometry Node Graph 添加 Subdivision Surface 并提交,生成 NODES 修改器与节点组,节点 NodeGroupInput/NodeGroupOutput/ GeometryNodeSubdivisionSurface;证据 tools/web/complete/probe-geometry-nodes.mjs。
  • 变换工具:g location 0→0.1、r rotation z→0.3142、s scale x→1.1, 撤销恢复 scale;证据 tools/web/complete/probe-transform.mjs。
  • 物理:Physics 面板 Add 创建 RIGID_BODY(ACTIVE,场景 rigidbody_world), Mass 1.0→5.0 写入 Main;证据 tools/web/complete/probe-physics.mjs。
  • 物理 Manifest/播放:RIGID_BODY 添加后 manifest 显示 1 systems · 0 cached, 播放使时间线 frame 1→2,暂停后停在 2;证据 tools/web/complete/probe-physics.mjs。
  • 主题预设:此前 dataset.theme 写入大写 LIGHT,CSS 选择器为 [data-theme="light"],切换无视觉效果。已归一化为小写/连字符;复测 DARK→LIGHT 背景 rgb(24,24,24)→rgb(236,236,236)→DARK;证据 tools/web/complete/probe-theme.mjs。
  • 曲线菜单:手柄自动(ALIGNED→AUTO)、细分(控制点 2→3,全部保持选中), 状态均为“原生操作已返回”;证据 tools/web/complete/probe-curve-menu.mjs。
  • 主题高对比度:data-theme="high-contrast",.area-frame 计算样式 outline solid 1px rgb(255,212,0)。
  • 关键帧/Dope Sheet:自动关键帧在 frame 1 生成 9 条 F-Curve;下一帧 到 frame 10 后再次变换,location 曲线变为 2 键(frames [1,10]、 values [0.1,0.2]);Keyframe Editor 将 frame 10 的值改为 0.5;Dope Sheet 显示“关键帧 1/10”两个点;证据 tools/web/complete/probe-keyframe-edit.mjs。
  • Scripting(2026-11-14):
    • 缺口:embeddedPythonRef.run 仍带 !localOnly 守卫,?ui=web 的 Python Console 直接报 PYTHON_PROJECT_UNAVAILABLE。
    • 缺口:多行粘贴按 codeop 的 single 编译,两个顶层语句报 SyntaxError: multiple statements。
    • 修复:移除 localOnly 守卫;console 编译遇 multiple statements 时 回退 compile(..., 'exec'),按脚本执行粘贴块。
    • 复测:print(bpy.app.version_string) → PROBE_DONE 5.2.0 LTS;多行 bpy.ops.mesh.primitive_cube_add() → Objects 7、Active Cube,状态 SceneIR r3;WASM 8a874494...。证据 tools/web/complete/probe-python-console.mjs。
  • Spreadsheet(Geometry Nodes 工作区):数据源含 objects/vertices/edges/ faces/uv/attributes;attributes 表 9 行(position/normal/UVMap/...); “读取求值后属性”返回 12 行(UVMap、select_vert 等及前 8 值)。证据 tools/web/complete/probe-spreadsheet.mjs。
  • Sequencer:Properties 的 Sequencer Strip Editing → Add Strip 创建 Web MOVIE(MOVIE);证据 tools/web/complete/probe-sequencer.mjs。
  • Outliner:右键 Data 菜单 → 重命名,PBR Studio Ground → GroundRenamed, Main 已改名;证据 tools/web/complete/probe-outliner-rename.mjs。
  • Sculpt:Apply Sculpt Stroke(DRAW,radius 20)使 Ground 四个顶点 z 0→0.6429,Main revision r2;证据 tools/web/complete/probe-sculpt-stroke.mjs。
  • 模式菜单:mode chip 可打开并切换 Object→Sculpt,状态 模式:Sculpt。 此前自动化“无菜单项”是 Playwright 角色选择器问题(实际 role 为 menuitemcheckbox),非产品缺口;证据 tools/web/complete/probe-mode-menu.mjs。
  • Texture Paint:导入 re-texture-base.png → 打包 1024×1024,Texture Paint 画布加载;笔画提交(笔画已提交,r4)→ 撤销(已撤销,r5)。证据 tools/web/complete/probe-texture-paint.mjs。自动化中撤销按钮曾被 workspace 工具栏遮挡,程序化点击可执行;布局遮挡未单独判定为缺陷。

着色器节点目录补齐(2026-11-14)

  • 缺口:Shader Editor 的 Add 菜单列出 24 类节点,但原生 editShaderNode 的 ADD 映射只支持 14 类;添加 Noise Texture 返回 SHADER_NODE_UNSUPPORTED(界面“节点修改未提交”)。

  • 修复:web_engine_main_state.cpp 的 ADD 映射与 setShaderGraph 白名单补齐 DIFFUSE/GLOSSY/EMISSION/MIX_SHADER/ADD_SHADER/NOISE/GRADIENT/CHECKER/ FRESNEL/LAYER_WEIGHT;web_engine_blend_reader.cpp 读回映射;scene-ir.ts 类型与校验;shader-node-catalog.ts 的 readbackTypes。

  • 证据:Noise Texture 2→3(ShaderNodeTexNoise)、Emission 2→3 (ShaderNodeEmission),SceneIR r3。WASM fc6d0cb1... 已同步并重建 web/dist。

  • Compositor:WASM 合成求值 在无合成节点组的场景返回结构化 INVALID_ARGUMENT: COMPOSITOR_NODE_GROUP_MISSING: scene has no compositing node group。此前错误对象被渲染为 [object Object],已在 App.tsx 规范化 code/message;证据 probe-compositor.mjs。

  • Compositor 求值(2026-11-14 深挖):

    • 提交图后调用 WASM 合成求值 曾报 Browser draw manager must be created once per WM canvas;已在 web_engine_blend_main_compositor_evaluate 中临时把 scene.r.compositor_device 切到 CPU(求值后恢复),消除该 GPU 上下文依赖(WASM 198d2f01...)。
    • 用正确命令 setCompositorNodeGraph 提交 RGB → Composite 图后, 求值仍报 COMPOSITOR_RESULT_MISSING;已在该函数中先调用 RE_InitState 创建空 RenderResult/默认视图,使合成输出可写入 have_combined。
    • 复测:compositorEvaluate 返回 1024×1024、5,592,408 字节 base64; Properties → WASM 合成求值 显示图像,状态 WASM 合成 1024×1024。
    • 结果图原用 data: URL 被部署 CSP(img-src 'self' blob:)拦截; 已改为 URL.createObjectURL 的 blob URL。WASM be87a9ad...。 证据 tools/web/complete/probe-compositor-eval.mjs。

下一动作

  1. 用户验证 ?ui=web 导出面板的 USD/Alembic 下载与产物内容。
  2. Phase B:建模/雕刻/UV/纹理绘制的真实交互缺口(A1 已打通菜单 operator 执行)。
  3. 把 setTrackingMarkers / setMaskSpline / setMaskPoint 四条 no-op 原生命令替换为 真正的 Main writer,或从能力表移除,避免其他调用方继续误用。
  4. 全部实现完成后统一跑门禁:check-manual.mjs、check-parity-claim.mjs、 audit-wbv2-feature-completeness.mjs,再进入用户使用验证。