Files
workinf_Blender_Wasm/tools/web/course/complete-course.json
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

429 lines
32 KiB
JSON
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.
{
"schemaVersion": 1,
"title": "Web Blender 完整初学者课程",
"subtitle": "用 RE 5000PBR 资产与猴头 GLB,从第一次打开到完整工作流",
"version": "1.0.0",
"audience": "第一次使用 Web Blender 的初学者;只需会使用浏览器和鼠标",
"firstLoadNote": "首次打开需要加载较大的 WebAssembly 引擎,可能需要 30–193 秒。底栏出现 Engine: SceneIR 后再开始操作。",
"rules": [
"所有保存、重开和恢复都使用浏览器 OPFS;不会自动下载文件。",
"需要本地 .blend 时,使用顶栏“下载 .blend”或“文件 → 下载 .blend 到本地”手动触发。",
"本课程使用 Chromium;其他浏览器不在本轮验证范围。",
"每一步都先看“你会看到什么”,再做下一步;状态栏和底栏是判断成功的主要依据。"
],
"videos": [
{
"id": "complete",
"title": "完整操作视频(带中文配音)",
"src": "/tutorial/complete/video/complete-course-720p.mp4",
"poster": "/tutorial/complete/video/poster.jpg",
"vtt": "/tutorial/complete/video/complete-course.zh-Hans.vtt",
"note": "建议第一遍连续观看,第二遍按章节跟做。"
}
],
"modules": [
{
"id": "M01",
"title": "工程、导入猴头与 OPFS 保存",
"level": "入门",
"minutes": 12,
"summary": "新建工程,导入 re/猴头.glb,保存到浏览器 OPFS,关闭后从最近项目重开,并手动下载一份本地备份。",
"objectives": ["认识顶栏、状态栏和底栏", "从本地导入 GLB", "区分 OPFS 保存与手动下载"],
"steps": [
{ "text": "打开 /?ui=web,等待底栏显示 Engine: SceneIR。新建常规工程会得到立方体、相机和灯光三个对象。", "image": "steps/M01-startup.jpg" },
{ "text": "点击“文件 → 打开”,选择 /home/mes123456/workinf_Blender_Wasm/re/猴头.glb。导入是追加,不会替换当前场景;对象数增加 1,活动对象是 Suzanne。", "image": "steps/M01-import-monkey.jpg" },
{ "text": "点击顶栏“保存项目”。底栏保存状态变为 SUCCEEDED,工程写入 OPFS;这一步不会下载文件。", "image": "steps/M01-opfs-save.jpg" },
{ "text": "关闭项目,再从“文件 → 最近打开”选择刚保存的工程。对象数和活动对象应与保存前一致。", "image": "steps/M01-reopen.jpg" },
{ "text": "需要本地备份时,点击顶栏“下载 .blend”。这是唯一会生成本地文件的动作,由你手动触发。", "image": "steps/M01-download.jpg" }
],
"tips": ["状态栏 SceneIR 后面的对象数是判断导入/重开是否成功的可靠信号。", "猴头本身没有材质,导入后是灰色,这是正常的基线。"],
"warnings": ["清除浏览器站点数据会删除 OPFS 工程;重要工程请手动下载备份。"],
"checks": ["底栏 Engine 显示 SceneIR", "导入后对象数增加 1", "保存状态 SUCCEEDED", "重开后对象数一致"]
},
{
"id": "M02",
"title": "界面、工作区与视口",
"level": "入门",
"minutes": 10,
"summary": "认识 11 个工作区,切换 Layout/Modeling/Rendering 等,使用区域 ⋮ 菜单分割与合并,并掌握轨道、缩放和框显。",
"objectives": ["切换工作区", "分割与合并区域", "在 3D 视口导航"],
"steps": [
{ "text": "顶部工作区标签依次是 Layout、Modeling、Sculpting、UV Editing、Texture Paint、Shading、Animation、Rendering、Compositing、Geometry Nodes、Scripting。点击任意标签切换。", "image": "steps/M02-workspaces.jpg" },
{ "text": "把鼠标放到某个区域,点击区域右上角或头部的 ⋮ 菜单,选择“垂直分割(左右)”。再点一次可合并或交换区域。", "image": "steps/M02-area-menu.jpg" },
{ "text": "在 3D 视口按住中键拖动旋转,滚轮缩放,Shift+中键平移;数字小键盘 0 进入相机视图,Home 框显全部。", "image": "steps/M02-viewport.jpg" },
{ "text": "按 F3 打开操作搜索,输入“移动”或“保存”,可以看到并执行命令。F3 是找不到按钮时的首选入口。", "image": "steps/M02-f3.jpg" }
],
"tips": ["工作区只是布局,不会改变工程数据。", "F3 搜索结果会标注执行位置(本地/服务器)。"],
"warnings": ["灰色或标 unavailable 的命令表示当前上下文不可用,不是 bug。"],
"checks": ["11 个工作区都能切换", "区域可以分割并恢复", "F3 能搜到命令并执行"]
},
{
"id": "M03",
"title": "Outliner、对象与层级",
"level": "入门",
"minutes": 10,
"summary": "在 Outliner 选择、重命名、切换可见性、拖放父子关系,并建立集合。",
"objectives": ["选择和重命名对象", "切换可见性", "建立父子与集合"],
"steps": [
{ "text": "在 Outliner 单击对象名选择;Shift 单击可多选。选中猴头后,3D 视口会出现橙色轮廓。", "image": "steps/M03-select.jpg" },
{ "text": "按 F2 或双击名称重命名;改名会写入 Main,保存后重开仍保留。", "image": "steps/M03-rename.jpg" },
{ "text": "点击对象右侧的眼睛图标切换可见性;隐藏只影响显示,不删除数据。", "image": "steps/M03-visibility.jpg" },
{ "text": "把一个对象拖到另一个对象上建立父子关系;拖到集合上则移动集合链接。", "image": "steps/M03-parent.jpg" }
],
"tips": ["Outliner 的选择会同步到 3D 视口和 Properties。", "Join 会合并网格数据,Parent 只改变层级。"],
"warnings": ["删除对象可用撤销恢复;删除数据块前请先保存。"],
"checks": ["选择与视口一致", "重命名保存后保留", "父子/集合关系正确"]
},
{
"id": "M04",
"title": "Properties、变换、相机与灯光",
"level": "入门",
"minutes": 12,
"summary": "在 Properties 编辑位置/旋转/缩放,应用变换与设置原点,编辑相机、灯光、世界和场景渲染属性。",
"objectives": ["编辑变换并撤销", "应用变换/原点", "编辑相机与灯光"],
"steps": [
{ "text": "Properties 顶部有对象、修改器、材质三个标签。对象标签里直接输入位置/旋转/缩放数值。", "image": "steps/M04-transform.jpg" },
{ "text": "在“物体 → 应用 → 全部变换”把变换烘焙进网格;设置原点可把轴心移到几何体中心。", "image": "steps/M04-apply.jpg" },
{ "text": "选择相机,编辑焦距、裁剪和相机视图;数字小键盘 0 进入/退出相机视图。", "image": "steps/M04-camera.jpg" },
{ "text": "选择灯光,调整类型、能量、阴影;World 区可调环境光。", "image": "steps/M04-light.jpg" }
],
"tips": ["变换输入框支持直接键入数值和撤销。", "应用变换后数值归零,但网格形状不变。"],
"warnings": ["链接对象/材质的属性是只读的;需要先 Make Local。"],
"checks": ["变换改变视口", "应用后网格保持形状", "相机视图与灯光生效"]
},
{
"id": "M05",
"title": "建模与网格编辑",
"level": "进阶",
"minutes": 18,
"summary": "创建基础体,进入编辑模式,使用顶点/边/面/边框选,执行挤出、倒角、环切、内插与法线修正。",
"objectives": ["进入编辑模式", "框选与环选", "常用网格算子"],
"steps": [
{ "text": "在 Modeling 工作区或“添加”菜单创建立方体/平面/球体;也可按 F3 搜索 primitive 命令。", "image": "steps/M05-primitive.jpg" },
{ "text": "点击模式按钮切到 Edit Mode;选择顶点/边/面模式。B 键或视口框选工具可框选元素。", "image": "steps/M05-edit-mode.jpg" },
{ "text": "按 E 挤出、Ctrl+B 倒角、Ctrl+R 环切、I 内插;这些操作在 ?ui=web 下通过真实 Blender 算子执行。", "image": "steps/M05-tools.jpg" },
{ "text": "使用“法线 → 重新计算”和“按距离合并”修正拓扑;每步都可用撤销恢复。", "image": "steps/M05-normals.jpg" }
],
"tips": ["菜单和 F3 都可以调用同一批算子。", "高面数操作注意浏览器内存与响应时间。"],
"warnings": ["破坏性操作后先保存或确认可撤销。"],
"checks": ["编辑模式可切换选择域", "框选/环选生效", "算子后网格更新"]
},
{
"id": "M06",
"title": "修改器栈",
"level": "进阶",
"minutes": 12,
"summary": "添加 Subdivision、Mirror、Boolean、Decimate、Array 等修改器,调整顺序和参数,并应用。",
"objectives": ["添加与排序修改器", "调参数并观察视口", "应用修改器"],
"steps": [
{ "text": "在 Properties 的修改器标签点击添加,选择 Subdivision Surface,级别从 1 调到 2。", "image": "steps/M06-add.jpg" },
{ "text": "添加 Mirror,设置轴与裁切;再添加 Boolean,选择另一个对象作为操作数。", "image": "steps/M06-stack.jpg" },
{ "text": "拖动修改器顺序会改变结果;眼睛图标控制视口/渲染可见性。", "image": "steps/M06-order.jpg" },
{ "text": "点击 Apply 把修改器烘焙进网格;Apply 前先复制对象以便对比。", "image": "steps/M06-apply.jpg" }
],
"tips": ["Boolean 需要封闭网格;Mirror 依赖原点。", "修改器参数与顺序都保存到 OPFS。"],
"warnings": ["应用后不能再用参数回退,只能撤销或重做。"],
"checks": ["修改器按顺序求值", "参数改变视口", "Apply 后网格变化"]
},
{
"id": "M07",
"title": "雕刻",
"level": "进阶",
"minutes": 14,
"summary": "在 Sculpting 工作区用 Draw/Inflate/Grab/Smooth 笔刷拖拽雕刻,设置遮罩/面组并执行 Voxel Remesh。",
"objectives": ["选择笔刷并拖拽", "遮罩与面组", "Voxel Remesh"],
"steps": [
{ "text": "选中猴头,切到 Sculpting 工作区;在属性面板选择 Draw 笔刷,设置半径和强度。", "image": "steps/M07-brush.jpg" },
{ "text": "在视口按住左键拖拽,松开后一次原生 sculptStroke 会提交;撤销可恢复。", "image": "steps/M07-stroke.jpg" },
{ "text": "调整 Mask 和 Active Face Set;遮罩区域不会被笔刷改变。", "image": "steps/M07-mask.jpg" },
{ "text": "设置 Remesh 体素大小并点击 Voxel Remesh,重新拓扑后再继续雕刻。", "image": "steps/M07-remesh.jpg" }
],
"tips": ["每次拖拽是一次采样笔触;复杂形状分多次画。", "高细分网格会显著变慢。"],
"warnings": ["Remesh 会重建拓扑;先保存或确认可撤销。"],
"checks": ["笔刷改变网格", "撤销恢复", "Remesh 后仍可雕刻"]
},
{
"id": "M08",
"title": "UV 编辑",
"level": "进阶",
"minutes": 14,
"summary": "进入编辑模式,在 UV 工作区全选、展开、打包与缝合,为 PBR 贴图准备坐标。",
"objectives": ["进入 UV 工作区", "展开与打包", "检查 UV 岛"],
"steps": [
{ "text": "选中猴头,切到 UV Editing;桌面语义要求网格处于 Edit Mode,先进入编辑模式。", "image": "steps/M08-workspace.jpg" },
{ "text": "在 UV 画布点击“全选 UV”,等待选择提交;再点击“展开所选 UV”。", "image": "steps/M08-unwrap.jpg" },
{ "text": "使用“打包 UV 岛”和“平均岛缩放”整理布局;标记缝合线可改善展开结果。", "image": "steps/M08-pack.jpg" },
{ "text": "回到 Layout 保存;重开后 UV 数据和贴图坐标保持一致。", "image": "steps/M08-save.jpg" }
],
"tips": ["展开前标记缝合线通常能得到更整齐的 UV 岛。", "UV 选择与 3D 视口选择是两套状态。"],
"warnings": ["链接网格数据需要先 Make Local 才能写入。"],
"checks": ["UV 选择提交成功", "展开/打包改变布局", "保存重开 UV 不变"]
},
{
"id": "M09",
"title": "纹理绘制",
"level": "进阶",
"minutes": 14,
"summary": "在 Texture Paint 工作区对 packed 图像绘制、撤销/重做,并把库链接图像设为本地。",
"objectives": ["选择纹理图像", "画笔绘制与撤销", "Make Local"],
"steps": [
{ "text": "切到 Texture Paint,选择要绘制的 packed 图像;没有图像时先从材质或外部贴图导入。", "image": "steps/M09-workspace.jpg" },
{ "text": "设置颜色、半径和强度,在画布拖拽绘制;松开后提交为一个绘制事务。", "image": "steps/M09-stroke.jpg" },
{ "text": "使用撤销/重做对比结果;保存 OPFS 后重开,笔画仍在。", "image": "steps/M09-undo.jpg" },
{ "text": "库链接图像先点击“设为本地”(原生 Make Local),再绘制;3D 投影绘制需要原生会话。", "image": "steps/M09-make-local.jpg" }
],
"tips": ["图像越大,PNG 编码越慢;课程使用 1024×1024。", "2D 绘制是本地能力;UDIM/投影属于原生会话路径。"],
"warnings": ["清除站点数据会丢失 OPFS 中的贴图;重要贴图手动下载备份。"],
"checks": ["画布像素变化", "撤销恢复", "重开后笔画仍在"]
},
{
"id": "M10",
"title": "曲线、文本、字体与 Grease Pencil",
"level": "进阶",
"minutes": 14,
"summary": "创建曲线/曲面/文本/融球/Grease Pencil,编辑控制点与字体,并绘制 GP 笔画。",
"objectives": ["创建非网格对象", "编辑曲线/文本", "绘制 GP"],
"steps": [
{ "text": "“添加”菜单包含 Bezier/NURBS 曲线、曲面、文本、骨架、融球、体积、晶格、点云、毛发、Grease Pencil 与力场。", "image": "steps/M10-add.jpg" },
{ "text": "进入编辑模式编辑曲线控制点;文本属性可编辑正文、布局与字体链接。", "image": "steps/M10-text.jpg" },
{ "text": "导入本地 TTF/OTF/PFB 字体会打包进 Main,保存 OPFS 后重开仍可用。", "image": "steps/M10-font.jpg" },
{ "text": "在 GP 编辑器中添加图层/帧并绘制笔画;可调整材质与插值。", "image": "steps/M10-grease-pencil.jpg" }
],
"tips": ["非网格数据的高级编辑受能力矩阵限制,部分操作走原生/F3。", "字体文件会进入工程资源,注意体积。"],
"warnings": ["库链接字体的部分编辑只读。"],
"checks": ["非网格对象出现在 Outliner", "曲线/文本可编辑", "GP 笔画可保存"]
},
{
"id": "M11",
"title": "Shading 与 RE 5000PBR 资产库",
"level": "核心",
"minutes": 20,
"summary": "从 RE 5000PBR 派生库加载 6 种材质,分配给猴头,检查材质编译与贴图,并体验 HQ 2048。",
"objectives": ["认识资产库", "分配 6 种材质", "理解标准/HQ 与 packed 贴图"],
"steps": [
{ "text": "切到 Shading 工作区;左下角 PBR 资产库有 pbr-essentials 与 RE 两个来源。选择 RE 5000PBR,只显示 6 张材质卡片。", "image": "steps/M11-library.jpg" },
{ "text": "单击卡片只选中,双击才会分配。分配前确认顶部模式是 Object Mode;编辑模式下 Blender 会拒绝追加资产。依次双击防滑颗粒、砖墙、随机瓷砖、光亮瓷砖、规则砖墙、做旧砖墙。", "image": "steps/M11-assign.jpg" },
{ "text": "每次分配后等待材质槽更新且材质球显示 COMPILED;贴图状态应为 ready。", "image": "steps/M11-compiled.jpg" },
{ "text": "点击“加载高清贴图 (2048)”按需启用 HQ 库;HQ 更清晰但占用更多显存和加载时间。", "image": "steps/M11-hq.jpg" }
],
"tips": ["资产来源下拉框决定当前显示的库。", "RE 资产由 /home/mes123456/workinf_Blender_Wasm/re/5000PBR精简版 派生,贴图已 packed。"],
"warnings": ["HQ 是懒加载,首次启用会明显变慢;低显存设备先用标准库。"],
"checks": ["6 张卡片可见", "材质槽更新", "COMPILED 与贴图 ready", "HQ 可加载"]
},
{
"id": "M12",
"title": "PBR 渲染与诊断",
"level": "核心",
"minutes": 20,
"summary": "在 Rendering 工作区渲染猴头,调整分辨率/相机/视角/曝光/位移,查看诊断视图并下载 PNG。",
"objectives": ["完成一次 PBR 渲染", "使用诊断视图", "理解位移与 GPU"],
"steps": [
{ "text": "切到 Rendering;PBR 面板可选择分辨率 256–2048、相机与视角预设 SCENE_CAMERA/COMPARISON。", "image": "steps/M12-panel.jpg" },
{ "text": "点击“渲染 PBR”,等待结果图出现;材质、贴图和灯光共同决定画面。", "image": "steps/M12-render.jpg" },
{ "text": "切换诊断视图 BASE_COLOR/NORMAL/ROUGHNESS,检查贴图与法线;曝光可选 0/+1/+2 EV。", "image": "steps/M12-diagnostics.jpg" },
{ "text": "调整位移强度观察几何细节;点击“下载 PNG”手动保存渲染结果。", "image": "steps/M12-download.jpg" }
],
"tips": ["渲染使用 WebGL2/three.js 的 PBR 路径,不是桌面 EEVEE/Cycles。", "RTX 4060 硬件 lane 比 SwiftShader 快;首次纹理加载需要时间。"],
"warnings": ["交互视口不细分位移,位移主要影响静态渲染。", "深色材质在 PBR 下看起来偏暗,可提高曝光。"],
"checks": ["结果图出现", "诊断视图切换", "PNG 手动下载", "多次渲染 SHA 不同"]
},
{
"id": "M13",
"title": "动画、Graph/NLA/驱动器与播放",
"level": "核心",
"minutes": 20,
"summary": "插关键帧、播放动画、编辑 F-Curve/Graph、提交 NLA、设置驱动器表达式,并用对象作相机。",
"objectives": ["关键帧与播放", "Graph/NLA", "驱动器与相机"],
"steps": [
{ "text": "在 Animation 工作区选中猴头,移动时间线到不同帧,点击 Loc/Rot/Scale 插入关键帧。", "image": "steps/M13-keyframes.jpg" },
{ "text": "点击播放,时间线按 Blender 持久 depsgraph 逐帧求值;暂停后拖到中间帧检查插值。", "image": "steps/M13-playback.jpg" },
{ "text": "在 Graph Editor 调整关键帧/插值;在 NLA 表单提交 strip;驱动器表达式可写入并查看变量/目标。", "image": "steps/M13-graph-nla.jpg" },
{ "text": "在 Scene Bindings 点击“用当前对象作相机”,视口切换到该对象视角;可用 Numpad0/锁定持久化。", "image": "steps/M13-camera.jpg" }
],
"tips": ["自动关键帧可在 Preferences → 动画中开启。", "播放依赖原生 depsgraph,不是 JS 逐帧模拟。"],
"warnings": ["Graph 是简化编辑器;复杂驱动/曲线以原生会话为准。"],
"checks": ["关键帧出现在时间线", "播放推进帧", "NLA/驱动器提交", "对象相机生效"]
},
{
"id": "M14",
"title": "EEVEE/Cycles 后端渲染",
"level": "核心",
"minutes": 14,
"summary": "通过 server/native 后端使用桌面 Blender 的 EEVEE/Cycles 渲染,并把产物取回 Web 工程。",
"objectives": ["理解后端渲染", "提交渲染任务", "取回产物"],
"steps": [
{ "text": "确认后端已启动:部署服务器 + BLENDER_BIN 指向本机 Blender;打开渲染面板的桌面 EEVEE 区域。", "image": "steps/M14-backend.jpg" },
{ "text": "选择引擎与帧范围,提交渲染;任务完成后产物出现在文件列表。", "image": "steps/M14-render.jpg" },
{ "text": "下载或应用结果;后端结果 .blend 可按 revision 回写 Main。", "image": "steps/M14-result.jpg" }
],
"tips": ["后端并发上限 2,单任务 512 MiB;大场景请分批。", "后端渲染与本地 PBR 是两条不同路径。"],
"warnings": ["后端需要 bwrap/prlimit/xvfb-run 与 Blender 二进制;缺失时返回 503,不是本地 bug。"],
"checks": ["后端健康", "渲染任务完成", "产物可取回"]
},
{
"id": "M15",
"title": "Compositor 合成",
"level": "核心",
"minutes": 16,
"summary": "在 Compositor 画布添加/连线/提交节点,使用 WASM 合成求值,并体验服务端合成渲染。",
"objectives": ["节点图编辑", "WASM 求值", "服务端合成"],
"steps": [
{ "text": "切到 Compositing,画布已有输出节点;从“添加节点类型”选择 Constant Color/Exposure 等并添加。", "image": "steps/M15-nodes.jpg" },
{ "text": "从节点右侧输出拖到下一个节点输入,再连到 Composite;点击“提交图”写入 Main。", "image": "steps/M15-links.jpg" },
{ "text": "点击“WASM 合成求值”,在浏览器内用 Blender CPU 合成器求值并显示结果。", "image": "steps/M15-wasm-eval.jpg" },
{ "text": "在 Render Pipeline 点击“服务端合成渲染”,由 server Blender 执行完整合成。", "image": "steps/M15-server.jpg" }
],
"tips": ["节点目录是 allowlist;未知节点会被拒绝。", "合成结果可保存重开,节点位置/连线保留。"],
"warnings": ["服务端合成需要后端;失败时记录为后端 BLOCKED。"],
"checks": ["节点/连线/提交", "WASM 求值出图", "服务端合成出图"]
},
{
"id": "M16",
"title": "Geometry Nodes",
"level": "核心",
"minutes": 16,
"summary": "在 Geometry Nodes 工作区添加节点、连线并提交,生成程序化几何。",
"objectives": ["理解 GN 图", "添加/连线/提交", "查看结果"],
"steps": [
{ "text": "切到 Geometry Nodes,画布已有 Group Input/Output;从节点目录选择 Transform/Set Position 等添加。", "image": "steps/M16-nodes.jpg" },
{ "text": "连接 Geometry 线,修改节点参数,点击“提交图”;网格随图更新。", "image": "steps/M16-commit.jpg" },
{ "text": "尝试 Mesh Cube/Instance on Points 等 40 类目录中的节点;Simulation Zone 仍为明确边界。", "image": "steps/M16-result.jpg" }
],
"tips": ["原生 writer 接受已注册节点;UI 只提供 allowlist。", "保存重开会保留节点、连线与位置。"],
"warnings": ["Simulation Zone/Repeat/Foreach 未开放。"],
"checks": ["节点/连线提交", "几何更新", "保存重开保留"]
},
{
"id": "M17",
"title": "Spreadsheet 求值属性",
"level": "进阶",
"minutes": 12,
"summary": "在 Spreadsheet 查看对象/顶点/边/面/UV/属性,并读取 GN 修改器求值后的属性域。",
"objectives": ["切换数据源", "过滤/分页/CSV", "读取求值属性"],
"steps": [
{ "text": "在 Geometry Nodes 工作区的 Spreadsheet 选择数据源 Objects/Vertices/Edges/Faces/UV/Attributes。", "image": "steps/M17-sources.jpg" },
{ "text": "在 Attributes 点击“读取求值后属性”,查看名称/域/类型/数量与前 8 个值。", "image": "steps/M17-evaluated.jpg" },
{ "text": "使用过滤行、分页与“导出 CSV”;CSV 通过手动下载保存。", "image": "steps/M17-csv.jpg" }
],
"tips": ["求值属性读取的是 GN 修改器求值后的网格,不是原始缓冲。", "大表用分页避免整表截断。"],
"warnings": ["Spreadsheet 是只读检查器。"],
"checks": ["数据源切换", "求值属性出现", "CSV 下载"]
},
{
"id": "M18",
"title": "Scripting 与 Python 控制台",
"level": "进阶",
"minutes": 12,
"summary": "在 Scripting 工作区使用内嵌 CPython 控制台执行脚本、读取 Main、停止/重置会话并下载记录。",
"objectives": ["执行 Python", "读取对象", "重置/下载记录"],
"steps": [
{ "text": "切到 Scripting,Python Console 使用浏览器内嵌 CPython,不依赖原生会话。", "image": "steps/M18-console.jpg" },
{ "text": "输入 import bpy; print([o.name for o in bpy.data.objects]) 并点击“执行 Python”。", "image": "steps/M18-execute.jpg" },
{ "text": "使用停止/重置会话处理长脚本;下载控制台记录以便排查。", "image": "steps/M18-reset.jpg" }
],
"tips": ["脚本可修改 Main;执行前保存并保留撤销点。", "Text Editor 也可运行文本数据块。"],
"warnings": ["任意网络/插件安装 Python 不在能力范围。"],
"checks": ["脚本输出", "对象读取", "会话重置"]
},
{
"id": "M19",
"title": "导入:GLB、glTF 文件夹、OBJ/STL/PLY、图像/VFont",
"level": "核心",
"minutes": 16,
"summary": "导入猴头 GLB、带外部 .bin/贴图的 glTF 文件夹、OBJ/STL/PLY,以及图像与字体。",
"objectives": ["GLB 导入", "glTF 文件夹", "其他格式"],
"steps": [
{ "text": "“文件 → 打开”选择 .glb 会追加导入;本课程的猴头就是这种方式。", "image": "steps/M19-glb.jpg" },
{ "text": "F3 搜索“Import glTF 文件夹”,选择包含 .gltf/.bin/贴图的目录;相对路径会被保留。", "image": "steps/M19-gltf-folder.jpg" },
{ "text": "OBJ 使用“导入 OBJ”面板,可同时选择 .mtl 与贴图;STL/PLY 通过同一文件输入。", "image": "steps/M19-obj.jpg" },
{ "text": "图像和字体从材质/文本属性导入,资源进入 OPFS 工程。" , "image": "steps/M19-image-font.jpg" }
],
"tips": ["glTF 文件夹导入使用目录选择,不是单文件。", "导入是追加,不会替换当前场景。"],
"warnings": ["外部资源缺失时,模型可能没有贴图。"],
"checks": ["GLB 追加", "glTF 文件夹导入", "OBJ/STL/PLY 导入"]
},
{
"id": "M20",
"title": "导出:GLB/OBJ 与 USD/Alembic/FBX",
"level": "核心",
"minutes": 14,
"summary": "浏览器内导出 GLB/OBJ,并通过 server/native 后端导出 USD/Alembic/FBX。",
"objectives": ["本地导出", "后端导出", "校验产物"],
"steps": [
{ "text": "“文件 → 导出 → Web GLB”在浏览器内直接生成并手动下载;“glTF Binary (.glb)”条目会打开原生导出面板。", "image": "steps/M20-glb.jpg" },
{ "text": "OBJ 导出可选本地或原生路径;本地导出会生成 .obj。", "image": "steps/M20-obj.jpg" },
{ "text": "USD/Alembic/FBX 通过导出面板提交给 server Blender,完成后下载产物包。", "image": "steps/M20-native.jpg" }
],
"tips": ["本地导出不依赖后端,适合日常交换。", "USD/FBX 需要后端;失败时检查服务与 Blender 二进制。"],
"warnings": ["导出不会自动覆盖本地文件,下载由浏览器决定位置。"],
"checks": ["GLB/OBJ 产物", "USD/FBX 产物", "文件可被重新导入"]
},
{
"id": "M21",
"title": "物理与模拟",
"level": "进阶",
"minutes": 14,
"summary": "编辑刚体/布料/流体/粒子参数,播放模拟并执行 Simulate Range 推进 depsgraph。",
"objectives": ["物理参数", "播放", "Simulate Range"],
"steps": [
{ "text": "在 Properties → Physics 选择 Rigid Body/Cloth/Fluid/Particle,编辑质量、摩擦、碰撞、缓存。", "image": "steps/M21-settings.jpg" },
{ "text": "点击播放,Blender 持久 depsgraph 逐帧推进求解与缓存。", "image": "steps/M21-playback.jpg" },
{ "text": "在 Simulate Range 输入起止帧并点击 Simulate,完成后检查对象位置/缓存状态。", "image": "steps/M21-range.jpg" }
],
"tips": ["重负载求解建议使用 server/native bake。", "缓存写入 OPFS/原生缓存,保存 .blend 不一定包含外部缓存文件。"],
"warnings": ["流体/粒子在单线程 WASM 下可能很慢。"],
"checks": ["参数写入 Main", "播放推进", "Simulate Range 完成"]
},
{
"id": "M22",
"title": "Sequencer 与本地媒体",
"level": "进阶",
"minutes": 14,
"summary": "导入本地媒体到 OPFS/VFS,添加 Strip,编辑时间/通道/转场,并恢复媒体或提交服务端导出。",
"objectives": ["媒体选择", "Strip 编辑", "恢复/导出"],
"steps": [
{ "text": "在 Properties 的 Sequencer 区域选择 Strip 类型(Movie/Sound/Image),用“媒体文件”选择本地文件。", "image": "steps/M22-media.jpg" },
{ "text": "点击 Add Strip;媒体写入 OPFS 并暂存到当前会话 VFS。", "image": "steps/M22-strip.jpg" },
{ "text": "编辑起止帧、通道、静音,使用 Move/Trim/Split 与转场/调色。", "image": "steps/M22-edit.jpg" },
{ "text": "重开工程后点击“恢复媒体”从 OPFS 重新暂存;最终导出走 server Blender。", "image": "steps/M22-export.jpg" }
],
"tips": ["媒体不会自动下载;需要本地文件时手动导出。", "恢复媒体只重挂当前工程的所有媒体资产。"],
"warnings": ["浏览器不提供本地媒体选择器之外的路径访问。"],
"checks": ["媒体导入", "Strip 编辑", "恢复媒体", "服务端导出"]
},
{
"id": "M23",
"title": "相机锁定、追踪与遮罩",
"level": "进阶",
"minutes": 12,
"summary": "使用对象作相机、相机视图与锁定持久化,并在 Tracking/Mask 面板编辑 Marker 与遮罩点。",
"objectives": ["相机视图/锁定", "对象作相机", "追踪/遮罩"],
"steps": [
{ "text": "数字小键盘 0 进入/退出相机视图;在相机视图导航会移动相机并可撤销。", "image": "steps/M23-camera.jpg" },
{ "text": "在 Scene Bindings 点击“用当前对象作相机”,再点“恢复场景相机”切回。", "image": "steps/M23-object-camera.jpg" },
{ "text": "在 Tracking/Mask 面板选择 clip/track 或 mask/layer/spline,编辑 Marker 位置或遮罩点的坐标/羽化。", "image": "steps/M23-tracking.jpg" }
],
"tips": ["相机锁按视口保存,刷新后保留。", "追踪/遮罩编辑通过内嵌 bpy 写入 Main。"],
"warnings": ["Camera solve 需要已验证的求解实现;面板只显示已有状态。"],
"checks": ["相机视图/锁定", "对象作相机", "Marker/遮罩点更新"]
},
{
"id": "M24",
"title": "偏好设置、键位、主题与 Add-ons",
"level": "入门",
"minutes": 12,
"summary": "在 Preferences 调整界面/视口/动画/导航,录制键位,切换主题预设,并启停内嵌 Add-ons。",
"objectives": ["打开偏好设置", "编辑键位/主题", "Add-ons"],
"steps": [
{ "text": "“编辑 → 偏好设置”打开窗口;左侧有界面、视口、动画、输入与导航、键位、保存与加载、文件、主题、系统。", "image": "steps/M24-preferences.jpg" },
{ "text": "在键位页点击“录制”后按下组合键;冲突会提示。保存偏好写入 OPFS。", "image": "steps/M24-keymap.jpg" },
{ "text": "主题页选择 DARK/LIGHT/HIGH_CONTRAST,界面立即应用。", "image": "steps/M24-theme.jpg" },
{ "text": "系统页可查看 Blender 版本并启停内嵌 Add-ons;外部扩展安装不支持。", "image": "steps/M24-addons.jpg" }
],
"tips": ["偏好保存到 OPFS,刷新后保留。", "浏览器保留的快捷键可能与桌面键位冲突。"],
"warnings": ["完整桌面主题颜色表与全部键位仍以原生会话为准。"],
"checks": ["偏好保存", "键位录制", "主题切换", "Add-on 启停"]
}
]
}