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

137 lines
23 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,
"voice": "zh-CN-XiaoxiaoNeural",
"chapters": [
{
"id": "intro",
"title": "开场:这套课程会带你做什么",
"narration": "这一套课程面向第一次使用 Web Blender 的同学,目标是让你在浏览器里独立完成一次真实的小项目。我们使用的素材不是示范用的替代品,而是本机的两个真实文件:一个只有网格、没有材质的猴头 GLB,以及从 RE 五千 PBR 精简版资产目录派生出来的六种材质。课程会从新建工程开始,先导入猴头,再从资产库分配材质,然后依次走完建模、修改器、雕刻、UV、纹理绘制、曲线与文字、材质节点、PBR 渲染、原生后端渲染、合成、几何节点、数据表、Python 脚本、导入导出、物理模拟、序列编辑器、相机与追踪、偏好设置。每个模块都会告诉你点哪里、应该看到什么、以及为什么这样做。所有保存、重开和恢复都使用浏览器 OPFS,只有你主动点击下载时才会生成本地文件。建议第一遍连续观看,第二遍打开产品按模块跟做,遇到不一致时先看底栏状态和对象数。"
},
{
"id": "M01",
"title": "工程、导入猴头与 OPFS 保存",
"narration": "先打开产品入口,地址里的 ui 等于 web。第一次加载需要把较大的 WebAssembly 引擎下载到浏览器,可能需要几十秒到几分钟,耐心等待底栏出现 Engine 和场景状态。新建常规工程后,场景里有立方体、相机和灯光三个对象。点击文件菜单里的打开,选择 re 目录里的猴头点 GLB。注意导入是追加,不会替换当前场景;导入完成后对象数增加一,活动对象变成 Suzanne。此时猴头没有材质,所以是灰色的,这是正常的基线。接下来点击顶栏的保存项目。这个动作只写入浏览器 OPFS,不会弹出下载框。底栏的保存状态变成 SUCCEEDED,表示工程已经落盘。为了验证保存,关闭项目,再从最近的工程里选择刚保存的 studio 点 blend,等待场景恢复;对象数应该和保存前一致,活动对象仍然是 Suzanne。如果你需要一份本地备份,最后再点击下载点 blend,这是唯一会生成本地文件的动作。记住区分保存和下载:保存用于继续工作,下载用于备份或交付。"
},
{
"id": "M02",
"title": "界面、工作区与视口",
"narration": "顶部一排是工作区标签,依次是 Layout、Modeling、Sculpting、UV Editing、Texture Paint、Shading、Animation、Rendering、Compositing、Geometry Nodes 和 Scripting。工作区只是布局,不会改变工程数据。点击标签即可切换,右侧的工作区列表菜单也提供同样的入口。区域右上角和头部有三点菜单,可以把当前区域垂直或水平分割、合并、交换,也可以复制、最大化或关闭。分割后每个区域都有独立的编辑器类型下拉框,例如把 Outliner 切换成 Spreadsheet 或 Python Console。三维视口的导航要熟练:按住鼠标中键拖动旋转,滚轮缩放,Shift 加中键平移;数字小键盘零进入相机视图,再按一次退出;Home 框显全部对象。找不到按钮时按 F3 打开操作搜索,输入移动、保存或某个算子名,结果会标注执行位置。灰色的命令表示当前上下文不可用,不是程序坏了。"
},
{
"id": "M03",
"title": "Outliner、对象与层级",
"narration": "Outliner 是场景的层级表。单击对象名选择,按住 Shift 再单击可以多选;选中的对象在三维视口里会出现橙色轮廓。按 F2 或者双击名称进入重命名,输入后按 Enter 确认。改名会写入 Main 数据,保存 OPFS 后重新打开仍然保留。对象右侧的眼睛图标控制可见性,隐藏只影响显示,不会删除数据,再次点击就恢复。把对象拖到另一个对象上会建立父子关系,拖到集合上则改变集合链接。物体菜单里的 Parent 和 Join 要区分:Parent 只改变层级,子对象仍保留自己的网格;Join 会把多个网格合并成一个数据块,活动对象决定合并后的名称和数据。集合用于组织场景,新建集合后可以把对象拖进去。所有层级和集合变化都会进入撤销历史,操作错了先撤销再继续。"
},
{
"id": "M04",
"title": "Properties、变换、相机与灯光",
"narration": "Properties 是右侧的属性面板,顶部有对象、修改器、材质三个标签。对象标签里可以看到并直接输入位置、旋转和缩放,输入后立即提交并进入撤销历史。物体菜单的应用子菜单可以把位置、旋转、缩放烘焙进网格;应用后数值归零,但网格形状不变。设置原点可以把轴心移到几何体中心、游标或世界原点,后续旋转和缩放会围绕新轴心进行。选择相机后,相机属性可以调整焦距、裁剪起点和终点;数字小键盘零进入相机视图,在相机视图里导航会移动相机本身。选择灯光后,可以调整类型、能量、阴影和衰减;World 区域调整环境光和背景。链接对象或链接材质的属性是只读的,需要先设为本地才能编辑。场景和渲染属性在下方,包含分辨率、帧范围、色彩管理和输出格式。"
},
{
"id": "M05",
"title": "建模与网格编辑",
"narration": "在 Modeling 工作区或添加菜单里创建立方体、平面、UV 球、圆柱、圆锥和圆环,也可以按 F3 搜索基础体命令。选中网格后点击模式按钮切到编辑模式,再选择顶点、边或面选择域。视口工具里的框选按钮可以拖出一个矩形选择元素;B 键是桌面版的框选,也可以沿循环边、边环或相似元素扩展选择。常用操作要形成手感:E 挤出,Ctrl B 倒角,Ctrl R 环切,I 内插,G 移动,S 缩放,R 旋转。这些操作在 Web 版里通过真实 Blender 原生算子执行,不是前端模拟。拓扑有问题时,用重新计算法线、按距离合并、删除松散元素和溶解来修正。每一步都可以撤销,破坏性操作前先保存或确认撤销可用。菜单和 F3 调用的是同一批算子,找不到按钮时优先用 F3。"
},
{
"id": "M06",
"title": "修改器栈",
"narration": "修改器是不破坏原始网格的编辑方式。在 Properties 的修改器标签点击添加,先加细分曲面,把视口级别从一调到二,紫色线框会显示细分后的形状。再加镜像,选择轴并打开裁切,让对象关于原点对称。布尔修改器需要选择另一个对象作为操作数,并选择并集、差集或交集;布尔要求网格尽量封闭,否则结果会破面。阵列修改器通过数量和偏移复制对象。修改器从上到下求值,拖动顺序会改变结果。每个修改器右侧的眼睛控制视口显示,相机图标控制渲染显示。确认效果后点击应用,把修改器烘焙进网格;应用后不能再靠参数回退,只能撤销或重做。修改器栈会随工程保存到 OPFS。"
},
{
"id": "M07",
"title": "雕刻",
"narration": "选中猴头,切到 Sculpting 工作区。属性面板里有笔刷、半径、强度、压力、对称和镜像设置。先选择 Draw 笔刷,把半径调到适合头部的尺寸,强度不要一开始就拉满。在视口按住左键拖拽,指针移动会被采样成一条笔触,松开后提交为一次原生 sculptStroke。画错了直接撤销。Inflate 让表面鼓起,Grab 抓住一片区域移动,Smooth 平滑过渡。遮罩可以保护已有形状,活动面组用于局部操作。需要重新拓扑时设置 Remesh 的体素大小,再点击 Voxel Remesh;体素越小细节越多,但内存和计算也越高。复杂形状分多次画,每次画完检查视口和撤销,避免一次改太多。"
},
{
"id": "M08",
"title": "UV 编辑",
"narration": "选中猴头,切到 UV Editing。桌面 Blender 的 UV 编辑器要求网格处于编辑模式,所以先点击模式按钮进入 Edit Mode。左侧是三维视口,右侧是 UV 画布。在 UV 画布点击全选 UV,等待状态提示选择已提交;再点击展开所选 UV,橙色点会变成展开后的 UV 岛。展开前标记缝合线通常能得到更整齐的结果,可以用边菜单或 F3 标记缝合线。展开后使用打包 UV 岛整理布局,平均岛缩放让各个面的纹理密度接近。UV 选择与三维视口选择是两套状态,切换时注意当前焦点。完成后回到 Layout 保存 OPFS,重新打开工程,UV 数据和贴图坐标应保持一致。链接网格数据需要先设为本地才能写入。"
},
{
"id": "M09",
"title": "纹理绘制",
"narration": "切到 Texture Paint 工作区。先选择要绘制的 packed 图像;如果没有图像,可以从材质的外部贴图入口导入,资源会进入 OPFS 工程。设置画笔颜色、半径和强度,在二维画布上拖拽绘制。松开后一次绘制提交为一个事务,可以用撤销和重做对比结果。保存 OPFS 后重新打开,笔画仍然存在。库链接的图像要先点击设为本地,这一步调用原生的 Make Local,之后再绘制才能写入。课程使用一千零二十四分辨率的图像,图像越大,PNG 编码和加载越慢。需要 UDIM 多块贴图或三维投影绘制时,通过原生会话完成;二维 packed 绘制是浏览器内的本地能力。"
},
{
"id": "M10",
"title": "曲线、文本、字体与 Grease Pencil",
"narration": "添加菜单里有 Bezier 和 NURBS 曲线、曲面、文本、骨架、融球、体积、晶格、点云、毛发、Grease Pencil 和力场。创建曲线或文本后进入编辑模式,可以编辑控制点、手柄和样条类型;曲线属性里可以设置挤出、倒角、锥化和分辨率。文本属性可以编辑正文、对齐、行距和字体链接。导入本地 TTF、OTF 或 PFB 字体会把文件打包进 Main,保存 OPFS 后重新打开仍然可用,字体文件也会计入工程资源体积。Grease Pencil 在属性面板里管理图层、帧和笔画,可以绘制、选择、移动和插值;材质和插值属于进阶操作。非网格数据的高级编辑受能力矩阵限制,部分操作需要原生会话或 F3。"
},
{
"id": "M11",
"title": "Shading 与 RE 5000PBR 资产库",
"narration": "切到 Shading 工作区。左下角是 PBR 资产库,默认有基础资产和 RE 两个来源;用资产来源下拉框选择 RE 五千 PBR,列表只保留六张材质卡片。卡片显示缩略图和材质名。单击卡片只会选中,不会分配;双击才会把材质分配给当前对象。依次双击防滑颗粒、砖墙、随机瓷砖、光亮瓷砖、规则砖墙和做旧砖墙,每次等待材质槽更新,并确认材质球显示 COMPILED、贴图状态为 ready。如果缩略图还没加载完,稍等或点击刷新。需要更高清时可以点击加载高清贴图,启用两千零四十八的 HQ 库;HQ 是按需加载的,首次启用会明显变慢,也会占用更多显存。RE 资产来自本机的五千 PBR 精简版目录,贴图已经打包,不依赖网络。"
},
{
"id": "M12",
"title": "PBR 渲染与诊断",
"narration": "切到 Rendering 工作区,右侧是 PBR 渲染面板。先选择分辨率,课程用一千零二十四或两千零四十八;再选择相机和视角预设,SCENE_CAMERA 使用场景相机,COMPARISON 提供对比视角。点击渲染 PBR,等待结果图出现,状态会显示纹理准备情况和渲染进度。如果画面偏暗,可以用教学曝光加一或加二 EV。诊断视图可以切换基础色、法线和粗糙度,用来检查贴图是否正确绑定、法线方向是否合理。位移强度控制几何细节的夸张程度,交互视口不会细分,位移主要在静态渲染里体现。满意后点击下载 PNG,这是手动触发的本地保存。需要记住,这条路径是浏览器内的 WebGL2 PBR 渲染,不是桌面 EEVEE 或 Cycles。"
},
{
"id": "M13",
"title": "动画、Graph、NLA 与播放",
"narration": "在 Animation 工作区选中猴头。时间线可以跳到首帧、末帧、上一帧或下一帧,也可以直接输入帧号。移动到目标帧后,点击位置、旋转、缩放按钮插入关键帧;Dope Sheet 会显示关键点。点击播放,时间线由 Blender 持久依赖图逐帧求值,状态栏会显示原生播放状态;再次点击暂停,然后拖到中间帧检查插值。Graph 编辑器可以调整关键帧、手柄和插值方式;NLA 表单可以添加轨道和 Strip,并提交到 Main;驱动器可以写入表达式,变量和目标在下方只读展示。自动关键帧可以在偏好设置里开启,开启后移动对象会自动插入关键帧。场景绑定里点击用当前对象作相机,可以把视口切换到对象视角;数字小键盘零和相机锁定用于持久化。"
},
{
"id": "M14",
"title": "EEVEE 与 Cycles 后端渲染",
"narration": "浏览器内的 PBR 渲染和桌面的 EEVEE、Cycles 是两条不同路径。需要原生引擎时,使用部署服务器提供的原生工作流。先确认服务已启动,Blender 二进制路径指向本机编译好的版本;服务器会通过 bwrap、prlimit 和 xvfb 运行有界任务。在 Rendering 工作区展开桌面 EEVEE 渲染区域,选择引擎和帧范围,提交任务。任务完成后产物会出现在文件列表,可以下载或把结果工程回写 Main。后端并发上限是两个任务,单任务源码上限五百一十二兆,渲染帧数也有上限;大场景请分批。后端缺失工具时会返回五百零三,这不是前端缺陷,先检查部署环境。"
},
{
"id": "M15",
"title": "Compositor 合成",
"narration": "切到 Compositing 工作区。画布上已经有合成输出节点,可以从添加节点类型里选择常量颜色、曝光、模糊、混合、变换、图像和渲染层等节点,点击添加。节点添加后,从右侧输出圆点拖到下一个节点的输入圆点,再连到合成输出;连线会写入节点图。修改节点参数后点击提交图,整个图会写入 Main 并保存到 OPFS。点击 WASM 合成求值,浏览器会调用 Blender 的 CPU 合成器执行当前节点树,并把结果画在画布上;这是真实原生求值,不是前端滤镜。需要完整渲染管线时,在 Render Pipeline 区域点击服务端合成渲染,由服务器 Blender 执行。合成节点目录是受控 allowlist,未知节点会被拒绝。"
},
{
"id": "M16",
"title": "Geometry Nodes",
"narration": "切到 Geometry Nodes 工作区。画布上已有组输入和组输出节点。从添加节点类型下拉框选择变换、设置位置、连接几何、实例化或基础网格等节点,点击添加;节点会出现在画布上。把几何输出连到下一个节点的几何输入,修改参数,再点击提交图。提交后原生几何节点修改器会重建网格,视口随图更新。当前目录提供四十类节点,覆盖基础网格、实例化、分布、实例变换、曲线和挤出等常用能力;仿真区域、重复和遍历仍是明确边界。保存 OPFS 后重新打开,节点、连线、位置和参数都会保留。复杂节点图先在副本上试验,避免破坏主对象。"
},
{
"id": "M17",
"title": "Spreadsheet 求值属性",
"narration": "在 Geometry Nodes 工作区的右下角是 Spreadsheet。顶部数据源可以选择对象、顶点、边、面、UV 或属性。对象表显示名称、类型、可见性和变换;顶点、边、面表显示索引和坐标;属性页最关键。点击读取求值后属性,Spreadsheet 会通过 Blender 求值依赖图读取几何节点修改器作用后的网格属性,显示名称、域、数据类型、数量和前八个值。这样你能看到最终几何上的属性,而不是原始缓冲。使用过滤行搜索,使用分页和每页行数查看大表,避免一次渲染几十万行。需要离线分析时点击导出 CSV,由浏览器手动下载。Spreadsheet 是只读检查器,不会修改工程。"
},
{
"id": "M18",
"title": "Scripting 与 Python 控制台",
"narration": "切到 Scripting 工作区。Python 控制台使用浏览器内嵌的 CPython,不依赖原生会话。在输入框里写 import bpy,然后打印所有对象名,点击执行 Python。输出会显示在控制台,命令也会记录到 Info 区域。脚本可以读取和修改 Main,因此执行前先保存 OPFS,并确认撤销历史可用。长脚本运行时可以点击停止;会话异常时可以重置 Python 会话;控制台记录可以下载,便于排查错误。Text Editor 可以保存和运行文本数据块,适合反复执行的脚本。任意网络访问、安装第三方包和加载外部插件不在能力范围;需要完整 Python 环境时使用原生会话。"
},
{
"id": "M19",
"title": "导入:GLB、glTF 文件夹与其他格式",
"narration": "文件菜单的打开可以导入 blend 和多种模型格式。导入 GLB 会追加到当前场景,本课程的猴头就是这样进入工程的;导入后检查对象数和活动对象。带外部资源的 glTF 需要按 F3 搜索导入 glTF 文件夹,然后选择包含 gltf、bin 和贴图的整个目录;相对路径会被保留,贴图才能正确找到。OBJ 使用导入 OBJ 面板,可以同时选择 obj、mtl 和贴图文件;STL 和 PLY 通过同一个文件输入导入。图像和字体从材质或文本属性导入,资源会进入 OPFS 工程,保存后重新打开仍然可用。导入失败时先看状态栏的错误码,常见原因是文件不完整或格式不受支持。"
},
{
"id": "M20",
"title": "导出:GLB、OBJ 与 USD、Alembic、FBX",
"narration": "文件菜单的导出子菜单提供多种格式。需要浏览器本地导出时选择 Web GLB,完成后由浏览器下载;这是最常用的交换格式。glTF Binary 条目会打开原生导出面板。OBJ 可以选择本地导出或原生导出;本地导出不依赖后端,适合快速交换。USD、Alembic 和 FBX 需要完整的 Blender IO 模块,因此通过导出面板提交给服务器 Blender,任务完成后下载产物包。导出前确认活动对象和选择范围,避免把不需要的对象一起导出。导出不会自动覆盖本地文件,下载位置由浏览器决定。需要验证时,把导出的文件重新导入一个新工程,检查对象数、材质和贴图是否保留。"
},
{
"id": "M21",
"title": "物理与模拟",
"narration": "在 Properties 的物理区域选择刚体、布料、流体、软体或粒子系统。刚体可以设置质量、摩擦、弹性、碰撞形状和运动学;布料可以设置质量、空气阻尼、各种刚度和压力;流体可以设置域类型、分辨率、粘度和缓存范围;粒子可以设置数量和缓存。参数写入 Main 后,点击播放,Blender 持久依赖图会逐帧推进求解和缓存。也可以在 Simulate Range 输入起止帧,点击 Simulate,让模拟一次推进到目标帧,完成后检查对象位置和缓存状态。重负载求解建议使用服务器或原生烘焙,浏览器内单线程 WASM 对流体和大量粒子会比较慢。缓存文件可能不在 blend 内,保存前确认缓存策略。"
},
{
"id": "M22",
"title": "Sequencer 与本地媒体",
"narration": "序列编辑器在 Properties 的时间线区域。先选择 Strip 类型,Movie 用于视频,Sound 用于音频,Image 用于图片;用媒体文件按钮选择本地文件。点击 Add Strip 后,媒体会写入 OPFS,并暂存到当前会话的虚拟文件系统,Strip 出现在时间线上。可以编辑起止帧、通道、静音和锁定,使用移动、裁剪、分割调整时间,使用转场和调色设置效果。重开工程后,媒体文件仍保存在 OPFS,但当前会话的虚拟文件系统是空的,需要点击恢复媒体,把所有媒体资产重新暂存。最终视频导出通过服务器 Blender 完成,因为浏览器内不编译原生 FFmpeg 编码器。媒体不会自动下载,需要本地文件时手动导出。"
},
{
"id": "M23",
"title": "相机锁定、追踪与遮罩",
"narration": "数字小键盘零进入或退出相机视图;在相机视图里导航会移动相机,并可以用撤销恢复。相机锁定按视口保存,刷新后仍然保留。场景绑定区域可以把当前对象设为相机,这对用网格或空物体做镜头运动很有用;点击恢复场景相机可以切回。追踪和遮罩面板位于 Properties:选择片段和轨道后,可以添加、更新或删除标记点,设置帧和位置;选择遮罩、图层和样条后,可以编辑遮罩点的坐标、手柄类型和羽化,或者切换样条是否闭合。这些编辑通过内嵌 bpy 写入真实的 MovieClip 和 Mask 数据。相机求解需要已验证的求解实现,面板只显示已有的求解状态。"
},
{
"id": "M24",
"title": "偏好设置、键位、主题与 Add-ons",
"narration": "点击编辑菜单里的偏好设置打开设置窗口。左侧分类有界面、视口、动画、输入与导航、键位、保存与加载、文件、主题和系统。界面页控制状态栏、快捷工具栏、区域切换器和启动工作区;视口页控制 gizmo 大小和默认着色;动画页控制自动关键帧、插值方式和手柄类型。键位页点击录制后按下组合键,冲突会给出提示;恢复默认可以回到 Blender 预设。主题页可以切换深色、浅色和高对比度,界面立即应用。系统页显示内嵌 Blender 版本,并可以启停内嵌 Add-ons;外部扩展安装和网络 Python 不在能力范围。点击保存偏好写入 OPFS,刷新后仍然生效。"
},
{
"id": "outro",
"title": "收尾:把完整流程连起来",
"narration": "到这里,你已经用同一套猴头 GLB 和 RE 五千 PBR 资产走完了三十一项能力:从工程与 OPFS,到界面布局、对象层级、属性与变换、建模、修改器、雕刻、UV、纹理绘制、曲线文字、材质与资产库、PBR 渲染、原生后端渲染、合成、几何节点、数据表、Python 脚本、导入导出、物理、序列、相机、追踪和设置。建议回到课程页,按模块跟做;每一步都检查底栏 Engine 状态、对象数、保存状态和材质编译状态。遇到与课程不一致的地方,记录操作路径、截图和错误码,再回到对应章节定位。需要本地备份时手动下载 blend;需要原生引擎或插件能力时使用服务器或原生会话。完成整套练习后,你已经可以在浏览器里独立完成一个带材质、动画和渲染的真实小项目。"
}
]
}