sd-learned-recipes

name	sd-learned-recipes
description	从 SD 内置 30 个 PBR 材质逆向分析的材质配方库。包含 7 个类别配方 + 3 个通用功能配方， 涵盖混凝土/金属/瓷砖/砖墙/布料/木材/有机物的节点图结构、管线设计和制作逻辑。 Use when AI needs to: (1) choose appropriate nodes for a material type, (2) reference professional material graph structure, (3) understand common SD material building patterns, (4) select texture sources for different material categories, (5) plan a material pipeline before building. Substance Designer only (run_python).
metadata	{"artclaw":{"version":"1.0.1","author":"ArtClaw","software":"substance_designer"}}

SD 材质配方库

从 SD 12.1.0 全部 30 个内置 PBR 材质逆向分析，提炼出可复用的制作配方。 制作任何材质前，先查此库选择正确的管线设计和纹理源。

配方文件索引

通用配方（所有材质适用）

文件	内容	何时读取
recipes/_overview.md	总览 + 跨材质统计 + 选择指南	必读：开始前
recipes/output_pipeline.md	输出通道标准管线（Height优先原则）	必读：构建输出时
recipes/coloring.md	着色管线：灰度→彩色的三种方案	需要 BaseColor 时
recipes/weathering.md	做旧/风化/污渍叠加的三级策略	需要真实感时

类别配方（按需读取）

文件	材质数	适用
recipes/concrete.md	10 个	混凝土/水泥/路面
recipes/metal.md	5 个	金属/金属板/锈蚀
recipes/tile.md	5 个	瓷砖/地砖/马赛克
recipes/brick.md	2 个	砖墙/砌体
recipes/fabric.md	3 个	布料/织物/编织
recipes/wood.md	2 个	木材/木板/木纹
recipes/organic.md	3 个	碎石/纸张/纸板

快速决策树

要做什么材质？
├→ 硬质表面
│   ├→ 有规则排列？ → tile.md 或 brick.md
│   ├→ 金属？ → metal.md
│   └→ 粗糙不规则？ → concrete.md
├→ 有机/软质
│   ├→ 编织结构？ → fabric.md
│   ├→ 木纹方向性？ → wood.md
│   └→ 颗粒/纤维？ → organic.md
└→ 不确定 → 先读 _overview.md 的类别纹理源表

核心发现速查

1. Height 优先: 先构建灰度高度图，Normal/AO/Height 三通道从同一源分叉
2. Blend 是核心: 平均每材质 33 个 blend（SD 材质 = blend 叠加的艺术）
3. 着色在末端: 灰度处理完成后才进入着色环节
4. 做旧必备: moisture_noise(80%使用率) + bnw_spots(60%)
5. tile_generator 万能: 不只用于瓷砖，碎石(6个)、木板(5个)、混凝土(3个)都用

使用方法

# 在 SD 中读取配方
import os
recipes_dir = os.path.expanduser(r"~\.openclaw\workspace\skills\sd-learned-recipes\recipes")

# 先读总览
with open(os.path.join(recipes_dir, "_overview.md"), "r", encoding="utf-8") as f:
    overview = f.read()

# 再读对应类别
with open(os.path.join(recipes_dir, "concrete.md"), "r", encoding="utf-8") as f:
    recipe = f.read()