Community图像github.com

paper-brush

使用确定性代码绘制扁平剪纸风格插图(头像、角色、场景、图标),无需图像模型。可用于创建统一风格的系列作品或为项目添加配图。

paper-brush 是什么?

paper-brush 是一个基于 Python 的确定性渲染器,专门生成扁平剪纸风格的插图。它通过代码堆叠彩色纸片形状来构建图像,每个形状沿钢笔工具路径切割。相同的绘图文件输入保证完全一致的像素输出,使得整个系列风格统一,且任何形状都可以通过编辑少量数字来微调。该工具支持任意画面比例、纸张颜色和尺寸。 它适用于 Claude Code、Cursor、Codex 等 AI 编码助手,以及任何支持 Python 脚本的开发环境。工作流程包括:设置绘图文件、从参考图像提取节点、渲染输出、以及迭代调整。特别适合在已有风格系列中新增作品时保持一致性,支持通过头部坐标系复用面部特征(如眼睛、眉毛、耳朵),确保不同头像看起来出自同一只手。 该工具不依赖任何图像生成模型,而是通过算法实现可预测、可编辑的矢量风格输出。需要 numpy 和 opencv-python 库支持。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hanlianlu/paper-brush/tree/HEAD/skills/paper-brush

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Paper brush(纸艺画笔)

一个用于扁平剪纸插画的确定性渲染器:每张图片都是一小叠彩色纸片形状,每个形状沿钢笔工具路径切割。相同的绘图文件输入保证完全一致的像素输出,因此整个系列风格统一,任何形状都可以通过编辑少量数字来微调。支持任意画面比例、纸张颜色和尺寸。

引擎设置(每个项目一次): 渲染器以代码块形式托管在 references/engine.md 中。使用命令复制出来,切勿手动重新输入:awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine.md > DIR/paper.py,其中 DIR 是项目的艺术文件夹(或临时文件夹);同样的命令可将 references/example_drawings.md 转换为一个初始绘图文件。使用 python3 paper.py ... 运行(需要 numpy 和 opencv-python)。以下命令假定已存在该文件。如果 paper.py 已存在于目标位置,则重复使用。

风格(严格遵守)

开始绘图前请阅读 references/style.md。简而言之:少量大形状;少量节点搭配长弧线;真实拐角标记为转角;每种材质使用 2-3 种色调(基色、阴影、有时加亮色);阴影是剪切在其父形状内部的整洁形状,通常一边硬边一边渐变;形状周围无轮廓;线条仅出现在钢笔线条应有的位置(眉毛、睫毛、嘴巴、褶皱),且始终渐尖;仅腮红使用模糊效果;暖白纸张配色,加上一层细腻均匀的颗粒覆盖全局。

工作流程

  1. 在项目中建立绘图文件(例如 Tools/art/drawings.py),内容包含 DRAWINGS = {"name": {...}}。具体格式见 paper.py 的文档字符串(不带参数运行 python3 paper.py 会打印出来)。从 references/example_drawings.md 中的绘图文件开始。
  2. 选择创作网格,如果可用,还需一张放置在该网格上的参考图(素描、绘画、已批准的图像)。从参考图上按已知比例读取节点坐标;一个小 lambda 函数如 h = lambda *p: [(x/2, y/2, *r) for x, y, *r in p] 可将参考图像的像素转换为网格单位。
  3. 从蒙版粗略提取形状(如有帮助):制作一个区域的黑白蒙版(颜色阈值、手绘蒙版),然后运行 python3 paper.py nodes MASK.png [scale]——它会打印节点并自动找到转角。随后手动精简和整理这些节点;手动处理才是使其看起来像剪纸而非描图的关键。
  4. 渲染:python3 paper.py path/to/drawings.py OUT_DIR [name …] → OUT_DIR/<name>.png。
  5. 观察、对比、调整。 将结果与参考图(或已批准的系列作品)并排放在实际观看尺寸下,例如 ffmpeg -i a.png -i b.png -filter_complex hstack cmp.png,然后打开查看。每次只修正一个问题:一个节点、一种色调、一个剪切区域。通常需要多轮调整;得到负责人批准后方可提交。
  6. 交付 时使用项目的尺寸和格式(使用 Lanczos 算法缩小;JPEG 质量约 88 或 PNG)。图片尺寸不超过 2K。如果项目需要在作品上加水印,则在批准后、发送前添加。

