Community画像github.com

拼豆图案生成器

将用户提供的图片或文字创意转换成拼豆/热熔豆作品,输出精确的拼豆效果图、带色号施工网格、颜色图例、豆子用量清单,并可选生成小红书风展示图。

拼豆图案生成器 とは?

拼豆图案生成器是一种AI技能,能将图片、照片、文字创意等输入转换为精确的拼豆(Perler、Hama、Artkal等)图纸。它适用于制作像素风格的装饰品、人物、宠物、Logo等。该技能支持多种工作模式:图纸模式(默认)根据图片生成精确的豆位网格、效果图、施工图和物料清单;展示模式在图纸模式基础上生成小红书风格的桌面展示图;文字设计模式从零生成源图后再转入图纸模式。整个过程基于确定性脚本计算(如Pillow的render_bead_pattern.py),确保每个豆位、色号和数量都精确无误,禁止使用生成式图像替代施工图。用户可通过参数控制网格尺寸、颜色数量、适配方式、背景处理和锐化等。该技能强调真实还原和可执行性,适用于Claude Code、Cursor、Codex等开发者平台。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/billxfan/agent-skills/tree/HEAD/skills/make-perler-beads

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル README より

清晰色块预览
拼豆效果图

ドキュメント

拼豆图案生成器 は何をしますか?

将图片转换成既像原图、又能实际制作的拼豆图纸。先保证主体在无孔色块预览中清楚,再表现真实豆面。精确的豆位、色号和数量必须通过确定性脚本计算;图像生成只用于可选的氛围展示图。

判断请求模式

选择能满足请求的最小模式:

  • **图纸模式——有图片时默认使用:**原图 → 精确拼豆效果图 + 编号施工网格 + 配色与用量文件。
  • **展示模式:**先完成图纸模式,再根据效果图生成小红书风平铺图或产品展示图。不得把生成式展示图当作施工图。
  • **文字设计模式:**用户没有图片、只有文字创意时,先生成一张干净且主体集中的源图,再转入图纸模式。
  • **仅提示词模式:**只在用户明确要求时使用;返回提示词和推荐参数,不得声称已经生成图纸。

用户上传图片后只说“做成拼豆”时,直接使用图纸模式。能安全决定的参数不要反问用户。

读取相关指南

  • 选择网格尺寸、背景处理、色板或豆面样式前,读取 references/design-guide.md。
  • 返回产物前,读取 references/quality-gate.md 并完成检查。

输入约定

  1. 转换前检查真实原图,记录尺寸、宽高比、主体、背景复杂度、透明区域,以及重要文字或身份特征。
  2. 除非用户说明图片只用于风格参考,否则把它视为需要保留主体的编辑目标。
  3. 在网格能力允许的范围内,保留可见的身份特征、外轮廓、方向、物体数量、主要色块和必要的短文字。
  4. 若网格过小,无法容纳人脸、细字、复杂场景或细小标记,简洁说明限制并提高网格尺寸,不要虚构细节。
  5. 不得擅自删除有意义的背景。只有背景接近纯色,或用户明确要求主体抠图时,才使用自动去背景。
  6. 对多人、复杂场景先做“清晰度预算”:估算每个核心主体能分到多少豆格。若核心人脸、宠物头部或 Logo 宽度不足约 16 格,优先裁紧主体或提高网格,而不是直接生成。

图纸模式流程

  1. 用本地图片查看能力检查原图,并读取文件尺寸。
  2. 根据 references/design-guide.md 选择网格尺寸、色板、适配方式、背景处理和豆面样式。
  3. 找到带 Pillow 的 Python 环境。在 Codex 桌面端,先加载工作区依赖,再使用返回的内置 Python 路径。若没有 Pillow,说明依赖缺失;未经允许不要自行安装。
  4. 运行:
<带-Pillow-的-Python> scripts/render_bead_pattern.py 输入图片 输出目录 \
  --width-beads 48 \
  --max-colors 18 \
  --fit contain \
  --background keep \
  --render beads

