bggg-creator-image2psd

BGGG Creator Image2PSD

用这个 skill 把图片资产组织成可编辑的 PSD 栅格图层。核心脚本是 scripts/image2psd.py，它不依赖 Photoshop 或 ImageMagick，能独立写出带图层名、透明通道和合成预览的 PSD。

Codex 适配默认策略

在 Codex 里处理图片转 PSD 时，默认配合 imagegen skill 的能力：

• 先用 Codex 的视觉理解能力判断图层结构、主体/背景/文字/装饰的边界、以及哪些区域需要重建背景。
• 如果用户要求从描述生成、补齐缺失元素、移除对象后补背景、或拆出更干净的独立商品/主体图，优先使用 imagegen skill 的内置生图/编辑能力生成项目内资产，再交给本 skill 组装 PSD。
• 如果用户明确要求“不改变相对位置”“直接在 Photoshop 拼接”，优先保留原图像素：每个图层输出为同尺寸全画布透明 PNG，只改变 alpha，不重绘内容。只有背景擦除/补洞可使用 inpaint 或 imagegen 辅助。
• 不要把 imagegen 的默认输出留在 $CODEX_HOME。项目要用的图片必须复制到本 skill 的项目目录。

项目目录约定

每次处理图片都创建独立项目目录，放在本 skill 文件夹下：

bggg-creator-image2psd/
└── projects/
    └── YYYYMMDD_slug/
        ├── original_reference.png
        ├── manifest.json
        ├── layer_sources/
        ├── psd_full_canvas_layers/
        ├── output.psd
        ├── output.preview.png
        ├── psd_full_canvas_layers.zip
        └── process_notes.md

命名规则：

• YYYYMMDD_slug 使用当前日期和简短英文/拼音任务名，例如 20260503_lifestyle_product.
• original_reference.png 是本次处理的源图副本。
• layer_sources/ 保存用于组装的透明图层源。
• psd_full_canvas_layers/ 保存 Photoshop 可直接按原位叠放的全画布 PNG 图层。
• process_notes.md 记录图层划分、是否使用 imagegen、验证结果和已知限制。

工作流

1. 判断任务类型：

   • 多张元素图已经存在：复制到项目目录，用 assemble，按图层顺序写 manifest。
   • 只有一张平面图且要保留相对位置：做语义/区域拆层，每层保持原图同尺寸；背景层用 inpaint 或 imagegen 辅助清理被拆出的区域。
   • 只有一张平面图且只要粗拆：用 split-colors 按颜色聚类拆层，并说明它不是语义对象拆层。
   • 用户要从描述生成 PSD：先用 Codex imagegen 分别生成背景、主体、文字/装饰等项目资产，再用 assemble 合成 PSD。

2. 创建 projects/YYYYMMDD_slug/，把源图和所有输出放进去。默认用脚本初始化：

   python3 bggg-creator-image2psd/scripts/init_project.py lifestyle_product \
     --source 用户附件.png \
     --date 20260503
   

   如果使用了 imagegen，先把 $CODEX_HOME 下的生成结果复制到该项目的 imagegen_assets/，再进入拆层或合成流程。

3. 确定画布尺寸。优先沿用源图尺寸；海报类任务需要明确宽高。

4. 处理透明：

   • 背景层用 remove_background: none。
   • Logo、文字、装饰图常用 remove_background: white。
   • 白帆、白色产品、浅色主体这类容易被白底吞掉的元素用 remove_background: white-preserve。
   • 非白色纯底用 corner 或 color。

5. 运行脚本输出 PSD、预览 PNG、可选的单层 PNG 目录/zip。

6. 验证输出：检查脚本 JSON 摘要里的 layer_count、预览 PNG、PSD 文件大小；用 Pillow 或 Photoshop/Photopea 检查 PSD 可读性。

7. 写 process_notes.md，记录图层、路径、验证和限制。