Community影像github.com

拼豆圖案生成器

將使用者提供的圖片或文字創意轉換成拼豆/熱熔豆作品,輸出精確的拼豆效果圖、帶色號施工網格、顏色圖例、豆子用量清單,並可選生成小紅書風展示圖。

拼豆圖案生成器 是什麼?

這是一個專為開發者與 AI 代理使用者設計的拼豆圖案生成技能,能將照片、人物、寵物、角色、Logo、圖示、截圖、插畫或任意圖片轉換為可實際製作的拼豆(Perler、Hama、Artkal、fuse-bead、像素豆)圖紙。它支援三種模式:預設的圖紙模式(使用 Python 腳本精確渲染豆位、色號與用量)、展示模式(在圖紙完成後生成小紅書風格的平鋪或產品展示圖)、以及文字設計模式(先根據文字創意生成乾淨源圖再轉圖紙)。本技能會先讀取 `references/design-guide.md` 選擇網格尺寸、色板與背景處理方式,並在產出前透過 `references/quality-gate.md` 進行品質檢查。它強制要求效果圖、施工網格、CSV、圖例與用量清單必須來自同一份豆位矩陣,絕不允許使用生成式圖片冒充精確施工圖,並保障主體辨識度與身份特徵的保留。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 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 的拼豆,給我施工網格和用量表。」
  • 「拼豆圖紙完成後,再生成一張小紅書風的桌面展示圖。」

相關技能