像素艺术
带年代调色板的像素艺术(NES、Game Boy、PICO-8)。
Skill 元数据
| Source | 可选 — 使用 kopi skills install official/creative/pixel-art 安装 |
| Path | optional-skills/creative/pixel-art |
| Version | 2.0.0 |
| Author | dodo-reach |
| License | MIT |
| Platforms | linux, macos, windows |
| Tags | creative, 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()。
预设目录
| 预设 | 年代 | 调色板 | 像素块 | 最佳用途 |
|---|---|---|---|---|
arcade | 80 年代街机 | 自适应 16 色 | 8px | 醒目的海报、主视觉 |
snes | 16 位 | 自适应 32 色 | 4px | 角色、精细场景 |
nes | 8 位 | NES (54) | 8px | 纯正 NES 观感 |
gameboy | DMG 掌机 | 4 级绿色 | 8px | 单色 Game Boy |
gameboy_pocket | Pocket 掌机 | 4 级灰色 | 8px | 单色 GB Pocket |
pico8 | PICO-8 | 16 固定色 | 6px | 幻想主机风格 |
c64 | Commodore 64 | 16 固定色 | 8px | 8 位家用电脑 |
apple2 | Apple II hi-res | 6 固定色 | 10px | 极致复古,6 色 |
teletext | BBC Teletext | 8 纯色 | 10px | 粗颗粒原色 |
mspaint | Windows MS Paint | 24 固定色 | 8px | 怀旧桌面 |
mono_green | CRT 荧光绿 | 2 色绿 | 6px | 终端/CRT 美学 |
mono_amber | CRT 琥珀 | 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
流水线设计原理
像素转换:
- 提升对比度/色彩/锐度(调色板越小,提升越强)
- 色调分离(posterize),在量化前简化色调区域
- 使用
Image.NEAREST按block缩小尺寸(硬像素,无插值) - 使用 Floyd-Steinberg 抖动进行量化 — 基于自适应 N 色调色板或命名硬件调色板
- 使用
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。