bggg-creator-image2ppt

BGGG Creator Image2PPT

用这个 skill 把平面视觉稿转换成可编辑的 .pptx。核心设计是“先形成结构化 manifest，再由脚本生成 PPTX”。

• 二进制图片输入：Codex 负责识别版式、文字和组件；默认调用 imagegen skill 生成或清理背景、装饰、产品、图表等组件图片；文本尽量还原为 PowerPoint 文本框。
• HTML/SVG 输入：优先把代码结构解析为原生 PPT 元素；复杂节点再降级为图片组件。
• 所有中间图片、manifest、诊断和输出都必须放在本 skill 的 projects/YYYYMMDD_slug/ 目录里。

Codex 默认策略

在 Codex 中处理 PNG/JPEG/WebP 等二进制图片时，默认执行这个顺序：

1. 使用 Codex 视觉能力观察源图，列出幻灯片尺寸、背景、标题、正文、图标、照片、图表、装饰、阴影、遮罩等对象。
2. 对于可编辑文字，直接写入 manifest 的 text 元素，不要把文字只做成图片。
3. 对于背景、照片、图标、复杂插画、图表、纹理、遮挡后需要补全的背景，使用 imagegen skill 生成、清理或重建独立组件图片。
4. 把 imagegen 生成的图片复制到当前项目目录的 imagegen_assets/ 或 component_images/，不要让项目依赖 $CODEX_HOME 的临时输出。
5. 写 manifest.json，用 scripts/image2pptx.py build 生成 PPTX。
6. 验证 PPTX 能被 python-pptx 重新打开，并记录图层/文本/图片数量和已知限制。

如果用户明确要求“不重绘”“保持原图像素”，可以用原图裁切或全画布透明 PNG 作为组件图片；但默认仍要用 Codex imagegen 能力辅助背景清理、缺失区域补全和组件干净化。

项目目录约定

每次转换都创建独立项目目录：

bggg-creator-image2ppt/
└── projects/
    └── YYYYMMDD_slug/
        ├── original_inputs/
        ├── component_images/
        ├── imagegen_assets/
        ├── diagnostics/
        ├── manifest.json
        ├── output.pptx
        ├── summary.json
        └── process_notes.md

初始化：

python3 bggg-creator-image2ppt/scripts/init_project.py pitch_deck \
  --source /path/to/reference.png \
  --date 20260504

二进制图片转 PPTX 工作流

1. 初始化项目，把源图复制到 original_inputs/。

2. 识别页面结构：

   • 画布比例和大致尺寸。
   • 背景是纯色、渐变、照片还是复杂插画。
   • 每段文字的内容、位置、字号、颜色、粗细、对齐方式。
   • 组件图片的边界、层级和是否需要透明背景。

3. 默认用 imagegen 生成或编辑组件：

   • 背景：完整画布、无文字、无前景组件。
   • 照片/产品/人物/图标/复杂装饰：干净边缘，必要时透明背景。
   • 图表：能原生重建就用形状和文本；复杂图表可先做成图片组件。

4. 把组件图片放入 component_images/ 或 imagegen_assets/。

5. 写 manifest，元素按从底到顶排序。

6. 运行：

   python3 bggg-creator-image2ppt/scripts/image2pptx.py build \
     --manifest bggg-creator-image2ppt/projects/YYYYMMDD_slug/manifest.json \
     --output bggg-creator-image2ppt/projects/YYYYMMDD_slug/output.pptx \
     --summary bggg-creator-image2ppt/projects/YYYYMMDD_slug/summary.json