从本 Skill 目录解析脚本与资源路径。用 --help 查看全部参数。复杂插画可增加 --sharpen 1.2;需要聚焦主体时使用 --crop "left,top,right,bottom";需要锁定小面积关键色时使用加引号的 --anchor-colors "#F2C76E,#8A315F"。需要从原图提取自适应色板时使用 --palette source;需要使用用户库存或品牌色板时,传入与 assets/generic-palette.json 结构一致的 JSON。

  1. 先查看无孔色块预览,判断构图与主体是否清楚;再查看豆面效果图和施工网格。不要只依赖命令输出。
  2. 分别在原尺寸和缩略尺寸下对比原图。若身份或轮廓丢失,优先裁紧主体或提高网格;若细线丢失,提高锐化;若关键色消失,锁定关键颜色。重试一次。
  3. 核对用量表合计是否等于所有非空网格的数量。

脚本会输出:

  • *-color-preview.png:无孔、无标签的清晰色块预览,用于判断主体辨识度;
  • *-bead-preview.png:由精确网格渲染的拼豆效果图;
  • *-pattern.png:带色号施工网格;
  • *-legend.png:颜色图例及每种颜色数量;
  • *-pattern.csv:逐格色号表;
  • *-bom.csv:材料用量表;
  • *-metadata.json:转换参数、颜色和总数。

展示模式流程

必须先完成图纸模式,再把生成的拼豆效果图作为编辑目标传入内置图像生成能力。

保持设计、网格比例、轮廓、朝向和主要颜色位置不变。只允许改变拍摄角度、底板材质、桌面、灯光、道具和背景。优先采用整洁的俯拍手作桌面、柔和自然光和少量相关工具,不要让手或道具遮挡作品。

若展示图明显改变了设计或豆位,用更严格的保持要求重试一次。先返回精确效果图与施工文件,再返回展示图,避免混淆。

文字设计模式流程

  1. 将用户要求收敛成一个居中、可辨认的轮廓或紧凑构图。
  2. 生成背景纯净或透明、色块宽阔、没有纹理与光照渐变、没有细小文字的源图。
  3. 把真实生成图片传入图纸模式。
  4. 明确说明这是根据文字创作的设计,不是对用户原图的转换。

返回格式

优先返回最实用的产物:

**清晰图案预览**

![清晰色块预览](色块预览绝对路径)

**拼豆效果图**

![拼豆效果图](效果图绝对路径)

**施工图与用量**

- 网格:[宽度] × [高度]
- 颜色:[颜色数量]
- 总豆数:[非空格数量]
- 施工网格:[可点击绝对路径]
- 色号图例:[可点击绝对路径]
- 用量表:[可点击绝对路径]

**转换设置**

- [网格 / 色板 / 适配 / 背景 / 豆面样式]
- [一句说明保留效果或必要取舍]

只有运行了展示模式,才另加 展示图。除非用户要求,不要输出内部日志或完整元数据 JSON。

强制规则

  • 效果图、施工网格、CSV、图例和用量必须来自同一份豆位矩阵。
  • 无孔色块预览与豆面效果图也必须来自同一份豆位矩阵;不得用另一张“更好看”的图冒充清晰预览。
  • 绝不能用生成式图片充当精确豆数施工图。
  • 绝不能把通用色板编号称为 Perler、Hama、Artkal 或其他厂商的官方色号。
  • 用户提供厂商色表时,将它作为数据使用并准确标注来源。
  • 小尺寸图案不要放长文字;改用首字母、短词或更大的网格。
  • 放大低精度 PNG 不等于提高还原度;必须增加豆格并重新计算。
  • 若两个核心主体在色块预览的缩略图中仍无法辨认,不得把结果描述为“清晰”或“完全还原”。

调用示例

  • “用 $make-perler-beads 把这张猫咪照片做成 48 格宽的拼豆图纸。”
  • “只保留人物,去掉背景,控制在 16 种颜色以内。”
  • “把这个 Logo 做成 29×29 的拼豆,给我施工网格和用量表。”
  • “拼豆图纸完成后,再生成一张小红书风的桌面展示图。”

関連スキル