跳到主要内容

像素艺术

带年代调色板的像素艺术(NES、Game Boy、PICO-8)。

Skill 元数据​

Source可选 — 使用 kopi skills install official/creative/pixel-art 安装
Pathoptional-skills/creative/pixel-art
Version2.0.0
Authordodo-reach
LicenseMIT
Platformslinux, macos, windows
Tagscreative, pixel-art, arcade, snes, nes, gameboy, retro, image, video

参考:完整 SKILL.md​

信息

以下是 Kopi Agent 在触发此 skill 时加载的完整 skill 定义。这就是 skill 处于激活状态时 agent 所看到的指令。

像素艺术

将任意图像转换为复古像素艺术,然后可选地将其制作成带有年代感特效(雨、萤火虫、雪花、余烬)的短 MP4 或 GIF 动画。

此 skill 附带两个脚本:

  • scripts/pixel_art.py — 照片 → 像素艺术 PNG(Floyd-Steinberg 抖动)
  • scripts/pixel_art_video.py — 像素艺术 PNG → 动画 MP4(+ 可选 GIF)

每个脚本既可导入也可直接运行。预设可吸附到硬件调色板,用于获得年代还原的色彩(NES、Game Boy、PICO-8 等);也可使用自适应 N 色量化,实现街机/SNES 风格的观感。

何时使用​

  • 用户希望从源图像生成复古像素艺术
  • 用户要求 NES / Game Boy / PICO-8 / C64 / 街机 / SNES 风格
  • 用户想要一段循环播放的短动画(雨景、夜空、雪景等)
  • 海报、专辑封面、社交帖、精灵图、角色、头像

工作流程​

生成之前,请与用户确认风格。不同预设的输出差异很大,而重新生成的成本较高。

第 1 步 — 提供风格选择​

调用 clarify,展示 4 个代表性预设。根据用户的诉求挑选组合 — 不要把全部 14 个都堆出来。

当用户意图不明确时的默认菜单:

clarify(
question="Which pixel-art style do you want?",
choices=[
"arcade — bold, chunky 80s cabinet feel (16 colors, 8px)",
"nes — Nintendo 8-bit hardware palette (54 colors, 8px)",
"gameboy — 4-shade green Game Boy DMG",
"snes — cleaner 16-bit look (32 colors, 4px)",
],
)

当用户已经指定了年代(例如"80 年代街机""Gameboy")时,跳过 clarify,直接使用对应的预设。

第 2 步 — 提供动画选择(可选)​

如果用户要求视频/GIF,或输出效果适合加入动态,询问其想要哪种场景:

clarify(
question="Want to animate it? Pick a scene or skip.",
choices=[
"night — stars + fireflies + leaves",
"urban — rain + neon pulse",
"snow — falling snowflakes",
"skip — just the image",
],
)

不要连续调用 clarify 超过两次。一次用于风格,若动画已被纳入考量,再一次用于场景。如果用户在其消息中已明确要求了特定风格和场景,则完全跳过 clarify。

第 3 步 — 生成​

先运行 pixel_art();如果需要动画,则在结果上继续串联执行 pixel_art_video()。

预设目录​

预设年代调色板像素块最佳用途
arcade80 年代街机自适应 16 色8px醒目的海报、主视觉
snes16 位自适应 32 色4px角色、精细场景
nes8 位NES (54)8px纯正 NES 观感
gameboyDMG 掌机4 级绿色8px单色 Game Boy
gameboy_pocketPocket 掌机4 级灰色8px单色 GB Pocket
pico8PICO-816 固定色6px幻想主机风格
c64Commodore 6416 固定色8px8 位家用电脑
apple2Apple II hi-res6 固定色10px极致复古,6 色
teletextBBC Teletext8 纯色10px粗颗粒原色
mspaintWindows MS Paint24 固定色8px怀旧桌面
mono_greenCRT 荧光绿2 色绿6px终端/CRT 美学
mono_amberCRT 琥珀2 色琥珀6px琥珀显示器观感
neon赛博朋克10 霓虹色6px蒸汽波/赛博
pastel柔和粉彩10 粉彩色6px可爱 / 温柔

