feat(manual): add the illustrated Web Blender HTML user manual
A single-page 28-chapter manual generated from manual.json covers the 11 workspaces, all React editors, OPFS save/reopen, explicit local downloads, import/export routes, preferences/keymap and the capability matrix. It reuses verified course screenshots and adds 14 fresh Chromium captures for shell, storage, area, camera, preferences, IO and troubleshooting chapters. Manual-driven fixes: Save As now states OPFS-only, GLTF import is restored, quick toolbar honors its preference, startup workspace is applied, Properties tabs jump to sections, Outliner fallback search filters, and the editor-header ⋮ opens the area menu. Help and the tutorial landing link the new manual; the PDF remains as an archive. Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
mes123456
546
user-manual/WEB_Blender_Web_Manual_20261113/manual.json
Normal file
546
user-manual/WEB_Blender_Web_Manual_20261113/manual.json
Normal file
@@ -0,0 +1,546 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"id": "web-blender-manual",
|
||||
"locale": "zh-CN",
|
||||
"title": "Web Blender 用户手册",
|
||||
"version": "1.0.0",
|
||||
"lastVerified": "2026-11-13",
|
||||
"sourceCommit": "aa8cc1313",
|
||||
"desktopVersion": "Blender 5.2.0 LTS",
|
||||
"intro": "本手册对标当前 Web Blender（?ui=web）的实际功能，按真实界面和真实操作步骤编写。工程保存、重开和恢复使用浏览器 OPFS；需要本地文件时使用独立的“下载”动作。手册不宣称完整桌面 Blender parity，未实现项在支持矩阵和限制章节中如实列出。",
|
||||
"storagePolicy": {
|
||||
"platformSave": "OPFS",
|
||||
"rules": [
|
||||
"顶栏“保存项目”、Ctrl+S、文件 → 保存到浏览器 OPFS、另存为、自动恢复点只写浏览器存储。",
|
||||
"需要本地 .blend 时，手动使用顶栏“下载 .blend”或文件 → 下载 .blend 到本地。",
|
||||
"PNG、GLB、CSV、诊断报告等下载都是独立的手动动作。",
|
||||
"清除站点数据会删除 OPFS 工程、最近项目索引和偏好设置。"
|
||||
]
|
||||
},
|
||||
"parts": [
|
||||
{ "id": "part-a", "title": "A 入门与数据", "chapterIds": ["ch01", "ch02", "ch03", "ch04", "ch05"] },
|
||||
{ "id": "part-b", "title": "B 布局与建模", "chapterIds": ["ch06", "ch07", "ch08", "ch09", "ch10", "ch11", "ch12"] },
|
||||
{ "id": "part-c", "title": "C 曲线、UV、材质与纹理", "chapterIds": ["ch13", "ch14", "ch15", "ch16", "ch17"] },
|
||||
{ "id": "part-d", "title": "D 程序化、动画与模拟", "chapterIds": ["ch18", "ch19", "ch20", "ch21"] },
|
||||
{ "id": "part-e", "title": "E 渲染、合成与交换", "chapterIds": ["ch22", "ch23", "ch24", "ch25"] },
|
||||
{ "id": "part-f", "title": "F 脚本、设置与运维", "chapterIds": ["ch26", "ch27", "ch28"] }
|
||||
],
|
||||
"chapters": [
|
||||
{
|
||||
"id": "ch01", "number": 1, "part": "part-a", "title": "快速开始：首次加载、打开工程与第一次保存", "level": "入门",
|
||||
"workspace": "Layout", "workspaces": ["Layout"],
|
||||
"summary": "从浏览器打开 Web Blender，等待 WASM 就绪，载入练习工程并把工程保存到 OPFS。",
|
||||
"objectives": ["识别 WASM 首次加载状态", "打开 .blend 并确认 SceneIR", "完成一次 OPFS 保存"],
|
||||
"prerequisites": [],
|
||||
"desktopReference": "File > Open / Save",
|
||||
"steps": [
|
||||
{ "title": "打开 Web 界面", "text": "在 Chromium 访问 /?ui=web，等待底栏显示 WASM 就绪与 Engine: SceneIR。远端首次加载需要下载约 79 MB wasm，页面会显示进度。", "image": "/tutorial/full/steps/M01-interface.jpg", "alt": "Web Blender 顶栏、工作区标签、视口、大纲与属性面板" },
|
||||
{ "title": "载入练习工程", "text": "点击顶栏“打开 .blend”，选择课程工程 studio.blend（绝对路径：/home/mes123456/workinf_Blender_Wasm/web/app/public/tutorial/pbr/studio.blend），等待对象数变为 6。", "image": "/tutorial/full/steps/M01-file-menu.jpg", "alt": "文件菜单与打开 .blend 入口" },
|
||||
{ "title": "保存到 OPFS", "text": "点击顶栏“保存项目”。状态栏显示 SUCCEEDED 后，工程已写入浏览器 OPFS；此动作不会下载文件。", "image": "/manuals/images/ch01-first-save.jpg", "alt": "保存项目按钮与保存成功状态" }
|
||||
],
|
||||
"checks": ["底栏 Engine 显示 SceneIR", "对象数与工程文件一致", "保存状态为 SUCCEEDED"],
|
||||
"tips": ["用 F3 搜索“打开”“保存到浏览器 OPFS”也可以执行同一入口。"],
|
||||
"limits": ["本地文件不会自动出现；需要时使用“下载 .blend”。"],
|
||||
"links": [{ "label": "全站课程 M01", "href": "/tutorial/full/index.html#M01" }]
|
||||
},
|
||||
{
|
||||
"id": "ch02", "number": 2, "part": "part-a", "title": "界面总览：工作区、编辑器、状态栏与命令搜索", "level": "入门",
|
||||
"workspace": "Layout", "workspaces": ["Layout", "Modeling", "Sculpting", "UV Editing", "Texture Paint", "Shading", "Animation", "Rendering", "Compositing", "Geometry Nodes", "Scripting"],
|
||||
"summary": "认识 11 个工作区、区域、状态栏和 F3 操作搜索，知道在哪里找命令与反馈。",
|
||||
"objectives": ["切换工作区", "识别状态栏反馈", "用 F3 搜索并执行命令"],
|
||||
"prerequisites": ["ch01"],
|
||||
"desktopReference": "Workspaces / F3 Search",
|
||||
"steps": [
|
||||
{ "title": "认识工作区", "text": "顶部工作区标签包括 Layout、Modeling、Sculpting、UV Editing、Texture Paint、Shading、Animation、Rendering、Compositing、Geometry Nodes、Scripting；每个工作区有固定的默认区域布局。", "image": "/tutorial/full/steps/M01-interface.jpg", "alt": "顶部工作区标签与整体界面" },
|
||||
{ "title": "使用状态栏", "text": "底栏显示活动对象、对象/顶点/面数量、WASM 与 Engine 状态、存储预算和版本；操作失败时先看 Engine 状态。", "image": "/manuals/images/ch01-first-save.jpg", "alt": "底部状态栏和保存状态" },
|
||||
{ "title": "F3 命令搜索", "text": "按 F3，输入命令名（如“移动”“Export GLB”），选择带执行位置标签的条目。原生命令可能显示 DESKTOP/SERVER_NATIVE；浏览器等价命令显示 BROWSER。", "image": "/tutorial/full/steps/M02-operator-search.jpg", "alt": "F3 操作搜索面板与命令结果" }
|
||||
],
|
||||
"checks": ["11 个工作区标签齐全", "F3 能搜索到命令", "状态栏能看到 Engine/存储状态"],
|
||||
"tips": ["F3 搜索是找隐藏入口的首选，不必先猜菜单位置。"],
|
||||
"limits": ["灰色菜单项或带 unavailable 标记的命令尚未实现等价入口。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch03", "number": 3, "part": "part-a", "title": "文件与工程：新建、打开、最近项目、另存为与保存副本", "level": "入门",
|
||||
"workspace": "Layout", "workspaces": ["Layout"],
|
||||
"summary": "掌握当前 Web 版的工程文件入口，理解另存为写 OPFS、保存副本才下载本地副本。",
|
||||
"objectives": ["新建/打开工程", "使用最近项目", "区分另存为与保存副本"],
|
||||
"prerequisites": ["ch01"],
|
||||
"desktopReference": "File > New/Open/Save As/Save Copy",
|
||||
"steps": [
|
||||
{ "title": "新建与打开", "text": "文件 → 新建 → 常规创建默认场景；文件 → 打开或顶栏“打开 .blend”载入工程。打开期间状态栏显示读取进度，可取消。", "image": "/tutorial/full/steps/M01-file-menu.jpg", "alt": "文件菜单中的新建与打开入口" },
|
||||
{ "title": "最近项目", "text": "顶栏“最近项目”下拉或文件 → 最近打开列出显式保存过的工程；条目损坏时会提示“项目内容缺失/校验失败”，可移除引用。", "image": "/manuals/images/ch03-recent.jpg", "alt": "最近项目菜单与工程条目" },
|
||||
{ "title": "另存为与保存副本", "text": "另存为在 OPFS 创建并切换到新工程，不下载；保存副本下载本地 .blend，且不改变当前工程。需要本地工程时也可用顶栏“下载 .blend”。", "image": "/manuals/images/ch01-first-save.jpg", "alt": "顶栏保存与下载入口" }
|
||||
],
|
||||
"checks": ["最近项目能重开已保存工程", "另存为后工程名/项目切换", "保存副本产生下载文件"],
|
||||
"tips": ["同名 .blend 会映射到同一个 OPFS 项目；需要隔离时使用另存为。"],
|
||||
"limits": ["“另存为会下载”是过时说明；当前只写 OPFS。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch04", "number": 4, "part": "part-a", "title": "浏览器存储：OPFS 保存、重开与手动本地下载", "level": "入门",
|
||||
"workspace": "Layout", "workspaces": ["Layout"],
|
||||
"summary": "理解 OPFS 工程布局、最近项目索引、恢复点与手动下载的边界。",
|
||||
"objectives": ["说明 OPFS/IndexedDB 分工", "保存并重开工程", "手动下载 .blend"],
|
||||
"prerequisites": ["ch01", "ch03"],
|
||||
"desktopReference": "File > Save / Save As",
|
||||
"steps": [
|
||||
{ "title": "保存到 OPFS", "text": "保存项目写入 projects/<projectId>/scene.blend 及元数据；快照、资源与恢复点也在同一项目目录下。工程不会出现在浏览器下载目录。", "image": "/tutorial/full/steps/M14-opfs-save.jpg", "alt": "保存到 OPFS 后的状态栏反馈" },
|
||||
{ "title": "刷新并重开", "text": "刷新页面后，在最近项目中选择刚保存的工程；若询问是否保存当前修改，选择“不保存，继续”。对象、材质、UV/节点等 Main 数据应恢复。", "image": "/tutorial/full/steps/M14-reopen.jpg", "alt": "刷新后从最近项目重开工程" },
|
||||
{ "title": "手动下载 .blend", "text": "顶栏“下载 .blend”或文件 → 下载 .blend 到本地会先把工程提交到 OPFS，再下载 <工程名>.blend。外部未打包资源不会自动包含。", "image": "/manuals/images/ch01-first-save.jpg", "alt": "手动下载 .blend 的顶栏入口" }
|
||||
],
|
||||
"checks": ["重开后对象数一致", "本地下载只在手动动作后出现", "状态栏显示 OPFS 保存成功"],
|
||||
"tips": ["课程与测试的重开流程都使用最近项目/OPFS，不依赖自动下载。"],
|
||||
"limits": ["清除站点数据会删除 OPFS 工程与最近项目索引；本地 .blend 是持久备份。"],
|
||||
"links": [{ "label": "存储与恢复课程 M14", "href": "/tutorial/full/index.html#M14" }]
|
||||
},
|
||||
{
|
||||
"id": "ch05", "number": 5, "part": "part-a", "title": "撤销、自动恢复点、恢复与诊断", "level": "入门",
|
||||
"workspace": "Layout", "workspaces": ["Layout"],
|
||||
"summary": "使用撤销/重做、浏览器自动恢复点、最近项目修复和诊断报告处理错误。",
|
||||
"objectives": ["撤销/重做 Main 编辑", "恢复自动恢复点", "导出诊断报告"],
|
||||
"prerequisites": ["ch04"],
|
||||
"desktopReference": "Edit > Undo / File > Recover Auto Save",
|
||||
"steps": [
|
||||
{ "title": "撤销与重做", "text": "编辑 → 撤销/重做，或 Ctrl+Z/Ctrl+Y；撤销历史列出可回退的 Main 版本。工作区切换不会产生 Main 撤销步。", "image": "/manuals/images/ch05-recovery.jpg", "alt": "自动恢复点对话框" },
|
||||
{ "title": "恢复自动恢复点", "text": "文件 → 恢复 → 恢复浏览器恢复点，选择项目和恢复点后点“恢复选中版本”。自动恢复点不标记工程已保存，也不更新最近项目。", "image": "/manuals/images/ch05-recovery.jpg", "alt": "选择项目和恢复点的恢复对话框" },
|
||||
{ "title": "诊断与修复", "text": "最近项目损坏时可按条目移除引用；失败操作可点击顶栏“!”或帮助 → 导出诊断报告，生成 blender-web-diagnostics.json。", "image": "/manuals/images/ch05-recovery.jpg", "alt": "恢复与诊断入口所在对话框" }
|
||||
],
|
||||
"checks": ["撤销后数据回到上一版本", "恢复点能载入指定 revision", "诊断 JSON 可下载"],
|
||||
"tips": ["恢复点只保留最近数份；重要节点前先保存 OPFS 工程。"],
|
||||
"limits": ["恢复点是浏览器存储，不替代本地备份；原生 autosave 是另一套入口。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch06", "number": 6, "part": "part-b", "title": "工作区与 Area 布局：切换、⋮ 菜单、分割与持久化", "level": "入门",
|
||||
"workspace": "Layout", "workspaces": ["Layout", "Modeling", "Rendering", "Geometry Nodes"],
|
||||
"summary": "用区域右上角选择器切换编辑器，用 ⋮ 菜单分割/合并/交换/最大化区域，并保存布局。",
|
||||
"objectives": ["切换区域编辑器", "分割和合并区域", "重开后恢复布局"],
|
||||
"prerequisites": ["ch02"],
|
||||
"desktopReference": "Area > Split/Join/Swap, editor type menu",
|
||||
"steps": [
|
||||
{ "title": "切换编辑器", "text": "每个区域右上角有编辑器选择器，可切换为 3D Viewport、Outliner、Properties、Spreadsheet、节点编辑器、Image Editor、Text Editor、Python Console、Timeline/Graph 等。", "image": "/manuals/images/ch06-area-menu.jpg", "alt": "区域右上角编辑器选择器与 ⋮ 菜单" },
|
||||
{ "title": "分割与合并", "text": "打开区域 ⋮ → 水平/垂直分割；合并/停靠选择相邻方向；交换编辑器、复制区域、最大化/聚焦、关闭和重置布局也在同一菜单。首次操作会把当前工作区切换为自定义布局。", "image": "/manuals/images/ch06-area-split.jpg", "alt": "分割后的双属性区域与区域菜单" },
|
||||
{ "title": "布局持久化", "text": "布局、编辑器覆盖和每视口相机锁定写入 OPFS settings/web-interface.json；刷新页面后恢复。选择“重置工作区布局”回到默认 CSS 布局。", "image": "/manuals/images/ch06-area-split.jpg", "alt": "自定义区域布局" }
|
||||
],
|
||||
"checks": ["区域可切换编辑器", "分割/合并后区域数量正确", "刷新后布局保留", "重置恢复默认"],
|
||||
"tips": ["区域头部的 ⋮ 与右上角浮动 ⋮ 打开同一个菜单。"],
|
||||
"limits": ["复制区域用拆分承载，不创建新浏览器窗口；暂无拖拽分隔条 resize。"],
|
||||
"links": [{ "label": "区域布局测试路径", "href": "/tutorial/full/index.html" }]
|
||||
},
|
||||
{
|
||||
"id": "ch07", "number": 7, "part": "part-b", "title": "3D 视口：导航、选择、变换与相机视图", "level": "基础",
|
||||
"workspace": "Layout", "workspaces": ["Layout", "Modeling", "Animation"],
|
||||
"summary": "使用鼠标与键盘导航视口，选择对象/网格元素，执行变换并进入相机视图或锁定相机。",
|
||||
"objectives": ["旋转/平移/缩放视口", "选择对象与网格元素", "切换相机视图并锁定"],
|
||||
"prerequisites": ["ch06"],
|
||||
"desktopReference": "View3D navigation, Numpad0 Camera View, lock_camera",
|
||||
"steps": [
|
||||
{ "title": "导航", "text": "中键拖动旋转，Shift+中键平移，滚轮缩放；小键盘 1/3/7 切换轴视图，5 切换透视/正交，Home 显示全部，Numpad . 框显所选。", "image": "/tutorial/full/steps/M02-layout.jpg", "alt": "Layout 工作区 3D 视口与导航工具栏" },
|
||||
{ "title": "选择与变换", "text": "左键选择对象，Ctrl/Shift 追加/范围选择；G/R/S 进入移动/旋转/缩放。编辑模式支持顶点/边/面选择（快捷栏 1/2/3）。", "image": "/tutorial/full/steps/M03-mesh-selection.jpg", "alt": "编辑模式网格元素选择" },
|
||||
{ "title": "相机视图与锁定", "text": "按 Numpad0 或工具栏“相机视图”对齐场景相机；再次触发恢复上一视图。未锁定时 orbit 被拒绝，pan/zoom 只做取景；“锁定相机”（Camera to View）允许导航并把相机 pose 写回对象，Ctrl+Alt+Numpad0 对齐相机到当前视图。", "image": "/manuals/images/ch07-camera-view.jpg", "alt": "相机视图按钮与锁定按钮状态" }
|
||||
],
|
||||
"checks": ["轴视图与透视切换正常", "编辑模式选择模式可切换", "Numpad0 进入/退出相机视图", "锁定后导航改变相机并可撤销"],
|
||||
"tips": ["相机锁定按视口保存，刷新后保留。"],
|
||||
"limits": ["未实现 object-as-camera、自动关键帧/约束/父级 lock 分支。"],
|
||||
"links": [{ "label": "相机视图测试", "href": "/tutorial/full/index.html" }]
|
||||
},
|
||||
{
|
||||
"id": "ch08", "number": 8, "part": "part-b", "title": "Outliner：层级、选择、可见性、重命名与拖放", "level": "基础",
|
||||
"workspace": "Layout", "workspaces": ["Layout", "Scripting"],
|
||||
"summary": "在大纲视图中选择对象、展开层级、切换可见性、重命名、remap 数据和拖放父子/集合。",
|
||||
"objectives": ["选择与展开层级", "重命名/可见性", "拖放建立父子或移动集合"],
|
||||
"prerequisites": ["ch07"],
|
||||
"desktopReference": "Outliner select/parent/collection drop, remap",
|
||||
"steps": [
|
||||
{ "title": "选择与层级", "text": "单击对象行选中；Ctrl 追加，Shift 范围选择；展开按钮或左右方向键展开/折叠，Home/End 与上下键导航。", "image": "/tutorial/full/steps/M02-selection.jpg", "alt": "大纲视图对象选择与层级" },
|
||||
{ "title": "重命名与可见性", "text": "双击名称或 F2 行内重命名；眼睛按钮切换可见性。链接库对象/数据不可重命名或 remap。", "image": "/manuals/images/ch08-outliner.jpg", "alt": "大纲视图对象行、可见性与重命名" },
|
||||
{ "title": "拖放与 Remap", "text": "对象拖到对象行建立父子（Shift 允许，Alt 保持变换）；拖到集合移动/链接（Ctrl 链接）；右键/Shift+F10 打开数据菜单执行 Rename/Remap Users。", "image": "/manuals/images/ch08-outliner.jpg", "alt": "大纲视图拖放与数据菜单入口" }
|
||||
],
|
||||
"checks": ["选择与范围选择正确", "重命名进入 Main", "拖放后父子/集合关系正确"],
|
||||
"tips": ["大纲头部提供全选/清除/反选/切换与刷新。"],
|
||||
"limits": ["原生 outliner 上下文不可用时使用简化树；搜索过滤只在简化树可用。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch09", "number": 9, "part": "part-b", "title": "Properties：对象、修改器、材质与场景属性", "level": "基础",
|
||||
"workspace": "Layout", "workspaces": ["Layout", "Modeling", "Rendering"],
|
||||
"summary": "使用右侧属性面板查看和编辑变换、层级、修改器、材质、相机、灯光、世界、渲染和物理设置。",
|
||||
"objectives": ["找到属性分组", "用标签跳转", "编辑并提交属性"],
|
||||
"prerequisites": ["ch07", "ch08"],
|
||||
"desktopReference": "Properties editor",
|
||||
"steps": [
|
||||
{ "title": "属性分组", "text": "属性面板按 Object & Hierarchy、Modifier Stack、Material Slots、Camera/Light/World、Scene/Render、Physics、View Layer 等分组纵向排列；修改后写入 Main 并可撤销。", "image": "/tutorial/full/steps/M04-properties.jpg", "alt": "属性面板中的变换与对象分组" },
|
||||
{ "title": "对象/修改器/材质标签", "text": "左侧三个标签分别跳转到对象变换、Modifier Stack、Material Slots。标签会更新选中状态并滚动到目标段落。", "image": "/manuals/images/ch09-properties-tabs.jpg", "alt": "属性面板三个跳转标签与修改器段落" },
|
||||
{ "title": "编辑与只读状态", "text": "数值/下拉/按钮直接提交；链接对象、相机、集合和材质显示只读提示。相机属性要求单用户数据块。", "image": "/tutorial/full/steps/M04-modifier-stack.jpg", "alt": "修改器栈与参数编辑" }
|
||||
],
|
||||
"checks": ["标签能跳转并选中", "修改属性后视口更新", "只读链接数据不能编辑"],
|
||||
"tips": ["F3 搜索属性名可快速定位命令，例如 Modifier/Decimate。"],
|
||||
"limits": ["不是完整 RNA 属性浏览器；部分场景/渲染字段以离散按钮呈现。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch10", "number": 10, "part": "part-b", "title": "对象模式：创建、复制、重命名、父子与 Join", "level": "基础",
|
||||
"workspace": "Modeling", "workspaces": ["Layout", "Modeling"],
|
||||
"summary": "创建基础体、复制/链接复制、重命名、删除、父子关系和 Join 合并。",
|
||||
"objectives": ["创建对象", "复制与清理", "建立父子/Join"],
|
||||
"prerequisites": ["ch07"],
|
||||
"desktopReference": "Object mode operators",
|
||||
"steps": [
|
||||
{ "title": "创建对象", "text": "Modeling 快捷栏的 Add CUBE/PLANE/UV SPHERE/MONKEY 或菜单“添加”创建对象；也可 F3 使用原生 primitive 操作。", "image": "/tutorial/full/steps/M03-workspace.jpg", "alt": "Modeling 工作区与对象添加快捷栏" },
|
||||
{ "title": "复制、重命名、删除", "text": "Shift+D 复制，Alt+D 链接复制，F2 重命名，Delete 删除；删除与取消都可撤销。", "image": "/tutorial/full/steps/M03-workspace.jpg", "alt": "对象模式快捷工具" },
|
||||
{ "title": "父子与 Join", "text": "选中多个对象后 Parent/Unparent 设置或清除父级；Join 合并为一个对象。父级操作可保留或清除变换。", "image": "/tutorial/full/steps/M03-workspace.jpg", "alt": "对象模式下的父级与合并按钮" }
|
||||
],
|
||||
"checks": ["新对象出现在 Outliner", "复制/删除后对象数正确", "Join 后活动对象网格包含其他对象"],
|
||||
"tips": ["活动对象决定 Join 后的名称和数据。"],
|
||||
"limits": ["部分高级对象/集合操作仅在菜单或 F3 中提供。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch11", "number": 11, "part": "part-b", "title": "网格编辑与雕刻范围", "level": "基础",
|
||||
"workspace": "Modeling", "workspaces": ["Modeling", "Sculpting"],
|
||||
"summary": "进入编辑模式执行选择/挤出/倒角/环切/细分，并在雕刻模式使用有限的笔刷与重构。",
|
||||
"objectives": ["进入编辑模式", "执行常用拓扑操作", "使用雕刻笔刷/面组"],
|
||||
"prerequisites": ["ch10"],
|
||||
"desktopReference": "Mesh edit operators, sculpt brushes",
|
||||
"steps": [
|
||||
{ "title": "进入编辑模式", "text": "Modeling 工作区点击模式按钮选择编辑模式；快捷栏切换 Vertex/Edge/Face，Select All 后执行 MERGE/DISSOLVE/EXTRUDE/INSET/BEVEL/LOOP_CUT/SUBDIVIDE 等。", "image": "/tutorial/full/steps/M03-edit-mode.jpg", "alt": "编辑模式下的网格与元素选择" },
|
||||
{ "title": "常用操作", "text": "面模式可 TRIANGULATE/Recalculate Normals；边模式可 BRIDGE_LOOPS；操作失败时先确认选择模式与元素数量。", "image": "/tutorial/full/steps/M03-mesh-selection.jpg", "alt": "网格元素全选与拓扑操作按钮" },
|
||||
{ "title": "雕刻范围", "text": "Sculpting 工作区属性面板提供 Draw/Inflate/Grab/Smooth、半径/强度/压力/对称、遮罩、面组和 Voxel Remesh；笔刷从属性面板应用到当前网格，不是连续笔触。", "image": "/tutorial/full/steps/M04-properties.jpg", "alt": "属性面板中的雕刻与网格设置" }
|
||||
],
|
||||
"checks": ["编辑模式可切换选择模式", "拓扑操作后网格更新", "雕刻参数/遮罩写入属性"],
|
||||
"tips": ["破坏性操作后可用撤销恢复；高面数操作注意存储/性能。"],
|
||||
"limits": ["无完整建模工具箱、框选/套索网格选择与连续雕刻笔触；高级操作依赖菜单/F3。"],
|
||||
"links": [{ "label": "建模课程 M03", "href": "/tutorial/full/index.html#M03" }]
|
||||
},
|
||||
{
|
||||
"id": "ch12", "number": 12, "part": "part-b", "title": "修改器栈：添加、排序、参数、可见性与应用", "level": "基础",
|
||||
"workspace": "Modeling", "workspaces": ["Modeling", "Layout"],
|
||||
"summary": "在 Modifier Stack 中添加 Bevel/Boolean/Mirror/Array 等修改器并管理堆栈。",
|
||||
"objectives": ["添加修改器", "调整参数/顺序", "应用或移除"],
|
||||
"prerequisites": ["ch09"],
|
||||
"desktopReference": "Modifier stack",
|
||||
"steps": [
|
||||
{ "title": "添加修改器", "text": "Properties → Modifier Stack 输入修改器类型并 Add；列表显示名称、类型、参数和 V/R/E/C 可见性。", "image": "/tutorial/full/steps/M04-modifier-stack.jpg", "alt": "Modifier Stack 与修改器参数" },
|
||||
{ "title": "排序与参数", "text": "用 ↑/↓、Move to First/Last 调整求值顺序；编辑参数后视口更新。Decimate 提供 Collapse/Un-Subdivide/Dissolve Planar、比例/目标三角面与预览/应用。", "image": "/tutorial/full/steps/M04-modifier-stack.jpg", "alt": "修改器排序和 Decimate 参数" },
|
||||
{ "title": "应用、复制、移除", "text": "Apply 写入网格并移除修改器；可存为形态键、复制到选中、按名称移除；R 列控制渲染可见性。", "image": "/tutorial/full/steps/M04-properties.jpg", "alt": "属性面板中的修改器与对象设置" }
|
||||
],
|
||||
"checks": ["修改器按顺序求值", "参数变化视口更新", "Apply 后网格变化"],
|
||||
"tips": ["Boolean 需要封闭网格；Mirror/Array 依赖原点与间距。"],
|
||||
"limits": ["仅支持已接线的修改器类型；参数以类型元数据生成。"],
|
||||
"links": [{ "label": "修改器课程 M04", "href": "/tutorial/full/index.html#M04" }]
|
||||
},
|
||||
{
|
||||
"id": "ch13", "number": 13, "part": "part-c", "title": "非网格对象：曲线、曲面、文本、字体、融球与 Grease Pencil", "level": "基础",
|
||||
"workspace": "Modeling", "workspaces": ["Modeling", "Layout"],
|
||||
"summary": "从添加菜单创建曲线/文本/融球/Grease Pencil，编辑控制点或文本，导入本地字体。",
|
||||
"objectives": ["创建非网格对象", "编辑曲线/文本", "导入 TTF/OTF/PFB"],
|
||||
"prerequisites": ["ch10"],
|
||||
"desktopReference": "Curve/Text/Font/Grease Pencil",
|
||||
"steps": [
|
||||
{ "title": "创建非网格", "text": "添加菜单包含 Bezier/NURBS 曲线、曲面、文本、骨架、融球、体积、晶格、点云、毛发、Grease Pencil 与力场。", "image": "/tutorial/full/steps/M03-workspace.jpg", "alt": "Modeling 工作区与添加入口" },
|
||||
{ "title": "曲线/文本编辑", "text": "编辑模式下曲线菜单提供挤出、复制、循环、手柄类型、样条类型、分离、细分、平滑、反向等；文本属性可编辑正文与布局。", "image": "/tutorial/full/steps/M03-edit-mode.jpg", "alt": "编辑模式与对象编辑界面" },
|
||||
{ "title": "导入字体", "text": "文本属性 → Import TTF/OTF/PFB 选择本地字体（绝对路径任选）；字体写入 OPFS 资源并打包进 Main，可设置 Regular/Bold/Italic 链接。", "image": "/tutorial/full/steps/M04-properties.jpg", "alt": "属性面板中的字体/数据设置" }
|
||||
],
|
||||
"checks": ["非网格对象出现在 Outliner", "曲线控制点可编辑", "字体导入后文本外观变化"],
|
||||
"tips": ["字体文件会进入当前工程资源；保存 OPFS 后重开仍可用。"],
|
||||
"limits": ["非网格数据的高级编辑受当前 Web 能力矩阵限制；部分操作仅原生/F3。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch14", "number": 14, "part": "part-c", "title": "UV 编辑：选择、展开、打包、变换与缝合", "level": "进阶",
|
||||
"workspace": "UV Editing", "workspaces": ["UV Editing"],
|
||||
"summary": "进入可写 UV 区域，全选/变换/展开/打包/缝合 UV，并保存重开。",
|
||||
"objectives": ["进入 UV 编辑", "展开并打包", "保存重开 UV"],
|
||||
"prerequisites": ["ch11"],
|
||||
"desktopReference": "UV Editor, unwrap/pack/stitch",
|
||||
"steps": [
|
||||
{ "title": "进入可写 UV 区域", "text": "选中网格，切换到 UV Editing；桌面 Blender 要求 OB_MODE_EDIT，点击“编辑模式”进入。左侧 UV 编辑器显示原生 UV 选择。", "image": "/tutorial/full/steps/M06-uv-workspace.jpg", "alt": "UV Editing 工作区与原生 UV 编辑器" },
|
||||
{ "title": "选择与展开", "text": "点击“全选 UV”，等待“UV 选择已提交”，再点“展开所选 UV”；可选择角度/共形/最小拉伸、边距、UDIM 目标与自定义区域。", "image": "/tutorial/full/steps/M06-unwrap.jpg", "alt": "展开后的 UV 岛与选择状态" },
|
||||
{ "title": "打包、变换、缝合", "text": "“打包 UV 岛”设置间距；变换控件执行移动/旋转/缩放；缝合控件使用缝合模式/距离。保存 OPFS 后重开，UV 与选择仍保留。", "image": "/tutorial/full/steps/M06-unwrap.jpg", "alt": "UV 展开结果与控件" }
|
||||
],
|
||||
"checks": ["UV 选择提交成功", "展开/打包改变 UV 布局", "保存重开后 UV 不变"],
|
||||
"tips": ["展开前标记缝合线可得到更整齐的 UV 岛。"],
|
||||
"limits": ["编辑依赖可写原生 UV 区域；无完整 UV sculpt/高级工具。"],
|
||||
"links": [{ "label": "UV 课程 M06", "href": "/tutorial/full/index.html#M06" }]
|
||||
},
|
||||
{
|
||||
"id": "ch15", "number": 15, "part": "part-c", "title": "材质与 Shader Editor：Principled、图像与预览", "level": "进阶",
|
||||
"workspace": "Shading", "workspaces": ["Shading"],
|
||||
"summary": "创建/分配材质，在节点画布编辑 Principled 与图像节点，预览并打包外部贴图。",
|
||||
"objectives": ["分配材质", "编辑节点/连接", "设置图像节点"],
|
||||
"prerequisites": ["ch09"],
|
||||
"desktopReference": "Principled BSDF, Image Texture, Material Preview",
|
||||
"steps": [
|
||||
{ "title": "选择材质", "text": "Shading 工作区上方选择材质；Properties → Material Slots 添加/分配材质。链接材质显示只读。", "image": "/tutorial/full/steps/M05-shader-workspace.jpg", "alt": "Shading 工作区、材质槽与节点编辑器" },
|
||||
{ "title": "节点画布", "text": "启用默认节点生成 Principled + Material Output；添加节点、拖拽节点、连接 socket、重命名、删除、编辑 socket 值和属性。支持 RGB/Value/Mix/Math/Mapping/坐标/UV/分离颜色/对象信息/图像/法线/凹凸/Principled/Output 14 类。", "image": "/tutorial/full/steps/M05-shader-workspace.jpg", "alt": "Shader Editor 节点与材质预览" },
|
||||
{ "title": "图像与预览", "text": "Image Texture 选择 packed 图像或色彩空间；外部图片通过“外部贴图”入口导入 OPFS 后打包；右侧材质球显示预览，可保存缩略图。", "image": "/tutorial/full/steps/M05-asset-library.jpg", "alt": "材质预览与资产库材质卡片" }
|
||||
],
|
||||
"checks": ["材质槽分配成功", "节点连接后预览变化", "图像节点使用正确贴图"],
|
||||
"tips": ["Principled 的 Base Color/Roughness/Metallic 会直接影响 PBR 渲染。"],
|
||||
"limits": ["仅 14 类节点；未知节点会显示不支持并阻止图验证。"],
|
||||
"links": [{ "label": "材质课程 M05", "href": "/tutorial/full/index.html#M05" }]
|
||||
},
|
||||
{
|
||||
"id": "ch16", "number": 16, "part": "part-c", "title": "PBR/RE 资产库、Append/Link 与 packed 图像", "level": "进阶",
|
||||
"workspace": "Shading", "workspaces": ["Shading", "Rendering"],
|
||||
"summary": "从 PBR/RE 资产库加载模型/材质，理解 Append/Link 与 packed 资源。",
|
||||
"objectives": ["筛选/搜索资产", "双击添加/分配", "修复资产库"],
|
||||
"prerequisites": ["ch15"],
|
||||
"desktopReference": "Asset library, Append/Link, packed images",
|
||||
"steps": [
|
||||
{ "title": "选择资产源", "text": "Shading 左下 PBR 资产库可选择 pbr-library、re-pbr 或 HQ 源，按类型/目录/来源筛选，搜索资产名。", "image": "/tutorial/full/steps/M05-asset-library.jpg", "alt": "PBR 资产库搜索、筛选与资产卡片" },
|
||||
{ "title": "添加或分配", "text": "双击模型添加到场景，双击材质分配到当前材质槽；也可用“添加到场景”“分配到材质槽”。资产库元数据与预览存 OPFS/IndexedDB。", "image": "/tutorial/full/steps/M05-asset-library.jpg", "alt": "RE PBR 材质卡片与分配结果" },
|
||||
{ "title": "packed 与修复", "text": "材质贴图以 packed 图像进入工程，Properties → Resources 显示 packed 资源；缺失时点“修复资产库”重建。库链接图像绘制前需在 Texture Paint “设为本地”。", "image": "/tutorial/full/steps/M07-painted-stroke.jpg", "alt": "纹理绘制中的 packed 图像与绘制结果" }
|
||||
],
|
||||
"checks": ["资产卡可见/可筛选", "双击材质改变材质槽", "packed 图在重开后仍存在"],
|
||||
"tips": ["RE 5000PBR 有 6 张材质；HQ 源提供 2048 贴图。"],
|
||||
"limits": ["库链接对象/材质只读；仅图像有 Make Local 绘制路径。"],
|
||||
"links": [{ "label": "PBR 课程 M05", "href": "/tutorial/full/index.html#M05" }]
|
||||
},
|
||||
{
|
||||
"id": "ch17", "number": 17, "part": "part-c", "title": "Texture Paint：画笔、撤销/重做、Make Local 与 OPFS", "level": "进阶",
|
||||
"workspace": "Texture Paint", "workspaces": ["Texture Paint"],
|
||||
"summary": "在 packed 图像上绘制，一次笔画一次提交，撤销/重做并保存重开；库链接图先本地化。",
|
||||
"objectives": ["选择图像", "绘制/擦除", "撤销/重做与持久化"],
|
||||
"prerequisites": ["ch15", "ch16"],
|
||||
"desktopReference": "Texture Paint 2D image brush",
|
||||
"steps": [
|
||||
{ "title": "选择纹理图像", "text": "Texture Paint 顶部“纹理图像”只列出 packed 图像；没有图像时先在 Shading 分配带 Base Color 图的材质。", "image": "/tutorial/full/steps/M07-texture-paint.jpg", "alt": "Texture Paint 图像选择与画布" },
|
||||
{ "title": "绘制笔画", "text": "选择绘制/擦除、颜色、大小、强度，在画布按住拖动；松开后显示“笔画已提交”，一次笔画一个 Main revision。", "image": "/tutorial/full/steps/M07-painted-stroke.jpg", "alt": "在贴图上绘制白色笔画后的结果" },
|
||||
{ "title": "本地化与恢复", "text": "库链接图像先选择“库链接图像”并点“设为本地”，再绘制；可撤销/重做笔画，保存 OPFS 后重开像素仍保留。", "image": "/tutorial/full/steps/M07-painted-stroke.jpg", "alt": "纹理绘制撤销/重做与保存状态" }
|
||||
],
|
||||
"checks": ["画布像素变化", "撤销恢复原图", "重开后笔画仍在"],
|
||||
"tips": ["图像越大 PNG 编码越慢；课程使用 1024×1024。"],
|
||||
"limits": ["仅二维 packed 图像；不做 UDIM/投影/4K 生产级绘制。"],
|
||||
"links": [{ "label": "纹理绘制课程 M07", "href": "/tutorial/full/index.html#M07" }]
|
||||
},
|
||||
{
|
||||
"id": "ch18", "number": 18, "part": "part-d", "title": "Geometry Nodes 与 Spreadsheet", "level": "进阶",
|
||||
"workspace": "Geometry Nodes", "workspaces": ["Geometry Nodes"],
|
||||
"summary": "在画布中添加 allowlist 节点、连线、编辑 socket、提交图，并在 Spreadsheet 检查数据。",
|
||||
"objectives": ["添加/连线节点", "提交 GN 图", "检查 Spreadsheet 数据"],
|
||||
"prerequisites": ["ch11"],
|
||||
"desktopReference": "Geometry Nodes node tree, Spreadsheet",
|
||||
"steps": [
|
||||
{ "title": "打开 GN 画布", "text": "选中网格，切换到 Geometry Nodes；画布显示当前图，检查器显示节点/socket 属性。", "image": "/tutorial/full/steps/M12-geometry-nodes.jpg", "alt": "Geometry Nodes 画布与检查器" },
|
||||
{ "title": "添加与连线", "text": "选择 allowlist 节点（Group Input/Output、Transform、Set Position、Join/Separate Geometry、Realize Instances、Store Named Attribute、输入/比较/数学、Object/Collection/Image Info 等），拖拽端口连线，修改 socket 默认值。", "image": "/tutorial/full/steps/M12-node-added.jpg", "alt": "添加 Transform 节点并连接后的 GN 画布" },
|
||||
{ "title": "提交与检查", "text": "点击“提交图”写入原生节点树；下方 Spreadsheet 切换对象/顶点/边/面/UV/属性，过滤/列/CSV。", "image": "/tutorial/full/steps/M13-vertices.jpg", "alt": "Spreadsheet 顶点表与过滤" }
|
||||
],
|
||||
"checks": ["节点/连线/属性提交成功", "几何随图更新", "Spreadsheet 行数据正确"],
|
||||
"tips": ["保存重开会保留节点、连线与位置。"],
|
||||
"limits": ["仅 16 类 allowlist 节点；无 Simulation Zone；Spreadsheet 只读当前网格缓冲。"],
|
||||
"links": [{ "label": "GN 课程 M12", "href": "/tutorial/full/index.html#M12" }]
|
||||
},
|
||||
{
|
||||
"id": "ch19", "number": 19, "part": "part-d", "title": "Timeline、Dope Sheet 与关键帧动画", "level": "基础",
|
||||
"workspace": "Animation", "workspaces": ["Animation"],
|
||||
"summary": "跳帧、插入/删除 Loc/Rot/Scale 关键帧、播放并管理 Action。",
|
||||
"objectives": ["跳帧与播放", "插入关键帧", "管理 Action/插值"],
|
||||
"prerequisites": ["ch07"],
|
||||
"desktopReference": "Timeline, Dope Sheet, Actions",
|
||||
"steps": [
|
||||
{ "title": "时间线", "text": "Animation 底部 Timeline 可跳到首/末帧、上一/下一帧、播放/暂停；当前帧输入框可直接跳转。", "image": "/tutorial/full/steps/M10-animation-workspace.jpg", "alt": "Animation 工作区时间线与 Dope Sheet" },
|
||||
{ "title": "关键帧", "text": "选中对象，在目标帧点击 Loc/Rot/Scale 插入关键帧，Del Key 删除当前帧；Dope Sheet 显示关键点与当前帧。", "image": "/tutorial/full/steps/M10-keyframe.jpg", "alt": "Dope Sheet 关键帧与时间线" },
|
||||
{ "title": "Action 与插值", "text": "Action name/New Action/Remove Action/活动 Action 管理动画；F-Curve 插值可选 Constant/Linear/Bezier；Fake User 防止 Action 被清理。", "image": "/tutorial/full/steps/M10-keyframe.jpg", "alt": "Action 与关键帧插值控件" }
|
||||
],
|
||||
"checks": ["关键帧出现在当前帧", "播放推进帧号", "Action 切换生效"],
|
||||
"tips": ["Web 播放是本地帧步进，不是原生动画求值/音频播放。"],
|
||||
"limits": ["无完整原生播放/音频；部分多通道编辑器只暴露首条曲线。"],
|
||||
"links": [{ "label": "动画课程 M10", "href": "/tutorial/full/index.html#M10" }]
|
||||
},
|
||||
{
|
||||
"id": "ch20", "number": 20, "part": "part-d", "title": "Graph Editor、NLA 与驱动器", "level": "进阶",
|
||||
"workspace": "Animation", "workspaces": ["Animation"],
|
||||
"summary": "在 Graph Editor 查看/拖动关键帧、切换插值；用 NLA 表单管理轨道/条带和驱动器表达式。",
|
||||
"objectives": ["Graph 查看/拖动关键帧", "插入/删除关键帧", "NLA/驱动器入口"],
|
||||
"prerequisites": ["ch19"],
|
||||
"desktopReference": "Graph Editor, NLA, Drivers",
|
||||
"steps": [
|
||||
{ "title": "Graph 曲线", "text": "Animation 工作区 Graph Editor 列出通道，显示曲线与关键点；勾选通道显隐，滚轮缩放，按钮框显全部。", "image": "/tutorial/full/steps/M10-keyframe.jpg", "alt": "Animation 工作区中的 Graph Editor 区域" },
|
||||
{ "title": "编辑关键帧", "text": "点击关键点选中并拖动；插入/删除关键帧；插值选择 Bezier/Linear/Constant。拖动提交一条 F-Curve 命令。", "image": "/tutorial/full/steps/M10-keyframe.jpg", "alt": "Graph Editor 关键帧与插值" },
|
||||
{ "title": "NLA 与驱动器", "text": "Timeline 的 NLA 区可选择 Track/Strip，编辑起止、重复、Blend In/Out、Extrapolation 并提交；驱动器表达式/关键帧编辑器在动画属性区。", "image": "/tutorial/full/steps/M10-animation-workspace.jpg", "alt": "NLA 与动画属性区域" }
|
||||
],
|
||||
"checks": ["Graph 曲线显示正确", "拖动改变关键帧", "NLA 提交生效"],
|
||||
"tips": ["Graph 是简化 SVG 编辑器；复杂曲线/驱动器使用原生/F3。"],
|
||||
"limits": ["NLA 是表单式而非完整通道编辑器；驱动器变量/目标未完整暴露。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch21", "number": 21, "part": "part-d", "title": "物理、粒子、点缓存与模拟限制", "level": "进阶",
|
||||
"workspace": "Layout", "workspaces": ["Layout"],
|
||||
"summary": "查看并编辑 Soft Body/Rigid Body/Cloth/Fluid/Particle 设置，理解 Web 播放与求解限制。",
|
||||
"objectives": ["找到物理设置", "编辑参数", "理解播放/求解边界"],
|
||||
"prerequisites": ["ch09"],
|
||||
"desktopReference": "Physics properties, point cache",
|
||||
"steps": [
|
||||
{ "title": "物理工作台", "text": "Properties → Physics 选择 Rigid Body/Soft Body/Cloth/Fluid/Particle，编辑质量、摩擦、弹性、碰撞、缓存等参数。", "image": "/manuals/images/ch21-physics.jpg", "alt": "属性面板中的物理设置与缓存选项" },
|
||||
{ "title": "点缓存", "text": "Point Cache 可 Bake All/Free Bake All；在 localOnly/native 路径可执行缓存操作，Web 路径受能力门控。", "image": "/tutorial/full/steps/M04-properties.jpg", "alt": "属性面板与物理/缓存入口" },
|
||||
{ "title": "模拟播放", "text": "物理求解依赖已校验的桌面/服务器实现；Web 本地播放未接通时状态会返回 PHYSICS_CACHE_PLAYBACK_UNAVAILABLE/PHYSICS_SOLVER_UNAVAILABLE。", "image": "/manuals/images/ch21-physics.jpg", "alt": "物理设置和运行限制提示" }
|
||||
],
|
||||
"checks": ["物理类型可切换", "参数进入 Main", "不支持时明确显示能力码"],
|
||||
"tips": ["需要真实求解时使用原生会话/服务器渲染路径。"],
|
||||
"limits": ["Web 本地模拟播放/求解未接通；仅参数编辑与缓存入口。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch22", "number": 22, "part": "part-e", "title": "相机、灯光、世界与渲染属性", "level": "进阶",
|
||||
"workspace": "Rendering", "workspaces": ["Rendering", "Layout"],
|
||||
"summary": "编辑相机镜头/DoF、灯光类型/能量、世界环境、色彩管理和渲染输出。",
|
||||
"objectives": ["编辑相机/灯光", "设置世界/色彩", "配置分辨率与输出"],
|
||||
"prerequisites": ["ch09"],
|
||||
"desktopReference": "Camera/Light/World/Render properties",
|
||||
"steps": [
|
||||
{ "title": "相机", "text": "选中相机，Properties 编辑投影、焦距、near/far、全景/鱼眼与景深（焦点对象/距离/F-stop）。", "image": "/tutorial/full/steps/M08-render-workspace.jpg", "alt": "Rendering 工作区与相机/渲染面板" },
|
||||
{ "title": "灯光与世界", "text": "灯光属性编辑类型、形状、diffuse/specular/transmission/volume 因子、衰减/阴影；世界属性编辑曝光、环境强度、AO 与探针分辨率。", "image": "/tutorial/full/steps/M08-pbr-panel.jpg", "alt": "PBR 渲染面板与灯光/世界参数" },
|
||||
{ "title": "输出设置", "text": "Scene Render/Output 设置分辨率、百分比、帧范围、输出格式；色彩管理选择 display/view transform/look/exposure/gamma。", "image": "/tutorial/full/steps/M08-pbr-panel.jpg", "alt": "分辨率、相机与视图设置" }
|
||||
],
|
||||
"checks": ["相机/灯光修改影响渲染", "世界/色彩设置保存", "分辨率与输出格式正确"],
|
||||
"tips": ["PBR 练习面板提供场景相机对齐与常用参数预设。"],
|
||||
"limits": ["部分场景/渲染字段为离散按钮；完整 RNA 字段未全部暴露。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch23", "number": 23, "part": "part-e", "title": "PBR 渲染、Render Result 与手动 PNG 下载", "level": "进阶",
|
||||
"workspace": "Rendering", "workspaces": ["Rendering"],
|
||||
"summary": "设置分辨率/相机/曝光/位移，执行浏览器 PBR 渲染，检查结果并手动下载 PNG。",
|
||||
"objectives": ["执行一次 PBR 渲染", "检查结果/OPFS", "手动下载 PNG"],
|
||||
"prerequisites": ["ch15", "ch16", "ch22"],
|
||||
"desktopReference": "Render > Render Image",
|
||||
"steps": [
|
||||
{ "title": "渲染参数", "text": "Rendering 的 PBR 面板设置视角预设、位移强度、视图（Final/Base Color/Normal/Roughness）、曝光、分辨率 256/512/1024/2048、相机 Viewport/Scene。", "image": "/tutorial/full/steps/M08-pbr-panel.jpg", "alt": "PBR 渲染参数面板" },
|
||||
{ "title": "执行渲染", "text": "点击“渲染 PBR”，等待纹理/环境就绪并输出结果；结果显示尺寸、字节数和 OPFS hash。浏览器渲染器是 three.js WebGL2 physical-v1，不是 Cycles/EEVEE。", "image": "/tutorial/full/steps/M09-render-result.jpg", "alt": "PBR 渲染结果与 OPFS 信息" },
|
||||
{ "title": "手动下载/原生渲染", "text": "点击“下载 PNG”保存本地 pbr-<width>.png；Rendering 页面还提供可选的“桌面 EEVEE 渲染”，需原生服务，产物链接需手动点击下载。", "image": "/tutorial/full/steps/M09-render-result.jpg", "alt": "下载 PNG 与渲染结果区域" }
|
||||
],
|
||||
"checks": ["渲染结果尺寸符合设置", "结果写入 OPFS", "PNG 仅在点击下载后保存"],
|
||||
"tips": ["深色材质先切 Base Color/Roughness 诊断，避免只凭整体亮度判断。"],
|
||||
"limits": ["浏览器 PBR 为简化渲染器；原生渲染依赖服务器/桌面服务。"],
|
||||
"links": [{ "label": "渲染课程 M08/M09", "href": "/tutorial/full/index.html#M08" }]
|
||||
},
|
||||
{
|
||||
"id": "ch24", "number": 24, "part": "part-e", "title": "Compositor：节点画布、执行与保存", "level": "进阶",
|
||||
"workspace": "Compositing", "workspaces": ["Compositing"],
|
||||
"summary": "创建 RGB/Exposure/Blur/Mix/Alpha Over/Transform/Viewer/Composite 节点，执行 CPU 合成并提交。",
|
||||
"objectives": ["添加/连线节点", "执行合成/Viewer", "保存重开图"],
|
||||
"prerequisites": ["ch23"],
|
||||
"desktopReference": "Compositor node tree, Composite/Viewer",
|
||||
"steps": [
|
||||
{ "title": "节点画布", "text": "Compositing 工作区画布默认包含 Composite；添加节点类型，拖拽端口连接，右侧检查器编辑属性/颜色/图像来源。", "image": "/tutorial/full/steps/M11-compositor.jpg", "alt": "Compositor 画布与默认 Composite 节点" },
|
||||
{ "title": "执行合成", "text": "点击“执行合成”，CPU 求值器显示 Viewer 或 Composite 结果；RGB/Exposure/Invert/Blur/Mix/Alpha Over/Transform 等可用，IMAGE 使用 packed 图，Render Layer 使用最近 PBR 渲染。", "image": "/tutorial/full/steps/M11-executed.jpg", "alt": "Compositor 执行结果预览" },
|
||||
{ "title": "提交与限制", "text": "点击“提交图”写入原生 CompositorNodeTree；不支持的节点会阻止提交并显示“当前图含无法持久化的节点”。保存 OPFS 后重开保留节点/连线/属性/资源。", "image": "/tutorial/full/steps/M11-nodes-added.jpg", "alt": "添加 RGB/Exposure 节点并连线" }
|
||||
],
|
||||
"checks": ["节点/连线/属性提交", "执行结果显示", "重开后图保留"],
|
||||
"tips": ["先执行再提交，便于发现资源/节点限制。"],
|
||||
"limits": ["9 类节点；WebGPU allowlist 4 类；Alpha Over factor 不持久化，MIX 仅 RGBA。"],
|
||||
"links": [{ "label": "Compositor 课程 M11", "href": "/tutorial/full/index.html#M11" }]
|
||||
},
|
||||
{
|
||||
"id": "ch25", "number": 25, "part": "part-e", "title": "导入导出矩阵：GLB/GLTF/OBJ/STL/PLY、原生导出与 CSV", "level": "进阶",
|
||||
"workspace": "Layout", "workspaces": ["Layout", "Rendering", "Geometry Nodes"],
|
||||
"summary": "按可用性导入/导出模型与数据，明确浏览器本地、原生/F3、不可用三种路径。",
|
||||
"objectives": ["导入本地模型", "导出 GLB/CSV", "识别不可用格式"],
|
||||
"prerequisites": ["ch03"],
|
||||
"desktopReference": "File > Import/Export",
|
||||
"steps": [
|
||||
{ "title": "导入模型/图像/字体", "text": "顶栏“打开 .blend”文件选择器接受 .blend、.gltf、.glb、.obj、.stl、.ply；材质图片、VFont 在对应属性面板导入；资源写入 OPFS。", "image": "/manuals/images/ch25-import-menu.jpg", "alt": "文件菜单导入子菜单与格式" },
|
||||
{ "title": "导出", "text": "顶栏“导出 GLB”生成 blender-web.glb；文件 → 导出提供 GLB/GLTF/FBX/OBJ/STL/PLY/USD/ALEMBIC 的原生面板（需服务）；浏览器本地仅 GLB/OBJ 可用，其余显示“浏览器导出尚未移植”。", "image": "/manuals/images/ch25-export-menu.jpg", "alt": "文件菜单导出子菜单与格式状态" },
|
||||
{ "title": "CSV/诊断", "text": "Spreadsheet“导出 CSV”导出当前过滤/可见列；帮助/顶栏导出诊断 JSON。所有下载均为显式手动动作。", "image": "/tutorial/full/steps/M13-filtered.jpg", "alt": "Spreadsheet 过滤与 CSV 导出入口" }
|
||||
],
|
||||
"checks": ["导入后对象数增加", "GLB/CSV 仅在点击导出后下载", "不可用格式不被承诺"],
|
||||
"tips": ["GLTF 外部 .bin/纹理不在单文件导入范围；优先使用 GLB。"],
|
||||
"limits": ["USD/Alembic/FBX 当前依赖原生服务；浏览器本地导出仅部分格式。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch26", "number": 26, "part": "part-f", "title": "脚本：Text Editor、Python Console 与 Info", "level": "进阶",
|
||||
"workspace": "Scripting", "workspaces": ["Scripting"],
|
||||
"summary": "编辑/运行文本脚本，使用原生 Python 控制台与 Info 状态，理解脚本策略。",
|
||||
"objectives": ["编辑/应用文本", "运行 Python", "查看 Info/诊断"],
|
||||
"prerequisites": ["ch04"],
|
||||
"desktopReference": "Text Editor, Python Console, Info",
|
||||
"steps": [
|
||||
{ "title": "Text Editor", "text": "Scripting 上方 Text Editor 选择/创建文本，打开 .py/.txt（≤1 MiB），编辑后必须 Apply 才写入 Main；可下载或运行原生 Python。", "image": "/tutorial/full/steps/M15-scripting.jpg", "alt": "Scripting 工作区文本编辑器与控制台" },
|
||||
{ "title": "Python Console", "text": "Web 模式使用原生会话面板连接/执行/撤销 Main/应用到场景；输出与命令历史可见。脚本受信任/权限/沙箱策略约束。", "image": "/tutorial/full/steps/M15-console.jpg", "alt": "Python Console 与 Info 区域" },
|
||||
{ "title": "Info 与策略", "text": "Info 显示 Engine 状态与活动场景，不是完整 Blender 操作日志；敏感脚本需显式允许/恢复脚本策略。", "image": "/tutorial/full/steps/M15-console.jpg", "alt": "Info 状态与脚本运行结果" }
|
||||
],
|
||||
"checks": ["文本 Apply 后执行", "控制台执行结果可见", "未 Apply 草稿阻止保存"],
|
||||
"tips": ["运行前保存 OPFS 工程；脚本可修改 Main。"],
|
||||
"limits": ["Web 控制台依赖原生会话；Info 不是操作历史；脚本能力受策略/沙箱限制。"],
|
||||
"links": [{ "label": "脚本课程 M15", "href": "/tutorial/full/index.html#M15" }]
|
||||
},
|
||||
{
|
||||
"id": "ch27", "number": 27, "part": "part-f", "title": "Preferences、Keymap、快捷栏与启动工作区", "level": "基础",
|
||||
"workspace": "Layout", "workspaces": ["Layout"],
|
||||
"summary": "使用分栏偏好设置、OPFS 保存、可改键位、快捷栏显隐和启动工作区。",
|
||||
"objectives": ["修改并保存偏好", "改键/冲突处理", "控制快捷栏与启动工作区"],
|
||||
"prerequisites": ["ch04"],
|
||||
"desktopReference": "Edit > Preferences, Keymap",
|
||||
"steps": [
|
||||
{ "title": "偏好分栏", "text": "编辑 → 偏好设置打开 Web 偏好窗口；界面/视口/动画/输入导航/键位/保存加载/文件/主题/系统分栏，支持项真实生效，不支持项显示“Web 不支持”和桌面来源。", "image": "/manuals/images/ch27-preferences.jpg", "alt": "Web 偏好设置分栏与设置项" },
|
||||
{ "title": "键位", "text": "键位页列出 17 个顶层动作；点“录制”按组合键，冲突会被拒绝并提示；保存后写入 OPFS，旧键位失效。", "image": "/manuals/images/ch27-keymap.jpg", "alt": "键位表、录制按钮与冲突提示" },
|
||||
{ "title": "快捷栏/启动工作区", "text": "界面页控制状态栏、快捷操作栏、区域切换器、启动工作区；保存偏好后刷新，快捷栏显隐与启动工作区生效。", "image": "/manuals/images/ch27-preferences.jpg", "alt": "界面偏好中的快捷栏与启动工作区设置" }
|
||||
],
|
||||
"checks": ["偏好刷新后保持", "键位冲突被拒绝", "快捷栏可隐藏", "启动工作区生效"],
|
||||
"tips": ["OPFS 是偏好权威存储，localStorage 只是镜像。"],
|
||||
"limits": ["主题/系统/完整键位配置未实现；部分视口/自动保存项标注不支持。"],
|
||||
"links": []
|
||||
},
|
||||
{
|
||||
"id": "ch28", "number": 28, "part": "part-f", "title": "故障排查、能力边界与离线/版本说明", "level": "进阶",
|
||||
"workspace": "Layout", "workspaces": ["Layout"],
|
||||
"summary": "按状态栏/诊断/支持矩阵定位问题，理解 OPFS、浏览器、原生服务和格式限制。",
|
||||
"objectives": ["定位常见失败", "导出诊断", "查阅限制"],
|
||||
"prerequisites": ["ch04"],
|
||||
"desktopReference": "Troubleshooting / limitations",
|
||||
"steps": [
|
||||
{ "title": "先看状态栏", "text": "失败时查看 Engine 状态、存储状态和诊断计数；打开操作失败会显示读取/取消阶段，Worker 停止可点“重启并恢复”。", "image": "/manuals/images/ch28-help.jpg", "alt": "帮助菜单与诊断/手册入口" },
|
||||
{ "title": "恢复与备份", "text": "优先从最近项目/自动恢复点重开；损坏引用可移除。重要工程另存并定期手动下载 .blend；清除站点数据会删除 OPFS。", "image": "/tutorial/full/steps/M14-reopen.jpg", "alt": "最近项目恢复入口" },
|
||||
{ "title": "能力边界", "text": "支持矩阵区分可用/部分/仅原生/不可用。明确限制包括：本地模拟求解、部分 IO 格式、完整主题/键位、UDIM/投影纹理、Compositor/Shader/GN 节点目录。不要把手册当桌面 parity 证书。", "image": "/manuals/images/ch28-help.jpg", "alt": "帮助菜单与支持信息" }
|
||||
],
|
||||
"checks": ["能从状态栏定位失败阶段", "能恢复或导出诊断", "限制与支持矩阵一致"],
|
||||
"tips": ["首次远端加载 154–193 秒属正常，等待进度完成再操作。"],
|
||||
"limits": ["本手册只验证 Chromium + RTX 4060；其他浏览器未验证。"],
|
||||
"links": [{ "label": "支持矩阵附录", "href": "#appendix-support" }]
|
||||
}
|
||||
],
|
||||
"appendices": [
|
||||
{ "id": "appendix-shortcuts", "title": "附录 A：常用快捷键与 F3 命令", "rows": [
|
||||
["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", "轴视图 / 透视正交"]
|
||||
] },
|
||||
{ "id": "appendix-paths", "title": "附录 C：OPFS 与本地文件位置", "rows": [
|
||||
["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 导出"]
|
||||
] },
|
||||
{ "id": "appendix-glossary", "title": "附录 D：术语与缩略语", "rows": [
|
||||
["OPFS", "Origin Private File System，浏览器私有文件系统"],
|
||||
["SceneIR", "WebEngine 输出的场景只读描述"],
|
||||
["Main", "原生 Blender 主数据库，编辑与撤销的真实来源"],
|
||||
["Packed 图像", "数据打包在工程内的图像，可在纹理绘制中编辑"],
|
||||
["Make Local", "把库链接图像复制为本地可编辑数据"],
|
||||
["Camera to View", "锁定相机视图时导航会写回相机对象"]
|
||||
] }
|
||||
],
|
||||
"gaps": [
|
||||
{ "id": "save-as-copy", "status": "FIXED", "summary": "另存为文案错误地称会下载 .blend", "files": ["web/app/src/app/App.tsx"], "tests": ["web/tests/e2e/web-save-download-semantics.spec.ts"], "chapterIds": ["ch03"] },
|
||||
{ "id": "gltf-import", "status": "FIXED", "summary": ".gltf 被 UI 过滤但原生导入支持", "files": ["web/app/src/app/App.tsx"], "tests": ["web/tests/e2e/io-format-ui-gate.spec.ts"], "chapterIds": ["ch25"] },
|
||||
{ "id": "quick-toolbar", "status": "FIXED", "summary": "快捷操作栏开关不生效", "files": ["web/app/src/app/desktop-menus.css", "web/protocol/web-preferences.ts"], "tests": ["web/tests/e2e/web-preferences.spec.ts"], "chapterIds": ["ch27"] },
|
||||
{ "id": "properties-tabs", "status": "FIXED", "summary": "Properties 三个标签无响应", "files": ["web/app/src/app/App.tsx"], "tests": ["web/tests/e2e/web-manual-ui-gaps.spec.ts"], "chapterIds": ["ch09"] },
|
||||
{ "id": "editor-header-menu", "status": "FIXED", "summary": "区域头 ⋮ 无响应", "files": ["web/app/src/app/App.tsx"], "tests": ["web/tests/e2e/web-manual-ui-gaps.spec.ts"], "chapterIds": ["ch06"] },
|
||||
{ "id": "outliner-search", "status": "FIXED", "summary": "Outliner fallback 搜索框空转", "files": ["web/app/src/app/App.tsx"], "tests": ["web/tests/e2e/web-manual-ui-gaps.spec.ts"], "chapterIds": ["ch08"] },
|
||||
{ "id": "startup-workspace", "status": "FIXED", "summary": "启动工作区偏好无效果", "files": ["web/app/src/app/App.tsx"], "tests": ["web/tests/e2e/web-preferences.spec.ts"], "chapterIds": ["ch27"] }
|
||||
]
|
||||
}
|
||||
Reference in New Issue
Block a user