UM-1.0.0 · 2026-11-13 · Blender 5.2.0 LTS
Web Blender 用户手册
本手册对标当前 Web Blender(?ui=web)的实际功能,按真实界面和真实操作步骤编写。工程保存、重开和恢复使用浏览器 OPFS;需要本地文件时使用独立的“下载”动作。手册不宣称完整桌面 Blender parity,未实现项在支持矩阵和限制章节中如实列出。
存储规则- 顶栏“保存项目”、Ctrl+S、文件 → 保存到浏览器 OPFS、另存为、自动恢复点只写浏览器存储。
- 需要本地 .blend 时,手动使用顶栏“下载 .blend”或文件 → 下载 .blend 到本地。
- PNG、GLB、CSV、诊断报告等下载都是独立的手动动作。
- 清除站点数据会删除 OPFS 工程、最近项目索引和偏好设置。
本章目标
- 识别 WASM 首次加载状态
- 打开 .blend 并确认 SceneIR
- 完成一次 OPFS 保存
1. 打开 Web 界面
在 Chromium 访问 /?ui=web,等待底栏显示 WASM 就绪与 Engine: SceneIR。远端首次加载需要下载约 79 MB wasm,页面会显示进度。
图 1.1 打开 Web 界面2. 载入练习工程
点击顶栏“打开 .blend”,选择课程工程 studio.blend(绝对路径:/home/mes123456/workinf_Blender_Wasm/web/app/public/tutorial/pbr/studio.blend),等待对象数变为 6。
图 1.2 载入练习工程3. 保存到 OPFS
点击顶栏“保存项目”。状态栏显示 SUCCEEDED 后,工程已写入浏览器 OPFS;此动作不会下载文件。
图 1.3 保存到 OPFS
完成检查
- 底栏 Engine 显示 SceneIR
- 对象数与工程文件一致
- 保存状态为 SUCCEEDED
提示
- 用 F3 搜索“打开”“保存到浏览器 OPFS”也可以执行同一入口。
限制 / 不支持
- 本地文件不会自动出现;需要时使用“下载 .blend”。
1. 认识工作区
顶部工作区标签包括 Layout、Modeling、Sculpting、UV Editing、Texture Paint、Shading、Animation、Rendering、Compositing、Geometry Nodes、Scripting;每个工作区有固定的默认区域布局。
图 2.1 认识工作区2. 使用状态栏
底栏显示活动对象、对象/顶点/面数量、WASM 与 Engine 状态、存储预算和版本;操作失败时先看 Engine 状态。
图 2.2 使用状态栏3. F3 命令搜索
按 F3,输入命令名(如“移动”“Export GLB”),选择带执行位置标签的条目。原生命令可能显示 DESKTOP/SERVER_NATIVE;浏览器等价命令显示 BROWSER。
图 2.3 F3 命令搜索
完成检查
- 11 个工作区标签齐全
- F3 能搜索到命令
- 状态栏能看到 Engine/存储状态
限制 / 不支持
- 灰色菜单项或带 unavailable 标记的命令尚未实现等价入口。
1. 新建与打开
文件 → 新建 → 常规创建默认场景;文件 → 打开或顶栏“打开 .blend”载入工程。打开期间状态栏显示读取进度,可取消。
图 3.1 新建与打开2. 最近项目
顶栏“最近项目”下拉或文件 → 最近打开列出显式保存过的工程;条目损坏时会提示“项目内容缺失/校验失败”,可移除引用。
图 3.2 最近项目3. 另存为与保存副本
另存为在 OPFS 创建并切换到新工程,不下载;保存副本下载本地 .blend,且不改变当前工程。需要本地工程时也可用顶栏“下载 .blend”。
图 3.3 另存为与保存副本
完成检查
- 最近项目能重开已保存工程
- 另存为后工程名/项目切换
- 保存副本产生下载文件
提示
- 同名 .blend 会映射到同一个 OPFS 项目;需要隔离时使用另存为。
本章目标
- 说明 OPFS/IndexedDB 分工
- 保存并重开工程
- 手动下载 .blend
1. 保存到 OPFS
保存项目写入 projects/<projectId>/scene.blend 及元数据;快照、资源与恢复点也在同一项目目录下。工程不会出现在浏览器下载目录。
图 4.1 保存到 OPFS2. 刷新并重开
刷新页面后,在最近项目中选择刚保存的工程;若询问是否保存当前修改,选择“不保存,继续”。对象、材质、UV/节点等 Main 数据应恢复。
图 4.2 刷新并重开3. 手动下载 .blend
顶栏“下载 .blend”或文件 → 下载 .blend 到本地会先把工程提交到 OPFS,再下载 <工程名>.blend。外部未打包资源不会自动包含。
图 4.3 手动下载 .blend
完成检查
- 重开后对象数一致
- 本地下载只在手动动作后出现
- 状态栏显示 OPFS 保存成功
提示
- 课程与测试的重开流程都使用最近项目/OPFS,不依赖自动下载。
限制 / 不支持
- 清除站点数据会删除 OPFS 工程与最近项目索引;本地 .blend 是持久备份。
本章目标
- 撤销/重做 Main 编辑
- 恢复自动恢复点
- 导出诊断报告
1. 撤销与重做
编辑 → 撤销/重做,或 Ctrl+Z/Ctrl+Y;撤销历史列出可回退的 Main 版本。工作区切换不会产生 Main 撤销步。
图 5.1 撤销与重做2. 恢复自动恢复点
文件 → 恢复 → 恢复浏览器恢复点,选择项目和恢复点后点“恢复选中版本”。自动恢复点不标记工程已保存,也不更新最近项目。
图 5.2 恢复自动恢复点3. 诊断与修复
最近项目损坏时可按条目移除引用;失败操作可点击顶栏“!”或帮助 → 导出诊断报告,生成 blender-web-diagnostics.json。
图 5.3 诊断与修复
完成检查
- 撤销后数据回到上一版本
- 恢复点能载入指定 revision
- 诊断 JSON 可下载
提示
- 恢复点只保留最近数份;重要节点前先保存 OPFS 工程。
限制 / 不支持
- 恢复点是浏览器存储,不替代本地备份;原生 autosave 是另一套入口。
1. 切换编辑器
每个区域右上角有编辑器选择器,可切换为 3D Viewport、Outliner、Properties、Spreadsheet、节点编辑器、Image Editor、Text Editor、Python Console、Timeline/Graph 等。
图 6.1 切换编辑器2. 分割与合并
打开区域 ⋮ → 水平/垂直分割;合并/停靠选择相邻方向;交换编辑器、复制区域、最大化/聚焦、关闭和重置布局也在同一菜单。首次操作会把当前工作区切换为自定义布局。
图 6.2 分割与合并3. 布局持久化
布局、编辑器覆盖和每视口相机锁定写入 OPFS settings/web-interface.json;刷新页面后恢复。选择“重置工作区布局”回到默认 CSS 布局。
图 6.3 布局持久化
完成检查
- 区域可切换编辑器
- 分割/合并后区域数量正确
- 刷新后布局保留
- 重置恢复默认
提示
- 区域头部的 ⋮ 与右上角浮动 ⋮ 打开同一个菜单。
限制 / 不支持
- 复制区域用拆分承载,不创建新浏览器窗口;暂无拖拽分隔条 resize。
本章目标
- 旋转/平移/缩放视口
- 选择对象与网格元素
- 切换相机视图并锁定
1. 导航
中键拖动旋转,Shift+中键平移,滚轮缩放;小键盘 1/3/7 切换轴视图,5 切换透视/正交,Home 显示全部,Numpad . 框显所选。
图 7.1 导航2. 选择与变换
左键选择对象,Ctrl/Shift 追加/范围选择;G/R/S 进入移动/旋转/缩放。编辑模式支持顶点/边/面选择(快捷栏 1/2/3)。
图 7.2 选择与变换3. 相机视图与锁定
按 Numpad0 或工具栏“相机视图”对齐场景相机;再次触发恢复上一视图。未锁定时 orbit 被拒绝,pan/zoom 只做取景;“锁定相机”(Camera to View)允许导航并把相机 pose 写回对象,Ctrl+Alt+Numpad0 对齐相机到当前视图。
图 7.3 相机视图与锁定
完成检查
- 轴视图与透视切换正常
- 编辑模式选择模式可切换
- Numpad0 进入/退出相机视图
- 锁定后导航改变相机并可撤销
限制 / 不支持
- 未实现 object-as-camera、自动关键帧/约束/父级 lock 分支。
本章目标
- 选择与展开层级
- 重命名/可见性
- 拖放建立父子或移动集合
1. 选择与层级
单击对象行选中;Ctrl 追加,Shift 范围选择;展开按钮或左右方向键展开/折叠,Home/End 与上下键导航。
图 8.1 选择与层级2. 重命名与可见性
双击名称或 F2 行内重命名;眼睛按钮切换可见性。链接库对象/数据不可重命名或 remap。
图 8.2 重命名与可见性3. 拖放与 Remap
对象拖到对象行建立父子(Shift 允许,Alt 保持变换);拖到集合移动/链接(Ctrl 链接);右键/Shift+F10 打开数据菜单执行 Rename/Remap Users。
图 8.3 拖放与 Remap
完成检查
- 选择与范围选择正确
- 重命名进入 Main
- 拖放后父子/集合关系正确
限制 / 不支持
- 原生 outliner 上下文不可用时使用简化树;搜索过滤只在简化树可用。
1. 属性分组
属性面板按 Object & Hierarchy、Modifier Stack、Material Slots、Camera/Light/World、Scene/Render、Physics、View Layer 等分组纵向排列;修改后写入 Main 并可撤销。
图 9.1 属性分组2. 对象/修改器/材质标签
左侧三个标签分别跳转到对象变换、Modifier Stack、Material Slots。标签会更新选中状态并滚动到目标段落。
图 9.2 对象/修改器/材质标签3. 编辑与只读状态
数值/下拉/按钮直接提交;链接对象、相机、集合和材质显示只读提示。相机属性要求单用户数据块。
图 9.3 编辑与只读状态
完成检查
- 标签能跳转并选中
- 修改属性后视口更新
- 只读链接数据不能编辑
提示
- F3 搜索属性名可快速定位命令,例如 Modifier/Decimate。
限制 / 不支持
- 不是完整 RNA 属性浏览器;部分场景/渲染字段以离散按钮呈现。
1. 创建对象
Modeling 快捷栏的 Add CUBE/PLANE/UV SPHERE/MONKEY 或菜单“添加”创建对象;也可 F3 使用原生 primitive 操作。
图 10.1 创建对象2. 复制、重命名、删除
Shift+D 复制,Alt+D 链接复制,F2 重命名,Delete 删除;删除与取消都可撤销。
图 10.2 复制、重命名、删除3. 父子与 Join
选中多个对象后 Parent/Unparent 设置或清除父级;Join 合并为一个对象。父级操作可保留或清除变换。
图 10.3 父子与 Join
完成检查
- 新对象出现在 Outliner
- 复制/删除后对象数正确
- Join 后活动对象网格包含其他对象
1. 进入编辑模式
Modeling 工作区点击模式按钮选择编辑模式;快捷栏切换 Vertex/Edge/Face,Select All 后执行 MERGE/DISSOLVE/EXTRUDE/INSET/BEVEL/LOOP_CUT/SUBDIVIDE 等。
图 11.1 进入编辑模式2. 常用操作
面模式可 TRIANGULATE/Recalculate Normals;边模式可 BRIDGE_LOOPS;操作失败时先确认选择模式与元素数量。
图 11.2 常用操作3. 雕刻范围
Sculpting 工作区属性面板提供 Draw/Inflate/Grab/Smooth、半径/强度/压力/对称、遮罩、面组和 Voxel Remesh;笔刷从属性面板应用到当前网格,不是连续笔触。
图 11.3 雕刻范围
完成检查
- 编辑模式可切换选择模式
- 拓扑操作后网格更新
- 雕刻参数/遮罩写入属性
提示
- 破坏性操作后可用撤销恢复;高面数操作注意存储/性能。
限制 / 不支持
- 无完整建模工具箱、框选/套索网格选择与连续雕刻笔触;高级操作依赖菜单/F3。
1. 添加修改器
Properties → Modifier Stack 输入修改器类型并 Add;列表显示名称、类型、参数和 V/R/E/C 可见性。
图 12.1 添加修改器2. 排序与参数
用 ↑/↓、Move to First/Last 调整求值顺序;编辑参数后视口更新。Decimate 提供 Collapse/Un-Subdivide/Dissolve Planar、比例/目标三角面与预览/应用。
图 12.2 排序与参数3. 应用、复制、移除
Apply 写入网格并移除修改器;可存为形态键、复制到选中、按名称移除;R 列控制渲染可见性。
图 12.3 应用、复制、移除
完成检查
- 修改器按顺序求值
- 参数变化视口更新
- Apply 后网格变化
提示
- Boolean 需要封闭网格;Mirror/Array 依赖原点与间距。
本章目标
- 创建非网格对象
- 编辑曲线/文本
- 导入 TTF/OTF/PFB
1. 创建非网格
添加菜单包含 Bezier/NURBS 曲线、曲面、文本、骨架、融球、体积、晶格、点云、毛发、Grease Pencil 与力场。
图 13.1 创建非网格2. 曲线/文本编辑
编辑模式下曲线菜单提供挤出、复制、循环、手柄类型、样条类型、分离、细分、平滑、反向等;文本属性可编辑正文与布局。
图 13.2 曲线/文本编辑3. 导入字体
文本属性 → Import TTF/OTF/PFB 选择本地字体(绝对路径任选);字体写入 OPFS 资源并打包进 Main,可设置 Regular/Bold/Italic 链接。
图 13.3 导入字体
完成检查
- 非网格对象出现在 Outliner
- 曲线控制点可编辑
- 字体导入后文本外观变化
提示
- 字体文件会进入当前工程资源;保存 OPFS 后重开仍可用。
限制 / 不支持
- 非网格数据的高级编辑受当前 Web 能力矩阵限制;部分操作仅原生/F3。
1. 进入可写 UV 区域
选中网格,切换到 UV Editing;桌面 Blender 要求 OB_MODE_EDIT,点击“编辑模式”进入。左侧 UV 编辑器显示原生 UV 选择。
图 14.1 进入可写 UV 区域2. 选择与展开
点击“全选 UV”,等待“UV 选择已提交”,再点“展开所选 UV”;可选择角度/共形/最小拉伸、边距、UDIM 目标与自定义区域。
图 14.2 选择与展开3. 打包、变换、缝合
“打包 UV 岛”设置间距;变换控件执行移动/旋转/缩放;缝合控件使用缝合模式/距离。保存 OPFS 后重开,UV 与选择仍保留。
图 14.3 打包、变换、缝合
完成检查
- UV 选择提交成功
- 展开/打包改变 UV 布局
- 保存重开后 UV 不变
限制 / 不支持
- 编辑依赖可写原生 UV 区域;无完整 UV sculpt/高级工具。
1. 选择材质
Shading 工作区上方选择材质;Properties → Material Slots 添加/分配材质。链接材质显示只读。
图 15.1 选择材质2. 节点画布
启用默认节点生成 Principled + Material Output;添加节点、拖拽节点、连接 socket、重命名、删除、编辑 socket 值和属性。支持 RGB/Value/Mix/Math/Mapping/坐标/UV/分离颜色/对象信息/图像/法线/凹凸/Principled/Output 14 类。
图 15.2 节点画布3. 图像与预览
Image Texture 选择 packed 图像或色彩空间;外部图片通过“外部贴图”入口导入 OPFS 后打包;右侧材质球显示预览,可保存缩略图。
图 15.3 图像与预览
完成检查
- 材质槽分配成功
- 节点连接后预览变化
- 图像节点使用正确贴图
提示
- Principled 的 Base Color/Roughness/Metallic 会直接影响 PBR 渲染。
限制 / 不支持
- 仅 14 类节点;未知节点会显示不支持并阻止图验证。
1. 选择资产源
Shading 左下 PBR 资产库可选择 pbr-library、re-pbr 或 HQ 源,按类型/目录/来源筛选,搜索资产名。
图 16.1 选择资产源2. 添加或分配
双击模型添加到场景,双击材质分配到当前材质槽;也可用“添加到场景”“分配到材质槽”。资产库元数据与预览存 OPFS/IndexedDB。
图 16.2 添加或分配3. packed 与修复
材质贴图以 packed 图像进入工程,Properties → Resources 显示 packed 资源;缺失时点“修复资产库”重建。库链接图像绘制前需在 Texture Paint “设为本地”。
图 16.3 packed 与修复
完成检查
- 资产卡可见/可筛选
- 双击材质改变材质槽
- packed 图在重开后仍存在
提示
- RE 5000PBR 有 6 张材质;HQ 源提供 2048 贴图。
限制 / 不支持
- 库链接对象/材质只读;仅图像有 Make Local 绘制路径。
1. 选择纹理图像
Texture Paint 顶部“纹理图像”只列出 packed 图像;没有图像时先在 Shading 分配带 Base Color 图的材质。
图 17.1 选择纹理图像2. 绘制笔画
选择绘制/擦除、颜色、大小、强度,在画布按住拖动;松开后显示“笔画已提交”,一次笔画一个 Main revision。
图 17.2 绘制笔画3. 本地化与恢复
库链接图像先选择“库链接图像”并点“设为本地”,再绘制;可撤销/重做笔画,保存 OPFS 后重开像素仍保留。
图 17.3 本地化与恢复
提示
- 图像越大 PNG 编码越慢;课程使用 1024×1024。
限制 / 不支持
- 仅二维 packed 图像;不做 UDIM/投影/4K 生产级绘制。
本章目标
- 添加/连线节点
- 提交 GN 图
- 检查 Spreadsheet 数据
1. 打开 GN 画布
选中网格,切换到 Geometry Nodes;画布显示当前图,检查器显示节点/socket 属性。
图 18.1 打开 GN 画布2. 添加与连线
选择 allowlist 节点(Group Input/Output、Transform、Set Position、Join/Separate Geometry、Realize Instances、Store Named Attribute、输入/比较/数学、Object/Collection/Image Info 等),拖拽端口连线,修改 socket 默认值。
图 18.2 添加与连线3. 提交与检查
点击“提交图”写入原生节点树;下方 Spreadsheet 切换对象/顶点/边/面/UV/属性,过滤/列/CSV。
图 18.3 提交与检查
完成检查
- 节点/连线/属性提交成功
- 几何随图更新
- Spreadsheet 行数据正确
限制 / 不支持
- 仅 16 类 allowlist 节点;无 Simulation Zone;Spreadsheet 只读当前网格缓冲。
1. 时间线
Animation 底部 Timeline 可跳到首/末帧、上一/下一帧、播放/暂停;当前帧输入框可直接跳转。
图 19.1 时间线2. 关键帧
选中对象,在目标帧点击 Loc/Rot/Scale 插入关键帧,Del Key 删除当前帧;Dope Sheet 显示关键点与当前帧。
图 19.2 关键帧3. Action 与插值
Action name/New Action/Remove Action/活动 Action 管理动画;F-Curve 插值可选 Constant/Linear/Bezier;Fake User 防止 Action 被清理。
图 19.3 Action 与插值
完成检查
- 关键帧出现在当前帧
- 播放推进帧号
- Action 切换生效
提示
- Web 播放是本地帧步进,不是原生动画求值/音频播放。
限制 / 不支持
- 无完整原生播放/音频;部分多通道编辑器只暴露首条曲线。
本章目标
- Graph 查看/拖动关键帧
- 插入/删除关键帧
- NLA/驱动器入口
1. Graph 曲线
Animation 工作区 Graph Editor 列出通道,显示曲线与关键点;勾选通道显隐,滚轮缩放,按钮框显全部。
图 20.1 Graph 曲线2. 编辑关键帧
点击关键点选中并拖动;插入/删除关键帧;插值选择 Bezier/Linear/Constant。拖动提交一条 F-Curve 命令。
图 20.2 编辑关键帧3. NLA 与驱动器
Timeline 的 NLA 区可选择 Track/Strip,编辑起止、重复、Blend In/Out、Extrapolation 并提交;驱动器表达式/关键帧编辑器在动画属性区。
图 20.3 NLA 与驱动器
完成检查
- Graph 曲线显示正确
- 拖动改变关键帧
- NLA 提交生效
提示
- Graph 是简化 SVG 编辑器;复杂曲线/驱动器使用原生/F3。
限制 / 不支持
- NLA 是表单式而非完整通道编辑器;驱动器变量/目标未完整暴露。
1. 物理工作台
Properties → Physics 选择 Rigid Body/Soft Body/Cloth/Fluid/Particle,编辑质量、摩擦、弹性、碰撞、缓存等参数。
图 21.1 物理工作台2. 点缓存
Point Cache 可 Bake All/Free Bake All;在 localOnly/native 路径可执行缓存操作,Web 路径受能力门控。
图 21.2 点缓存3. 模拟播放
物理求解依赖已校验的桌面/服务器实现;Web 本地播放未接通时状态会返回 PHYSICS_CACHE_PLAYBACK_UNAVAILABLE/PHYSICS_SOLVER_UNAVAILABLE。
图 21.3 模拟播放
完成检查
- 物理类型可切换
- 参数进入 Main
- 不支持时明确显示能力码
限制 / 不支持
- Web 本地模拟播放/求解未接通;仅参数编辑与缓存入口。
1. 相机
选中相机,Properties 编辑投影、焦距、near/far、全景/鱼眼与景深(焦点对象/距离/F-stop)。
图 22.1 相机2. 灯光与世界
灯光属性编辑类型、形状、diffuse/specular/transmission/volume 因子、衰减/阴影;世界属性编辑曝光、环境强度、AO 与探针分辨率。
图 22.2 灯光与世界3. 输出设置
Scene Render/Output 设置分辨率、百分比、帧范围、输出格式;色彩管理选择 display/view transform/look/exposure/gamma。
图 22.3 输出设置
完成检查
- 相机/灯光修改影响渲染
- 世界/色彩设置保存
- 分辨率与输出格式正确
限制 / 不支持
- 部分场景/渲染字段为离散按钮;完整 RNA 字段未全部暴露。
本章目标
- 执行一次 PBR 渲染
- 检查结果/OPFS
- 手动下载 PNG
1. 渲染参数
Rendering 的 PBR 面板设置视角预设、位移强度、视图(Final/Base Color/Normal/Roughness)、曝光、分辨率 256/512/1024/2048、相机 Viewport/Scene。
图 23.1 渲染参数2. 执行渲染
点击“渲染 PBR”,等待纹理/环境就绪并输出结果;结果显示尺寸、字节数和 OPFS hash。浏览器渲染器是 three.js WebGL2 physical-v1,不是 Cycles/EEVEE。
图 23.2 执行渲染3. 手动下载/原生渲染
点击“下载 PNG”保存本地 pbr-<width>.png;Rendering 页面还提供可选的“桌面 EEVEE 渲染”,需原生服务,产物链接需手动点击下载。
图 23.3 手动下载/原生渲染
完成检查
- 渲染结果尺寸符合设置
- 结果写入 OPFS
- PNG 仅在点击下载后保存
提示
- 深色材质先切 Base Color/Roughness 诊断,避免只凭整体亮度判断。
限制 / 不支持
- 浏览器 PBR 为简化渲染器;原生渲染依赖服务器/桌面服务。
第 24 章 · 进阶 · Compositing
Compositor:节点画布、执行与保存
创建 RGB/Exposure/Blur/Mix/Alpha Over/Transform/Viewer/Composite 节点,执行 CPU 合成并提交。
前置:第 23 章
1. 节点画布
Compositing 工作区画布默认包含 Composite;添加节点类型,拖拽端口连接,右侧检查器编辑属性/颜色/图像来源。
图 24.1 节点画布2. 执行合成
点击“执行合成”,CPU 求值器显示 Viewer 或 Composite 结果;RGB/Exposure/Invert/Blur/Mix/Alpha Over/Transform 等可用,IMAGE 使用 packed 图,Render Layer 使用最近 PBR 渲染。
图 24.2 执行合成3. 提交与限制
点击“提交图”写入原生 CompositorNodeTree;不支持的节点会阻止提交并显示“当前图含无法持久化的节点”。保存 OPFS 后重开保留节点/连线/属性/资源。
图 24.3 提交与限制
限制 / 不支持
- 9 类节点;WebGPU allowlist 4 类;Alpha Over factor 不持久化,MIX 仅 RGBA。
1. 导入模型/图像/字体
顶栏“打开 .blend”文件选择器接受 .blend、.gltf、.glb、.obj、.stl、.ply;材质图片、VFont 在对应属性面板导入;资源写入 OPFS。
图 25.1 导入模型/图像/字体2. 导出
顶栏“导出 GLB”生成 blender-web.glb;文件 → 导出提供 GLB/GLTF/FBX/OBJ/STL/PLY/USD/ALEMBIC 的原生面板(需服务);浏览器本地仅 GLB/OBJ 可用,其余显示“浏览器导出尚未移植”。
图 25.2 导出3. CSV/诊断
Spreadsheet“导出 CSV”导出当前过滤/可见列;帮助/顶栏导出诊断 JSON。所有下载均为显式手动动作。
图 25.3 CSV/诊断
完成检查
- 导入后对象数增加
- GLB/CSV 仅在点击导出后下载
- 不可用格式不被承诺
提示
- GLTF 外部 .bin/纹理不在单文件导入范围;优先使用 GLB。
限制 / 不支持
- USD/Alembic/FBX 当前依赖原生服务;浏览器本地导出仅部分格式。
本章目标
- 编辑/应用文本
- 运行 Python
- 查看 Info/诊断
1. Text Editor
Scripting 上方 Text Editor 选择/创建文本,打开 .py/.txt(≤1 MiB),编辑后必须 Apply 才写入 Main;可下载或运行原生 Python。
图 26.1 Text Editor2. Python Console
Web 模式使用原生会话面板连接/执行/撤销 Main/应用到场景;输出与命令历史可见。脚本受信任/权限/沙箱策略约束。
图 26.2 Python Console3. Info 与策略
Info 显示 Engine 状态与活动场景,不是完整 Blender 操作日志;敏感脚本需显式允许/恢复脚本策略。
图 26.3 Info 与策略
完成检查
- 文本 Apply 后执行
- 控制台执行结果可见
- 未 Apply 草稿阻止保存
提示
- 运行前保存 OPFS 工程;脚本可修改 Main。
限制 / 不支持
- Web 控制台依赖原生会话;Info 不是操作历史;脚本能力受策略/沙箱限制。
本章目标
- 修改并保存偏好
- 改键/冲突处理
- 控制快捷栏与启动工作区
1. 偏好分栏
编辑 → 偏好设置打开 Web 偏好窗口;界面/视口/动画/输入导航/键位/保存加载/文件/主题/系统分栏,支持项真实生效,不支持项显示“Web 不支持”和桌面来源。
图 27.1 偏好分栏2. 键位
键位页列出 17 个顶层动作;点“录制”按组合键,冲突会被拒绝并提示;保存后写入 OPFS,旧键位失效。
图 27.2 键位3. 快捷栏/启动工作区
界面页控制状态栏、快捷操作栏、区域切换器、启动工作区;保存偏好后刷新,快捷栏显隐与启动工作区生效。
图 27.3 快捷栏/启动工作区
完成检查
- 偏好刷新后保持
- 键位冲突被拒绝
- 快捷栏可隐藏
- 启动工作区生效
提示
- OPFS 是偏好权威存储,localStorage 只是镜像。
限制 / 不支持
- 主题/系统/完整键位配置未实现;部分视口/自动保存项标注不支持。
1. 先看状态栏
失败时查看 Engine 状态、存储状态和诊断计数;打开操作失败会显示读取/取消阶段,Worker 停止可点“重启并恢复”。
图 28.1 先看状态栏2. 恢复与备份
优先从最近项目/自动恢复点重开;损坏引用可移除。重要工程另存并定期手动下载 .blend;清除站点数据会删除 OPFS。
图 28.2 恢复与备份3. 能力边界
支持矩阵区分可用/部分/仅原生/不可用。明确限制包括:本地模拟求解、部分 IO 格式、完整主题/键位、UDIM/投影纹理、Compositor/Shader/GN 节点目录。不要把手册当桌面 parity 证书。
图 28.3 能力边界
完成检查
- 能从状态栏定位失败阶段
- 能恢复或导出诊断
- 限制与支持矩阵一致
提示
- 首次远端加载 154–193 秒属正常,等待进度完成再操作。
限制 / 不支持
- 本手册只验证 Chromium + RTX 4060;其他浏览器未验证。
附录 B:能力支持矩阵
可在当前 Web UI 完成;可用但有明确范围/限制;需要原生桌面/服务器会话;当前 Web 版不支持。
| 区域 | 功能 | 状态 | 说明 | 章节 |
|---|
| Layout | 3D 视口导航/选择/变换/相机视图 | 可在当前 Web UI 完成 | | ch07 |
| Layout | Outliner 选择/重命名/拖放/可见性 | 可在当前 Web UI 完成 | | ch08 |
| Layout | Properties 对象/修改器/材质/场景 | 可在当前 Web UI 完成 | | ch09 |
| Layout | Timeline 跳帧/关键帧 | 可在当前 Web UI 完成 | | ch19 |
| Modeling | 网格编辑/快捷拓扑操作 | 可用但有明确范围/限制 | 无完整建模工具箱/框选 | ch11 |
| Sculpting | Draw/Inflate/Grab/Smooth、遮罩/面组/Remesh 入口 | 可用但有明确范围/限制 | 笔刷从属性应用,非连续雕刻 | ch11 |
| UV Editing | 选择/变换/展开/打包/缝合 | 可用但有明确范围/限制 | 需要可写原生 UV 区域 | ch14 |
| Texture Paint | 2D packed 图像绘制/撤销/重做/Make Local | 可用但有明确范围/限制 | 不支持 UDIM/投影/4K 生产级 | ch17 |
| Shading | 材质/Principled/14 类 Shader 节点/预览 | 可用但有明确范围/限制 | 仅 allowlist 节点 | ch15 |
| Shading | PBR/RE 资产库/Append/Link/packed 图 | 可在当前 Web UI 完成 | | ch16 |
| Animation | Timeline/Dope Sheet/关键帧/Action | 可在当前 Web UI 完成 | | ch19 |
| Animation | Graph Editor/NLA/驱动器 | 可用但有明确范围/限制 | Graph 简化 SVG;NLA 表单 | ch20 |
| Animation | Web 播放/音频 | 可用但有明确范围/限制 | 本地帧步进,非原生求值 | ch19 |
| Rendering | PBR 渲染/诊断视图/PNG 手动下载 | 可在当前 Web UI 完成 | | ch23 |
| Rendering | 原生 EEVEE/Cycles 渲染 | 需要原生桌面/服务器会话 | 需要原生/服务器后端 | ch23 |
| Compositing | 9 类节点/连线/执行/Viewer/提交 | 可用但有明确范围/限制 | 节点目录受限;资源/属性有限制 | ch24 |
| Geometry Nodes | 16 类 allowlist 节点/连线/提交 | 可用但有明确范围/限制 | 无 Simulation Zone/任意节点 | ch18 |
| Geometry Nodes | Spreadsheet 对象/顶点/边/面/UV/属性/CSV | 可用但有明确范围/限制 | 只读、250k 行上限 | ch18 |
| Scripting | Text Editor/Python Console/Info | 可用但有明确范围/限制 | Web 控制台依赖原生会话 | ch26 |
| Files | 新建/打开/最近项目/恢复/撤销 | 可在当前 Web UI 完成 | | ch03 |
| Files | 保存到 OPFS/下载 .blend/另存为/副本 | 可在当前 Web UI 完成 | | ch04 |
| Files | 自动恢复点/诊断报告 | 可在当前 Web UI 完成 | | ch05 |
| IO | GLTF/GLB/OBJ/STL/PLY 导入 | 可用但有明确范围/限制 | GLTF 仅嵌入资源;OBJ 不含 MTL 文件夹流程 | ch25 |
| IO | 浏览器 GLB/OBJ 导出 | 可用但有明确范围/限制 | GLB 本地;OBJ 本地/原生 | ch25 |
| IO | USD/Alembic/FBX 导出 | 需要原生桌面/服务器会话 | 运行时 receipt 可能未注册 | ch25 |
| IO | 图像/VFont/URDF 导入 | 可在当前 Web UI 完成 | | ch25 |
| Settings | Preferences/Keymap/区域布局/相机锁定持久化 | 可在当前 Web UI 完成 | | ch27 |
| Settings | 主题/系统/Add-ons/完整键位 | 当前 Web 版不支持 | | ch27 |
| Simulation | 物理参数/缓存入口 | 可用但有明确范围/限制 | 本地播放/求解未接通 | ch21 |
| Sequencer | Strip 表单/原生媒体传输 | 可用但有明确范围/限制 | Web 最终导出依赖服务器;无本地媒体选择器 | ch25 |
| Camera | Numpad0/Camera to View/锁定持久化 | 可用但有明确范围/限制 | 无 object-as-camera/自动关键帧/约束分支 | ch07 |
附录 A:常用快捷键与 F3 命令
| Ctrl+S | 保存到浏览器 OPFS(不下载) |
| Ctrl+O | 打开 .blend |
| Ctrl+Z / Ctrl+Y | 撤销 / 重做 |
| F3 | 操作搜索 |
| F2 | 重命名活动项/Outliner 行 |
| G / R / S | 移动 / 旋转 / 缩放 |
| Shift+D / Alt+D | 复制 / 链接复制 |
| Numpad0 | 相机视图切换 |
| Ctrl+Alt+Numpad0 | 对齐相机到视图 |
| Home / Numpad . | 显示全部 / 框显所选 |
| Numpad 1/3/7, 5 | 轴视图 / 透视正交 |
附录 C:OPFS 与本地文件位置
| projects/<id>/scene.blend | 工程主文件(OPFS) |
| projects/<id>/snapshots/<revision>.blend | 恢复点快照 |
| projects/<id>/assets/sha256/... | 打包/内容资源 |
| settings/web-interface.json | 偏好、键位、布局、相机锁定 |
| 最近项目 | IndexedDB blender-web-metadata/setting/recent-projects:v1 |
| 手动下载 | 顶栏“下载 .blend”、PNG/GLB/CSV 导出 |
附录 D:术语与缩略语
| OPFS | Origin Private File System,浏览器私有文件系统 |
| SceneIR | WebEngine 输出的场景只读描述 |
| Main | 原生 Blender 主数据库,编辑与撤销的真实来源 |
| Packed 图像 | 数据打包在工程内的图像,可在纹理绘制中编辑 |
| Make Local | 把库链接图像复制为本地可编辑数据 |
| Camera to View | 锁定相机视图时导航会写回相机对象 |