Pindou

第零步：判断图片类型

收到用户图片后，先用视觉能力判断图片类型，再决定走哪个流程：

识别线索：立体拼豆作品通常有明显的颗粒质感、规整的圆形/方形排列、熨烫后的光泽、多个面片组合的立体结构。

标准转换流程

1. 用户提供图片和参数

从用户的自然语言中提取以下参数：

2. 执行转换

cd ~/.claude/skills/pindou
python3 scripts/convert.py <图片路径> [参数...]

脚本输出 JSON 到 stdout，包含输出文件列表和用量统计。

3. 呈现结果给用户

转换完成后：

1. 用 Read 工具展示生成的全局图纸 PNG（让用户直接看到效果）
2. 展示用量统计（使用了多少种颜色、每种多少颗）
3. 告知输出文件位置
4. 询问是否需要调整（换色板、开抖动、替换颜色等）

4. 调整（如需要）

用户可能要求：

• "换成 Hama 色板" → 重跑 --palette hama_midi
• "开抖动" → 重跑 --dither floyd --dither-strength 50
• "这个颜色太多了，我没有 H15 和 H23" → 重跑 --exclude H15,H23
• "导出 PDF" → 重跑加 --pdf

快捷模式

如果用户一句话给了所有参数，直接构造命令执行，不用逐个询问。

示例映射：

可用色板

查看所有色板：

python3 scripts/convert.py --list-palettes

查看某色板所有颜色：

python3 scripts/convert.py --list-colors hama_midi

当前内置：

透明图片处理

上传带透明通道的 PNG 时：

• 透明区域自动识别为"不放豆"（空格）
• 空格在图纸中显示为浅灰色
• 用量统计中单独标注空格数量
• 空格不计入总豆数

多板拼接

使用 --grid RxC 指定拼接布局：

• 总尺寸 = 单板尺寸 × 拼接数（如 2x3 × 29x29 = 58x87）
• 输出：1 张全局总览（红色线标注板间分界）+ 每板独立图纸
• 每板图纸标注位置编号（如 "Board R1C2"）

立体拆件流程

当用户要求将物体/角色转换为立体拼豆作品时：

Step 1：分析结构（你来做）

看用户提供的参考图片，分析其3D结构，输出拆件方案 JSON：

{
  "name": "造型名称",
  "panels": [
    {
      "id": "body_front",
      "name": "躯干正面",
      "width": 30,
      "height": 40,
      "connects_to": ["body_left", "body_right"],
      "color_map": {
        "regions": [
          {"x": 0, "y": 0, "w": 30, "h": 20, "color_hint": "yellow"},
          {"x": 0, "y": 20, "w": 30, "h": 20, "color_hint": "white"}
        ]
      }
    }
  ],
  "assembly_order": ["body_front", "body_left", "body_back", "body_right"]
}

Step 2：用户确认方案

展示拆件方案，让用户确认或调整面片数量、尺寸。

Step 3：生成面片图纸

将确认的方案 JSON 保存为文件，执行：

python3 scripts/panel_generator.py plan.json --palette artkal_s --output-dir ./output/

Step 4：展示结果

展示每个面片的图纸 PNG、卡槽位置、用量统计、组装顺序。

故障排除