layer-pixel-art

图层像素艺术

概述

像素艺术是最容易生成得似是而非的任务：生成的图像看起来像像素艺术，却边缘柔和、经过抗锯齿处理，网格尺寸也不固定。要生成正确的像素艺术，关键在于排除默认设置。

除了生成外，Layer 还提供两个确定性的精灵图集工具。pack_sprite_sheet 会将单独的帧图像组装成统一单元格、透明背景的图集，split_sprite_sheet 则按阅读顺序将图集切分成单元格。它们会直接列出，而不是通过发现机制查找，因为它们是第一方工具，不是模型，目录中也没有其他可选方案。

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

指定网格和调色板

每次都要指定两者，并用数字表示。

• 网格：“32x32 精灵图”“16x16 瓷砖”。如果没有指定网格，模型生成的图像只会有些像像素艺术，分辨率也不确定，之后无法修正。
• 调色板：指定颜色数量和色系。“受限的 16 色调色板，柔和的大地色系”能约束输出，而“复古色彩”则不能。
• 时代：如果用户心中已有特定风格，则注明：8 位 NES 时代的平涂色彩、16 位 SNES 时代的明暗层次，或现代高分辨率像素艺术。这些风格截然不同。

在提示词中排除默认效果

缺陷是可预见的，所以要明确排除：不要抗锯齿、模糊、渐变、柔和阴影，只要硬边像素，每个单元格一个像素。如果模型提供 negative_prompt，就把这些要求放在那里。还要说明背景：“隔离在透明背景上”或“纯色背景”，因为生成的背景需要抠图，而草率抠图会破坏像素艺术。

精灵图集和行走循环

不要要求一次生成包含多帧的图集。模型会生成一组彼此相似但不完全相关的画作，而且角色在不同单元格之间会发生变化，而图集恰恰不能出现这种情况。

有效流程：

1. 生成并确认一帧：静止姿势或接触姿势，隔离在透明背景上。
2. 分别生成其余帧，并将已确认的帧作为 reference_image 附上，只描述变化之处：“同一角色、同一调色板、同一 32x32 网格，左腿向前迈步，右臂后摆。”
3. 将所有帧放在一起检查，重新生成偏离的帧。
4. 使用 pack_sprite_sheet 将它们组装成统一单元格的图集。输入架构是参数格式的权威依据，因此请先阅读，不要擅自猜测参数名称。

第一帧之后的每一帧都要引用第一帧，而不是前一帧。逐帧接续会累积偏差，因此到第四帧时，骑士可能已经变成了另一个骑士。

如果使用训练好的像素风格，请将其作为 reference_sets 附上，并完全省略 base_model_id，让服务端选择能够应用该风格的模型。循环中的每一帧都要使用相同的集合、相同的权重和相同的参考帧。

四帧循环（接触、下沉、经过、上升）就能呈现动作，而且比八帧可靠得多。从四帧开始，仅在动作确有需要时再增加帧数。

反过来，split_sprite_sheet 可以将用户现有的图集切分成单独帧，这样就能编辑其中一帧而不影响其他帧。

瓷砖

可无缝重复的像素瓷砖首先是平铺问题，其次才是像素问题，因此请筛选 tileability 能力，并阅读 layer-textures，了解如何指定缩放并避免明显重复。本页中关于网格、调色板和硬边的要求仍然适用。

操作示例

“一段适用于我们骑士精灵的 32x32 行走循环。”

1. 生成接触姿势。使用 list_base_models，设置 filter.use_case: "text_to_image"，取第一个结果，然后输入提示词：“32x32 像素艺术骑士精灵，身穿盔甲，侧视图，左脚向前的接触姿势，有限的 16 色调色板，16 位时代的阴影，边缘清晰的像素，无抗锯齿、无模糊、无渐变，置于透明背景上。”
2. 选定一个。此帧现在是其余所有内容的参考。
3. 再生成三次，每次对应一个剩余帧；每次都将选定的帧作为 reference_image 附加，并且只描述姿势变化。
4. 将四帧放在一起，检查调色板、身高和盔甲细节是否有偏差。重新生成任何出现偏差的帧。
5. 使用四个 file_id 值调用 pack_sprite_sheet，即可返回透明背景上的精灵图集。

常见错误

• 忘记指定网格大小，然后试图把柔和的图像缩小成像素图。
• 一次生成就要求生成完整的精灵图集。
• 忘记排除抗锯齿和模糊；这些是默认情况下需要排除的效果。
• 不使用参考帧，独立生成各帧，导致角色形象出现偏差。
• 还没做好四帧循环，就先生成八帧循环。
• 接受生成的背景，而不是要求透明背景。
• 手动拼接图集，而 pack_sprite_sheet 可以确定性地生成尺寸统一的单元格。