匹配现有风格系列

当新图片必须加入已有风格的系列(例如在已批准的头像旁添加新头像)时,流程为先整理规则,再画,然后迭代:

  1. 研究参考图并写下规则。 放大测量:边缘如何构建、每种材质的色调、阴影形状的位置及其细度、头部坐标轴上的特征大小和位置、头部占据画面的比例、纸张颜色和颗粒。
  2. 校准:使用画笔重新绘制一张参考图,将其与原图并排放置,不断调整直到匹配。
  3. 提取承载风格的部分(眼睛、眉毛、耳内轮廓)从参考图中提取:python3 paper.py lift REF.png X Y [tol] --eyes x1,y1,x2,y2 可以打印出坐标 X,Y 下方像素所在的扁平形状节点(基于该头部的坐标轴)。叠加检查;如果种子点落在皮肤上则移动位置。
  4. 在源图上绘制:python3 paper.py grid SOURCE.jpg grid.png 会生成一张带网格的副本(每 20 像素一条线,每 100 像素标注刻度)用于读取坐标。每个形状节点数量要少:脸部约 16 个,头发区域 20-40 个。
  5. 在展示给任何人之前进行混合测试:将新图片与参考图交错排列成一个缩略图网格(约 480 像素宽)。如果某张新图能被一眼认出,说明尚未完成。然后将其与最接近的参考图并排以全尺寸检查。

不奏效的做法:凭空想象形状(每张脸都会千篇一律);根据颜色描摹真实感绘画(会复制其瑕疵);自动矢量化参考图(效果斑驳);直接复制真实面孔的特征位置(嘴巴位置过低,面部显长显老);从绘画的暗部区域直接取用阴影形状(会留下污渍般的痕迹)。

典型的面部在头部坐标轴上的位置(请测量你自己的系列):眉毛大约在 y -0.8,与眼线平行;鼻子是远侧的一个短钩,x -0.3 至 -0.65,y 0.45 至 1.15;嘴巴约 1.1 单位宽,位于 y 1.6 至 1.8,几乎与眼睛平行,两端大致在同一高度(一端翘起表示微笑);下巴 y 2.8 至 3.1。给每个角色赋予其独特的发型轮廓、眼睛和眉毛形状以及配色,否则整个系列会趋向千篇一律。对于紧密的卷发、辫子和羊毛,使用 scallop();对于针织领口,使用 ribs();对于镜片和按钮,使用 oval()(从 paper import scallop, ribs, oval 导入)。

面部:可复用部件

为了创建匹配的面部系列,为每个绘图设置 "eyes": ((x, y), (x, y))。这定义了头部自身的坐标轴(x 沿眼线方向,y 沿面部向下,单位 = 眼距的一半),因此特征可以编写一次并在任何头部上复用:

  • {"head": True, "stroke": [...], "w": 0.12, "color": ...} —— 节点以头部单位表示(宽度也是)。
  • {"part": ("setname", "eye_l"), "fill": ..., "scale": 1.1, "shift": (0, 0.05), "turn": 4} —— 来自 parts.py 的部件放置在绘图文件旁:PARTS = {"setname": {"eye_l": {"nodes": [...]}, ...}},节点以头部单位表示。从已批准的图片中一次性提取部件(使用 nodes 追踪部件的蒙版,转换为头部单位),然后每张新面孔重复使用它们,这样整个系列看起来像是出自同一双手。
  • "mirror": True 可使面部转向另一方,无需重新绘制。

注意事项

  • 形状按顺序绘制;"clip" 仅能看到同一 "name" 下已绘制的形状。
  • 多个图层使用相同的 "name" 会合并(并集),适合由两个部分组成的身体。
  • "fade" 点使用网格坐标:在第一个点处强,在第二个点处消失。
  • "soft" 使用网格单位;仅用于腮红和发光效果。
  • 绘图可以 from paper import flow, scallop, ribs, oval:引擎文件夹已在路径上。
  • 不要让绘图演变成大量微小形状或轮廓;如果某个细节需要一条线,请先考虑用第二种色调的形状是否能更好地表达它。

相关技能