layer-textures

图层纹理

概览

纹理不是表面的图像，而是一张左右边缘相接、上下边缘相接的图像，因此用它铺满平面时不会出现接缝。除非在运行时提出这一要求，否则模型不会自动做到这一点。

必要步骤是能力筛选：使用 list_base_models，并设置 filter.capabilities: {tileability: true}。注意其结构：capabilities 是由布尔值组成的对象， 而不是名称列表。不具备该能力的模型生成的石头图像一旦重复铺贴，就会出现明显接缝，之后再怎么编辑也无法修复。本页的其他内容都不如正确设置筛选条件重要。

生成机制详见 layer 技能。如果你可用的技能中缺少此处提到的某个同级技能，请让用户安装它（npx skills add layerai/skills --skill <name>）； 如果是在无人值守的情况下运行，则根据工具架构继续操作，并标记这一缺失。

说明比例

比例决定了纹理是否可用，也是最常被遗漏的字段。说明纹理覆盖的实际表面面积：“一块 2 米见方的鹅卵石路面，大约有二十块石头宽”才算是纹理。“鹅卵石”可能指一块巨石，也可能指整座城市广场，模型会自行决定。

以特征而不是整块纹理为基准：“单块木板宽约 15cm”“草叶长约 5cm”“砖层为标准尺寸”。引擎会缩放材质，但前提是纹理中的密度一开始就合适。

光照平坦，不要突出特征

以下两条提示词最能解决剩下的问题：

• 均匀、漫射、平坦的光照，不要有方向性阴影。 烘焙阴影是仅次于接缝的第二大缺陷。由左上方照亮的纹理，在引擎光源不位于左上方时看起来都会不对，而且之后无法去除。
• 分布均匀，不要有焦点，也不要有单一的显著特征。 生成模型喜欢构图，因此可能会在正中间放一块醒目的开裂石头。铺满地面后，这道裂缝就会变成重复排列的一组相同裂缝，成为每位玩家都会注意到的东西。

改为要求变化一致：“磨损和颜色变化均匀分布于整块纹理，不要有单一的主导特征。”

评估结果

不要只看单块纹理来评估，而要看铺贴后的效果。检查四条边能否彼此衔接，再检查 3x3 重复铺贴后是否形成了图案。单独看效果出色、但在 3x3 铺贴时出现明显节奏感的纹理，就是失败的纹理。

如果接缝没问题，但某个特征重复得太明显，通常应通过加强均匀性描述重新生成，而不是编辑；因为局部移除该特征会重新引入接缝。

材质贴图

用于有光照的引擎场景时，纹理通常不止需要颜色。如果模型声明支持 PBR 或材质输出，应在同一次运行中一并获取，而不是事后根据颜色贴图推导法线，这会导致表面看起来很平。get_base_model 是了解特定模型输出内容的权威来源。

像素艺术贴图除了遵循这些规则，还有自身的规则：参见 layer-pixel-art。

操作示例

“为我们的地下城打造一片无缝的苔藓石地面。”

1. 使用 list_base_models，设置 filter.use_case: "text_to_image" 和 filter.capabilities: {tileability: true, square: true}。选择第一个结果。如果没有 tileability，这次运行就白费了。
2. 使用 get_base_model，查看它是否提供也必须设置的平铺参数，以及它能输出哪些材质。
3. 提示词：“无缝可平铺的纹理：磨损的地下城石板，缝隙间长着苔藓，覆盖约 2 平方米，横向约有 8 块石板。均匀的漫射平光，无定向阴影，无投射阴影。磨损和苔藓均匀分布在整块纹理上，没有焦点，也没有单一突出的裂缝或特征。俯视正交视角。”
4. 先估算，再使用 batch_size: 4 执行，以便有多个选项。
5. 选择前，先将每个候选结果按 3x3 平铺进行评估。

常见错误

• 跳过 tileability 筛选条件，之后的任何步骤都无法弥补。
• 未注明比例，导致平铺上要么只有一块巨石，要么有上千块微小石头。
• 接受烘焙在平铺纹理中的定向光照。
• 加入醒目的主体特征，导致重复平铺时出现明显网格。
• 只单独评估平铺纹理，而不是以 3x3 方式平铺后评估。
• 明明模型可以直接返回法线贴图，却从颜色贴图生成法线贴图。
• 要求以透视视角呈现表面，而不是俯视正交视角。