像素列印套件 是做什麼的？
圖片輸入，可列印套件輸出。此腳本會偵測像素網格（或將一般圖片像素化）、清理調色板、使用manifold3d建構水密各色幾何體，並以切片軟體的方式檢查結果。
快速開始
SKILL_DIR = 包含此檔案的資料夾（可用時為 ${CLAUDE_SKILL_DIR}）。路徑請用引號括起來。
python "$SKILL_DIR/scripts/pixelkit.py" sprite.png # 45 mm 鑰匙圈，每種顏色一個部件
python "$SKILL_DIR/scripts/pixelkit.py" sprite.png --product magnet --style swap # 單噴頭印表機
python "$SKILL_DIR/scripts/pixelkit.py" logo.png --pixels 32 --max-colors 4 --render # 將標誌像素化，加入渲染
首次使用：python -m pip install manifold3d numpy pillow（若缺少任何套件，腳本會自動提示）。
輸出在 pixelkit-out/<name>/ 資料夾中：stl/（每個顏色一個檔案）、<name>.3mf（一個物體，每個顏色一個部件，按插槽順序命名為 01_black、02_...）、guide.md（燈絲、設定、換層高度）、kit.json、preview.png（平面顏色檢查），使用 --render 時還有：hero.jpg、top.jpg、turntable.mp4。
選擇產品與樣式
| 用戶想要 | 標誌參數 |
|---|---|
| 鑰匙圈（預設） | --product keychain（45 mm，2.2 mm 外框，Ø4.2 mm 環孔） |
| 冰箱磁鐵 | --product magnet（加入一個10x2 mm磁鐵的凹槽；使用 --magnet 8x3 變更尺寸） |
| 杯墊 | --product coaster（95 mm 圓形） |
| 牆飾牌 / 標誌牌 | --product plaque（120 mm 圓角矩形） |
| 僅藝術本體 | --product tile（無外框） |
| 有 AMS / 多材料 | --style ams（預設）：顏色齊平，僅在頂層進行顏色變化 |
| 單噴頭，無 AMS | --style swap：一個本體，每個顏色一個高度階層；指南列出每次燈絲更換的層數 |
實用參數：--size 60（成品外部尺寸，mm）· --grid-gap 0.3（像素間的溝槽，很有「像素」感）· --raise 0.6（ams：顏色凸起）· --shape silhouette|rect|round· --border 0· --hole 0· --hole-pos left|center|right· --base-color "#hex"（外框顏色）· --order "#a,#b,..."（swap：從底部到頂部）· --max-colors 4（匹配用戶的 AMS 插槽數量）· --keep-bg（不透明背景視為藝術的一部分）。
工作流程
- [ ] 執行 pixelkit.py；閱讀控制台：網格大小、顏色 -> 燈絲、檢查通過
- [ ] 查看 preview.png：調色板是否正確？（若出現多餘的反鋸齒顏色 -> 提高 --merge 或降低 --max-colors）
- [ ] 像素尺寸 >= 0.8 mm（否則會出現警告 -> 加大 --size 或減少 --pixels）
- [ ] 使用 --render 並在交付前閱讀 hero.jpg / top.jpg
- [ ] 告知用戶：尺寸、燈絲插槽，以及針對 swap 樣式的 guide.md 中的換層高度
檢查項目（open edges 0、overlap 0）必須通過；否則腳本會以代碼 2 退出。切勿交付失敗的套件。
經驗法則
- 真正的像素藝術優於像素化照片。 對於標誌，寬度 24-40 像素與 3-5 種顏色效果最佳。
- 顏色 = 燈絲數量。 將
--max-colors保持等於或低於用戶的 AMS 插槽數量；建議的 PLA 名稱僅為最接近的匹配，因此請用戶與自己的線軸進行比對。 - 交換順序： 最深的顏色放在底部（外框優先）對大多數藝術作品有效。淺色細節放在頂部保持清晰。
- 小像素： 小於 40 mm 且 32 像素以上的鑰匙圈會產生脆弱的特徵；請增大尺寸或簡化藝術。
- 來自遊戲/品牌的像素藝術 是他人知識產權：個人列印沒問題，但不得用於銷售。
何時閱讀什麼
references/print-notes.md- 切片軟體步驟（Bambu/Orca/Prusa）、公差、磁鐵、故障排除。