用途：将图片资产组织成可编辑的 PSD 栅格图层，支持单图语义拆层、多图合成、颜色聚类拆层，以及把 Codex/AI 生图结果拆成元素图再合成 PSD。核心脚本 scripts/image2psd.py 不依赖 Photoshop 或 ImageMagick，可独立写出带图层名、透明通道和合成预览的 PSD。
主要能力：assemble 从 manifest 或多张图合成 PSD；split-colors 按颜色聚类拆层；支持 remove_background 的 none、white、white-preserve、corner、color 选项；文字层可用 type: text 渲染，但为栅格文字而非 Photoshop 可编辑文字。
使用方式：每次处理创建独立项目目录 projects/YYYYMMDD_slug/，可用 python3 bggg-creator-image2psd/scripts/init_project.py 初始化。常用命令示例： python3 bggg-creator-image2psd/scripts/image2psd.py assemble --manifest work/manifest.json --output work/output.psd --preview work/output.preview.png --save-layers work/layers --zip-layers work/layers.zip
适用场景：多张元素图合成、海报/设计稿拆层、白底转透明、Codex 生图结果二次组装等。
限制：文字层非可编辑文字对象；split-colors 不是语义对象拆层；若未验证 Photoshop 打开效果，需说明验证限于脚本和预览；不要把 imagegen 默认输出留在 $CODEX_HOME，项目用图需复制到项目目录。