拼豆圖案生成器 是做什麼的?
將圖片轉換成既像原圖、又能實際製作的拼豆圖紙。先保證主體在無孔色塊預覽中清楚,再表現真實豆面。精確的豆位、色號和數量必須透過確定性腳本計算;圖像生成只用於可選的氛圍展示圖。
判斷請求模式
選擇能滿足請求的最小模式:
- **圖紙模式——有圖片時預設使用:**原圖 → 精確拼豆效果圖 + 編號施工網格 + 配色與用量文件。
- **展示模式:**先完成圖紙模式,再根據效果圖生成小紅書風平鋪圖或產品展示圖。不得把生成式展示圖當作施工圖。
- **文字設計模式:**使用者沒有圖片、只有文字創意時,先生成一張乾淨且主體集中的源圖,再轉入圖紙模式。
- **僅提示詞模式:**只在使用者明確要求時使用;返回提示詞和推薦參數,不得聲稱已經生成圖紙。
使用者上傳圖片後只說「做成拼豆」時,直接使用圖紙模式。能安全決定的參數不要反問使用者。
讀取相關指南
- 選擇網格尺寸、背景處理、色板或豆面樣式前,讀取
references/design-guide.md。 - 返回產物前,讀取
references/quality-gate.md並完成檢查。
輸入約定
- 轉換前檢查真實原圖,記錄尺寸、寬高比、主體、背景複雜度、透明區域,以及重要文字或身份特徵。
- 除非使用者說明圖片只用於風格參考,否則把它視為需要保留主體的編輯目標。
- 在網格能力允許的範圍內,保留可見的身份特徵、外輪廓、方向、物體數量、主要色塊和必要的短文字。
- 若網格過小,無法容納人臉、細字、複雜場景或細小標記,簡潔說明限制並提高網格尺寸,不要虛構細節。
- 不得擅自刪除有意義的背景。只有背景接近純色,或使用者明確要求主體摳圖時,才使用自動去背景。
- 對多人、複雜場景先做「清晰度預算」:估算每個核心主體能分到多少豆格。若核心人臉、寵物頭部或 Logo 寬度不足約 16 格,優先裁緊主體或提高網格,而不是直接生成。
圖紙模式流程
- 用本地圖片查看能力檢查原圖,並讀取檔案尺寸。
- 根據
references/design-guide.md選擇網格尺寸、色板、適配方式、背景處理和豆面樣式。 - 找到帶 Pillow 的 Python 環境。在 Codex 桌面端,先載入工作區依賴,再使用返回的內建 Python 路徑。若沒有 Pillow,說明依賴缺失;未經允許不要自行安裝。
- 運行:
<帶-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。
- 先查看無孔色塊預覽,判斷構圖與主體是否清楚;再查看豆面效果圖和施工網格。不要只依賴命令輸出。
- 分別在原尺寸和縮略尺寸下對比原圖。若身份或輪廓丟失,優先裁緊主體或提高網格;若細線丟失,提高銳化;若關鍵色消失,鎖定關鍵顏色。重試一次。
- 核對用量表合計是否等於所有非空網格的數量。
腳本會輸出:
*-color-preview.png:無孔、無標籤的清晰色塊預覽,用於判斷主體辨識度;*-bead-preview.png:由精確網格渲染的拼豆效果圖;*-pattern.png:帶色號施工網格;*-legend.png:顏色圖例及每種顏色數量;*-pattern.csv:逐格色號表;*-bom.csv:材料用量表;*-metadata.json:轉換參數、顏色和總數。
展示模式流程
必須先完成圖紙模式,再把生成的拼豆效果圖作為編輯目標傳入內建圖像生成能力。
保持設計、網格比例、輪廓、朝向和主要顏色位置不變。只允許改變拍攝角度、底板材質、桌面、燈光、道具和背景。優先採用整潔的俯拍手作桌面、柔和自然光和少量相關工具,不要讓手或道具遮擋作品。
若展示圖明顯改變了設計或豆位,用更嚴格的保持要求重試一次。先返回精確效果圖與施工文件,再返回展示圖,避免混淆。
文字設計模式流程
- 將使用者要求收斂成一個居中、可辨認的輪廓或緊湊構圖。
- 生成背景純淨或透明、色塊寬闊、沒有紋理與光照漸變、沒有細小文字的源圖。
- 把真實生成圖片傳入圖紙模式。
- 明確說明這是根據文字創作的設計,不是對使用者原圖的轉換。
返回格式
優先返回最實用的產物:
**清晰圖案預覽**

**拼豆效果圖**

**施工圖與用量**
- 網格:[寬度] × [高度]
- 顏色:[顏色數量]
- 總豆數:[非空格數量]
- 施工網格:[可點擊絕對路徑]
- 色號圖例:[可點擊絕對路徑]
- 用量表:[可點擊絕對路徑]
**轉換設定**
- [網格 / 色板 / 適配 / 背景 / 豆面樣式]
- [一句說明保留效果或必要取捨]
只有運行了展示模式,才另加 展示圖。除非使用者要求,不要輸出內部日誌或完整元資料 JSON。
強制規則
- 效果圖、施工網格、CSV、圖例和用量必須來自同一份豆位矩陣。
- 無孔色塊預覽與豆面效果圖也必須來自同一份豆位矩陣;不得用另一張「更好看」的圖冒充清晰預覽。
- 絕不能用生成式圖片充當精確豆數施工圖。
- 絕不能把通用色板編號稱為 Perler、Hama、Artkal 或其他廠商的官方色號。
- 使用者提供廠商色表時,將它作為資料使用並準確標註來源。
- 小尺寸圖案不要放長文字;改用首字母、短詞或更大的網格。
- 放大低精度 PNG 不等於提高還原度;必須增加豆格並重新計算。
- 若兩個核心主體在色塊預覽的縮圖中仍無法辨認,不得把結果描述為「清晰」或「完全還原」。
呼叫範例
- 「用
$make-perler-beads把這張貓咪照片做成 48 格寬的拼豆圖紙。」 - 「只保留人物,去掉背景,控制在 16 種顏色以內。」
- 「把這個 Logo 做成 29×29 的拼豆,給我施工網格和用量表。」
- 「拼豆圖紙完成後,再生成一張小紅書風的桌面展示圖。」