blender-rendering-workflow

Blender 渲染工作流

每项任务开始时，阅读一次共享执行指南，以了解自主决策、证据采集频率和长任务连续性。

将渲染视为可复现的交付成果，而不是一张碰巧看起来还算满意的截图。

当标牌或图形表面难以辨读时，如果有标牌集成指南，请参阅该指南。更改灯光前，先对比平面图稿与作者视角下的画面：问题可能出在布局、投影文字尺寸、UV 扭曲或纹理过滤上。区分印刷表面、背光面板和屏幕，不要让所有表面都发光。

如需制作建模／构建延时视频，请按照检查点采集与视频交付的要求操作。建模前，先从实际的空白／默认场景开始录制；捕捉真实的里程碑，然后在完成后再渲染／编码。此项为可选功能，仅在用户提出要求时启用。仅凭最终场景无法还原建模过程。

对于完整场景装饰，还请阅读建模工作流的完整场景工作流。将作者视角构图和材质检查与标准化几何证据分开处理。优先修复薄弱形体和次要区域，再进行展示润色。

对于建筑、日光光束或以织物为主的场景，请阅读室内空间与氛围。对于逼真材质或环境照明，请使用扫描材质与 HDRI：随附的 Poly Haven 搜索／下载工具可获取已验证的 CC0 贴图，最高支持 8K。重要形体应由你自行创作，但不要施加只能从零开始制作的限制，以免降低真实感。

使用创作好的场景表面

使用 blender_render_scene 进行最终效果渲染和光照诊断。 当摄像机名称、依赖项或渲染设置未知时，先使用 inspectOnly: true 调用。 然后按精确名称选择现有的 cameras，并可选指定 frames；摄像机与帧的组合最多允许 12 个。默认使用活动摄像机和帧，将最长边限制为 1280，并将 Cycles 采样数限制为 64，同时自动选择可用 GPU，并明确记录 CPU 回退情况。需要确保可复现时，请选择 device: "cpu" 或特定后端。 在共享桌面上，一次只运行一个 Blender 命令，并优先使用已验证的 GPU 后端。使用 --threads 2、scene.render.threads_mode = 'FIXED' 和 scene.render.threads = 2，为 CPU 留出余量。建模、依赖项更新和导出仍会使用 CPU；仅设置线程数不会限制整体 CPU 使用量。仓库的比较队列会额外限制 Windows 进程树的使用量。如果必须回退，请记录 GPU 初始化失败，并保留较低的 CPU 线程预算。 GPU 渲染不会自动启用 GPU 降噪。优先使用受支持的 OpenImageDenoise GPU 加速，并显式启用 denoising_use_gpu；否则使用受支持的 OptiX GPU 降噪。记录实际使用的降噪器和 GPU 标志，保留创作时的质量设置，并避免重复降噪。 兼容 MCP Apps 的宿主会显示紧凑型图片查看器，支持切换视图、适应窗口／100% 缩放和展开详情。其他宿主会保留行内图片和结构化结果。查看器显示已完成的渲染，而非实时进度。 如需明确指定独立交付尺寸，--render-edge 1536 会以最长边为 1536 渲染，同时保持宽高比，包括超过创作时尺寸的情况。单独使用 --max-edge 仍只是设置上限，不会提高创作时的分辨率。 每次运行都使用全新的输出目录。检查行内 PNG 和 render-manifest.json；错误不能作为成功的依据。

独立版已随此技能一并提供：

& $env:BLENDER_EXECUTABLE --background --factory-startup --disable-autoexec `
  --python-exit-code 1 --python "<skill-root>/scripts/render_scene.py" -- `
  --input scene.blend --output-dir renders/preview-01 --max-edge 1280 --samples 64

这样可以保留创作好的灯光、世界、体积、摄像机、材质和色彩管理设置。blender_render_evidence 会有意替换摄像机和灯光；应将其用于标准化几何检查，而不是用作室内场景的最终图像。

打开证据前，请先读取生成的清单，确认图像的准确路径。render_evidence.py 会写入包含 contact_sheet（通常为 contact_sheet.png）的 evidence.json；render_scene.py 会写入包含 renders 下摄像机／帧路径的 render-manifest.json。不要猜测带连字符的联系表文件名，也不要将缺失图像视为成功完成视觉审查。 这两种工具都不能替代在持久化源文件中创作场景。

根据任务选择降噪方式

常规低分辨率渲染使用渲染降噪设置，而非 Blender 视口预览设置。对于外观开发渲染，选择 denoise: "preview"；对于仍可见残余噪点的最终静帧，选择 denoise: "final"。对应的 CLI 选项为 --denoise preview 或 --denoise final。

• 预览：优先使用受支持的 GPU OpenImageDenoise Fast 和 Fast 预滤波；否则，在受支持时使用 GPU OptiX，然后使用 CPU OIDN Fast。设置适中的采样上限（例如 16-32），并使用 512-800px 分辨率检查构图和材质。
• 最终：使用 OpenImageDenoise High、Accurate 预滤波、Color + Albedo + Normal；在受支持时使用 GPU 加速，否则回退到 CPU。从场景的合理采样预算开始；不要仅仅因为这是最终渲染就增加采样数。
• denoise: "off" 会禁用渲染降噪，适用于图像本身已足够干净或需要检查原始噪点/细节的情况。它不会禁用已创建的合成器降噪器。
• denoise: "preserve" 是向后兼容的默认值，适用于刻意设置的参数和可复现的对比。