命名调色板存放于 scripts/palettes.py(完整列表见 references/palettes.md — 共 28 个命名调色板)。任何预设都可以被覆盖:

pixel_art("in.png", "out.png", preset="snes", palette="PICO_8", block=6)

场景目录(用于视频)​

场景特效
night闪烁星光 + 萤火虫 + 飘落的叶子
dusk萤火虫 + 闪光
tavern尘埃微粒 + 暖色闪光
indoor尘埃微粒
urban雨 + 霓虹脉冲
nature落叶 + 萤火虫
magic闪光 + 萤火虫
storm雨 + 闪电
underwater气泡 + 光点闪光
fire余烬 + 闪光
snow雪花 + 闪光
desert热浪扰动 + 尘埃

调用方式​

Python(导入)​

import sys
sys.path.insert(0, "/home/teknium/.kopi/skills/creative/pixel-art/scripts")
from pixel_art import pixel_art
from pixel_art_video import pixel_art_video

# 1. Convert to pixel art
pixel_art("/path/to/photo.jpg", "/tmp/pixel.png", preset="nes")

# 2. Animate (optional)
pixel_art_video(
"/tmp/pixel.png",
"/tmp/pixel.mp4",
scene="night",
duration=6,
fps=15,
seed=42,
export_gif=True,
)

CLI​

cd /home/teknium/.kopi/skills/creative/pixel-art/scripts

python pixel_art.py in.jpg out.png --preset gameboy
python pixel_art.py in.jpg out.png --preset snes --palette PICO_8 --block 6

python pixel_art_video.py out.png out.mp4 --scene night --duration 6 --gif

流水线设计原理​

像素转换:

  1. 提升对比度/色彩/锐度(调色板越小,提升越强)
  2. 色调分离(posterize),在量化前简化色调区域
  3. 使用 Image.NEAREST 按 block 缩小尺寸(硬像素,无插值)
  4. 使用 Floyd-Steinberg 抖动进行量化 — 基于自适应 N 色调色板或命名硬件调色板
  5. 使用 Image.NEAREST 放大还原

在缩小尺寸之后再量化,可以让抖动与最终像素网格对齐。若在缩小之前量化,误差扩散会浪费在随后消失的细节上。

视频叠加:

  • 每一帧复制基础帧(静态背景)
  • 叠加无状态的逐帧粒子绘制(每个特效一个函数)
  • 通过 ffmpeg libx264 -pix_fmt yuv420p -crf 18 编码
  • 可选 GIF 通过 palettegen + paletteuse 生成

依赖项​

  • Python 3.9+
  • Pillow(pip install Pillow)
  • PATH 中的 ffmpeg(仅视频需要 — Kopi Agent 会安装该软件包)

常见问题​

  • 调色板(Pallet)键名区分大小写("NES"、"PICO_8"、"GAMEBOY_ORIGINAL")。
  • 尺寸非常小的源图(<100px 宽)在 8-10px 色块下会糊成一片。如果源图很小,请先进行放大。
  • block 或 palette 使用小数值会破坏量化——请保持为正整数。
  • 动画粒子数量是针对约 640x480 画布调校的。对于非常大的图像,你可能需要用不同的 seed 再跑一遍以调整密度。
  • mono_green / mono_amber 会强制 color=0.0(去饱和)。如果你覆盖该设置并保留色度,双色调色板可能在平滑区域产生条纹。
  • clarify 循环:每轮对话最多调用两次(先选风格,再选场景)。不要让用户连续做太多选择。

验证​

  • PNG 已在输出路径创建
  • 图像上可见预设色块大小的清晰方形像素块
  • 颜色数量与预设一致(目测图像或运行 Image.open(p).getcolors())
  • 视频是有效的 MP4(ffprobe 可以打开),且大小非零

致谢​

命名硬件调色板以及 pixel_art_video.py 中的程序化动画循环均移植自 pixel-art-studio(MIT)。详情请参阅本 skill 目录下的 ATTRIBUTION.md。