Loading environment
网页预览需要让用户快速开始观察，同时保持可信 PBR 效果。优化目标应根据交互与画质共同衡量，而不是只追求降低面数。 本手册把操作、原理与验收证据放在同一条制作链上。目标不是记忆一组菜单，而是让另一位制作者在相同输入下得到相同结论，并指出版本边界、失败位置与恢复路径。
依据 Blender 5.2.0 LTS、glTF 2.0.1 与仓库 Three.js 0.185 依赖验证。下列数字是案例验收目标，不是通用设备标准。 文中“通过”只代表所写条件在该版本、仓库实现或指定目标得到验证；它不表示任意第三方插件、导出器或查看器都会保留相同能力。Easy 系列结论同时依据清单、仓库源码、单元测试和 Blender 5.2 烟雾测试。
网页预览需要让用户快速开始观察，同时保持可信 PBR 效果。优化目标应根据交互与画质共同衡量，而不是只追求降低面数。 最终交付不只是一张漂亮图片或一个能打开的文件，还必须包含可重放步骤、阶段门槛、诊断记录、依赖清单与目标端证据。任何无法在洁净环境复现的成功，都暂时视为缓存或本机状态造成的偶然结果。
继续学习
带单位、尺寸或来源说明的代表输入，以及一个明确失败对照
未覆盖的高质量源文件和只用于诊断、交换、交付的独立副本
记录完整 Blender、Easy 扩展、导出器与目标查看器版本
可写暂存目录、依赖清单、目标验收矩阵和回退点
中性测试灯光、近景诊断相机与最终交付相机
开始“为流畅网页预览优化 3D 模型”前复制源文件，并为关键输入计算哈希。把系统、版本、目标格式、查看器和案例预算写入同一记录。这样出现差异时可以判断是内容、工具还是环境变化，不会在多个变量同时移动时猜测。
原则 1： 条件允许时使用 GLB 作为主要网页交付格式。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 2： 同时规划几何、纹理显存、Draw Call 和着色复杂度。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 3： 优先保留轮廓与法线质量，再处理隐藏细节。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 4： 在保留源图的同时生成较低纹理分辨率。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 5： 预加载共用 HDRI，并在不同查看器之间缓存。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 6： 显示明确的模型构建和材质加载进度。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
案例家具源文件起始为 61.2 万三角形、38 个 Draw Call 与九张 4K 贴图。验收 GLB 在 14.8 万三角形保留可见轮廓，合并到 12 个 Draw Call，主贴图 2K、次贴图 1K，并另存高分辨率源。实体、线框与最终 PBR 模式都必须通过。 该案例刻意保留失败对照，用来区分流程真实正确与结果碰巧可用。所有数值只是本案例验收条件；移植到其他项目时，应根据镜头距离、目标硬件、许可与交付格式重新制定，而不是机械复制。
下图把“为流畅网页预览优化 3D 模型”的八个阶段和各自门槛连成闭环。箭头表达依赖关系，不意味着流程永远只能线性前进；诊断推翻上游假设时，应回到拥有该变量的最早阶段，修复后重新执行全部后续门槛。
执行动作。 冻结验收目标：网页预览需要让用户快速开始观察，同时保持可信 PBR 效果。优化目标应根据交互与画质共同衡量，而不是只追求降低面数。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 先减少隐藏与冗余拓扑，再处理可见轮廓 本阶段遵循的原则是：条件允许时使用 GLB 作为主要网页交付格式。 在“为流畅网页预览优化 3D 模型”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 先固定输入基线，再讨论处理结果。“先减少隐藏与冗余拓扑，再处理可见轮廓”是本阶段的事实锚点；若基线不可信，后续差异无法归因。用未修改样本与工作副本做同条件对照，只记录由本阶段引入的变化。
阶段门槛。 通过条件是 首个可用画面快速出现。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：不检查轮廓就减面会损害商品质量。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
执行动作。 确定具有代表性的桌面性能目标，记录帧时间、首次渲染和内存。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 沿批准相机路径判断减面 本阶段遵循的原则是：同时规划几何、纹理显存、Draw Call 和着色复杂度。 在“为流畅网页预览优化 3D 模型”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 结构错误常被漂亮外观暂时遮住。“沿批准相机路径判断减面”把结构关系变成可检查条件。先在大纲、数据块或目录层验证归属，再进入视觉判断；否则下游修饰会扩大返工范围。
阶段门槛。 通过条件是 旋转保持流畅。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：单张超大纹理可能阻塞上传与 GPU 分配。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
执行动作。 移除隐藏几何、重复材质、空节点和未使用图像。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 只合并行为与分辨率策略一致的材质 本阶段遵循的原则是：优先保留轮廓与法线质量，再处理隐藏细节。 在“为流畅网页预览优化 3D 模型”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 准备阶段要把隐含状态转成显式记录。“只合并行为与分辨率策略一致的材质”决定后续操作所依赖的坐标、路径或解释方式。保存修改前后的数值，并让洁净样本复现同一前提。
阶段门槛。 通过条件是 线框保留实体面。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：用户选择后才开始加载 HDRI，会让每次切换都很慢。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
执行动作。 只合并材质与更新逻辑相同的物体，并保留有价值层级。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 Draw Call 与三角形数独立跟踪 本阶段遵循的原则是：在保留源图的同时生成较低纹理分辨率。 在“为流畅网页预览优化 3D 模型”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 核心操作必须保持单变量。“Draw Call 与三角形数独立跟踪”是这一轮唯一允许移动的控制量；相机、曝光、缓存和无关节点保持不变。若结果随它可重复变化，因果解释才成立。
阶段门槛。 通过条件是 边线细且清晰。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：只有转圈动画而没有阶段信息，会让正常转换看起来像故障。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
执行动作。 使用查看器流程支持的方式压缩几何和纹理。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 贴图分辨率遵循屏幕空间重要性与通道细节 本阶段遵循的原则是：预加载共用 HDRI，并在不同查看器之间缓存。 在“为流畅网页预览优化 3D 模型”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 关键细节通常出现在边界而非正面视图。“贴图分辨率遵循屏幕空间重要性与通道细节”需要在近景、掠射角或层级边界复核。把局部证据与最终镜头并列，避免只优化某一个观察距离。
阶段门槛。 通过条件是 PBR 贴图加载过程可见。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：不检查轮廓就减面会损害商品质量。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
执行动作。 适合时提供 512、1024 和源分辨率纹理选项。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 验证目标支持和视觉误差后才接受压缩 本阶段遵循的原则是：显示明确的模型构建和材质加载进度。 在“为流畅网页预览优化 3D 模型”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 正确与错误对照必须共享输入。“验证目标支持和视觉误差后才接受压缩”之外的条件全部锁定，再保存同角度、同曝光、同查看器结果。这样评审者看到的是规则差异，而不是两套场景的偶然差别。
阶段门槛。 通过条件是 失败状态说明具体阶段。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：单张超大纹理可能阻塞上传与 GPU 分配。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
执行动作。 测试保留实体面的线框、旋转、缩放、HDRI 切换和商品卡片展开预览，并观察帧时间。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 立即显示加载反馈，HDRI 使用不可变缓存 URL 本阶段遵循的原则是：条件允许时使用 GLB 作为主要网页交付格式。 在“为流畅网页预览优化 3D 模型”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 诊断从最早拥有变量的阶段开始。“立即显示加载反馈，HDRI 使用不可变缓存 URL”提供最小可证伪测试；测试失败就向上游收缩，测试通过再逐项恢复材质、灯光、修改器、路径与导出设置。
阶段门槛。 通过条件是 首个可用画面快速出现。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：用户选择后才开始加载 HDRI，会让每次切换都很慢。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
执行动作。 从最终交付包验证“为流畅网页预览优化 3D 模型”并归档证据。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 实体、线框、法线与最终着色全部通过 本阶段遵循的原则是：同时规划几何、纹理显存、Draw Call 和着色复杂度。 在“为流畅网页预览优化 3D 模型”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 最终门槛验证交付物而不是作者环境。“实体、线框、法线与最终着色全部通过”必须从最终根目录、重新导入文件或目标查看器取得证据。源路径、缓存和临时副本应暂时不可用，以暴露隐藏依赖。
阶段门槛。 通过条件是 旋转保持流畅。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：只有转圈动画而没有阶段信息，会让正常转换看起来像故障。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
阶段 | 合格标准 | 必须留存 |
|---|---|---|
1 | 首个可用画面快速出现 | 保存可复现证据 |
2 | 旋转保持流畅 | 保存可复现证据 |
3 | 线框保留实体面 | 保存可复现证据 |
4 | 边线细且清晰 | 保存可复现证据 |
5 | PBR 贴图加载过程可见 | 保存可复现证据 |
6 | 失败状态说明具体阶段 | 保存可复现证据 |
7 | 首个可用画面快速出现 | 保存可复现证据 |
8 | 旋转保持流畅 | 保存可复现证据 |
“为流畅网页预览优化 3D 模型”的评审者应能在不询问作者的情况下找到每项证据，并判断它对应哪个版本、源文件与目标。截图要保留诊断上下文，数字必须带单位，导出证据必须来自最终包而不是临时目录。
“为流畅网页预览优化 3D 模型”遵循“最早责任阶段”：尺度错误不能靠相机透视修正，原点错误不能每次手动偏移，色彩空间错误不能靠灯光补偿，不支持的节点也不能寄希望于查看器猜测。越早把现象还原成单一变量，修复范围和回归面越小。
在“为流畅网页预览优化 3D 模型”中，制作资产仍区分作者状态、交换状态和交付状态。作者状态保留可编辑性，交换状态缩小为目标能理解的表达，交付状态再针对体积、依赖和设备优化。三者使用独立副本与明确命名，避免为了便携永久破坏母版。
错误 1： 不检查轮廓就减面会损害商品质量。 先重现最小失败，再关闭无关灯光、节点分支、修改器、缓存或外部路径；每次只改一个条件，并保存同角度、同曝光、同目标对照。
错误 2： 单张超大纹理可能阻塞上传与 GPU 分配。 先重现最小失败，再关闭无关灯光、节点分支、修改器、缓存或外部路径；每次只改一个条件，并保存同角度、同曝光、同目标对照。
错误 3： 用户选择后才开始加载 HDRI，会让每次切换都很慢。 先重现最小失败，再关闭无关灯光、节点分支、修改器、缓存或外部路径；每次只改一个条件，并保存同角度、同曝光、同目标对照。
错误 4： 只有转圈动画而没有阶段信息，会让正常转换看起来像故障。 先重现最小失败，再关闭无关灯光、节点分支、修改器、缓存或外部路径；每次只改一个条件，并保存同角度、同曝光、同目标对照。
症状 | 最可能原因 | 最小测试 | 纠正动作 |
|---|---|---|---|
不检查轮廓就减面会损害商品质量。 | 条件允许时使用 GLB 作为主要网页交付格式。 | 首个可用画面快速出现 | 确定具有代表性的桌面性能目标，记录帧时间、首次渲染和内存。 |
单张超大纹理可能阻塞上传与 GPU 分配。 | 同时规划几何、纹理显存、Draw Call 和着色复杂度。 | 旋转保持流畅 | 移除隐藏几何、重复材质、空节点和未使用图像。 |
用户选择后才开始加载 HDRI，会让每次切换都很慢。 | 优先保留轮廓与法线质量，再处理隐藏细节。 | 线框保留实体面 | 只合并材质与更新逻辑相同的物体，并保留有价值层级。 |
只有转圈动画而没有阶段信息，会让正常转换看起来像故障。 | 在保留源图的同时生成较低纹理分辨率。 | 边线细且清晰 | 使用查看器流程支持的方式压缩几何和纹理。 |
“为流畅网页预览优化 3D 模型”按输入、结构、变换、映射、着色、导出边界与目标端诊断。最小测试如果同时改变两个以上变量，就没有可证伪性，应继续缩小。修复后必须重跑关键路径，因为局部正确不能证明打包、重新导入或目标查看器仍正确。
“为流畅网页预览优化 3D 模型”的最终验证使用从交付目录取得的文件，并暂时隐藏源路径。记录文件大小、SHA-256、对象与材质数量、缺失依赖检查、重新导入和目标查看器结果。交互内容还要记录加载、控制台错误和稳定帧表现；资产库则执行拖入、保存、关闭与重开。
未覆盖源文件与清楚命名的交付副本
Blender、Easy 扩展、导出器与目标查看器版本
尺度、变换、原点、层级、材质槽、法线与依赖检查
从最终包执行的重新打开或重新导入证据
目标截图、验证报告、文件哈希与已知限制
只含有意图文件的交付根目录，无缓存、临时备份或辅助物
以下原始资料定义“为流畅网页预览优化 3D 模型”的事实边界；Blender 操作指向 5.2 手册，格式保证指向对应规范，Easy 行为限定在仓库版本与烟雾证据内。
VertexModeler
灯光与实时预览