如果 Blender 构建版本没有编译 OpenImageDenoise，且没有受支持的 OptiX 降噪器，则以不降噪方式渲染预览/最终图，并在清单中记录 effectivePolicy: "off" 及原因。检查噪点，并在需要时提高有上限的采样预算，或使用官方 Blender 构建版本。此回退不会静默更改保留模式和已创建的合成器降噪器。

请在交付尺寸下检查纹理、精细边缘、接触阴影和反射。如果表面看起来有涂抹感，请先对比小块原始裁剪图或对应的无降噪预览，再增加采样数。只使用一个降噪阶段；如果已有启用的合成器降噪器，预览/最终策略会让位于已创建的设置。请阅读清单中的实际设置和回退原因。降噪无法修复几何体不足、纹理缺失或照明不佳；这些策略也不意味着使用基于像素的噪点检测器。对于动画，在提交整个序列前，请检查连续帧是否闪烁。

本地的杯子/亚麻布测试中，GPU OIDN 在低成本预览方面优于 CPU OIDN；这是特定硬件和场景下的结果，并非通用的速度排名。有关降噪器、预滤波和质量之间的权衡，请参阅 Blender 采样文档。

确定渲染约定

更改场景前，请记录：

• 目标受众、观看距离、参考氛围以及所需的叙事重点；
• 交付内容是静帧、转台动画、图像序列还是视频；分辨率、帧范围、帧率和输出格式；
• 渲染引擎、设备假设、时间/噪点预算，以及结果是否必须与下游引擎或合成器一致；
• 所需的摄像机、主体视图和诊断视图、渲染通道、Alpha，以及色彩管理要求；
• 哪些灯光、世界、材质、体积效果和合成器节点属于已创建的结果。

请将这些设置作为命名常量保存在持久化的场景生成脚本中。如果请求要求提供渲染交付物，请勿使用视口截图作为最终证据。

以可重复性为目标创作

1. 为相机、灯光、世界节点、视图层、渲染设置和输出节点赋予有意义的名称。
2. 明确设置引擎、分辨率、帧范围、采样、降噪策略、透明胶片和色彩管理；切勿依赖启动文件的默认设置。
3. 先通过精心选择的焦距和相机高度为主体取景，再增加采样数或添加后期处理。
4. 为形体布光：先确定主光、补光、轮廓光／背景分离、接触阴影和曝光，再添加美化效果。保留足够的中性验证光照，以便发现相交问题和纹理缺陷。
5. 仅在能改善所需结果时使用渲染通道和合成器节点。保留未合成的成品渲染输出，以便诊断。
6. 对于转台动画和动画输出，先渲染一段低成本的短预览；然后锁定相机和灯光，再渲染最终帧范围。
7. 对于渲染农场或外部引擎，生成一份独立完整的交接清单，列出 Blender 版本、引擎、设备假设、资源、字体、缓存路径、帧范围和输出设置。

根据证据迭代

对于常规资源交付，默认附上精修的主视觉展示。使用能衬托资源轮廓的背景、较柔和的主光／补光、受控的高光、清晰可见的接触阴影，以及能让细节清楚呈现的构图。匹配材质颜色，避免白底白物或过曝的影棚布景。当距离和发光体尺寸同时按比例缩放时，按场景尺寸的平方调整灯光功率。

以验证渲染器的 auto、neutral、dark 或 light 展示模式为起点。检查首张图像，并在对比度、半透明效果、自发光或纹理需要调整时，修改预设或自定义影棚设置。如果两种展示方式各有用途，就用清晰的标签同时提供；不要在生成首个实用结果之前让用户选择预设。将固定诊断视图与主视觉一并保留，并遵循用户明确提出的艺术指导。影棚渲染不能替代必需的场景上下文截图。

1. 为每个必需的相机渲染一张低采样数诊断帧。
2. 打开渲染出的图像，而不只是检查文件是否存在的日志。
3. 检查构图、轮廓分离度、曝光、高光控制、阴影落地感、色彩平衡、纹理比例、噪点／火花点、裁切，以及材质效果是否符合要求。
4. 先修正场景、材质、相机或灯光方面的问题，再调整降噪、泛光、景深或色彩分级来掩盖问题。
5. 渲染最终静帧或有界预览序列。打开联系表；对于动态内容，还要打开编码后的视频或抽样帧。

完成门槛

在干净的 Blender 进程中确认源文件能够复现渲染结果，并且最终输出已通过视觉检查之前，不要宣称渲染完成。报告准确的输出路径、Blender 和引擎版本、分辨率、帧范围、采样／降噪设置、色彩管理、渲染通道、渲染时长，以及任何特定于机器的限制。使用 $blender-agent-studio:blender-asset-validation 获取固定的多视角几何证据；该证据是艺术指导下最终渲染的补充，而非替代。 对于发光主体周围的玻璃，应验证最终引擎的效果，而不能只检查节点图。控制透射、alpha／混合行为、折射、曝光和泛光，确保外罩呈现玻璃质感，且发光主体保留清晰、独立的彩色轮廓。即使材质在技术上具有透射性，不透明或过曝发白的外罩仍属于渲染失败。