Pixel Print Kit
输入图像，输出可打印套件。该脚本会检测像素网格（或将普通图像像素化），清理调色板，使用 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 # 像素化Logo，添加渲染图
仅在首次运行时：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（增加一个 10×2 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 结束。绝不交付失败的套件。
经验法则
- 真正的像素画优于像素化照片。 对于Logo，24-40 像素宽，3-5 种颜色效果最佳。
- 颜色 = 耗材。 将
--max-colors设置为等于或小于用户的 AMS 槽位数；建议的 PLA 名称仅是最接近的匹配，因此请让用户与自己的耗材盘进行比较。 - 交换顺序： 将最暗的颜色放在底部（轮廓优先）。浅色细节放在顶部保持清晰。
- 小像素： 40 mm 以下、32+ 像素的钥匙扣会产生脆弱细节；放大尺寸或简化图像。
- 来自游戏/品牌的像素画 是他人的知识产权：个人打印没问题，但不可用于销售。
何时阅读什么
references/print-notes.md- 切片器步骤（Bambu/Orca/Prusa）、公差、磁铁、故障排除。