# Bggg Creator Image2ppt

把图片、截图、海报、PPT 页面截图、HTML 或 SVG 设计稿转换成可编辑 PPTX 的 Codex skill。 当用户需要...

- Repository: https://github.com/binggandata/bggg-skills (612 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-08-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add binggandata/bggg-skills --skill bggg-creator-image2ppt -g -a claude-code -y`
Codex: `npx skills add binggandata/bggg-skills --skill bggg-creator-image2ppt -g -a codex -y`
Cursor: `npx skills add binggandata/bggg-skills --skill bggg-creator-image2ppt -g -a cursor -y`
Gemini CLI: `npx skills add binggandata/bggg-skills --skill bggg-creator-image2ppt -g -a gemini-cli -y`

## Description

把图片、截图、海报、PPT 页面截图、HTML 或 SVG 设计稿转换成可编辑 PPTX 的 Codex skill。 当用户需要 image2ppt、image2pptx、图片转 PPT、截图转 PPT、PNG/JPEG 转可编辑幻灯片、 HTML/SVG 转 PPTX、把设计图拆成图片组件和文本框再拼成 PowerPoint、 或希望复用 Codex 内置生图能力把平面图重建为多元素可编辑 PPT 时，应该使用此 skill。 在 Codex 中处理二进制图片时，默认结合 imagegen skill：先用 Codex 视觉理解版式， 再用内置图片生成/编辑能力生成或清理多个组件图片，最后用本 skill 的脚本拼装 PPTX。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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 能力辅助背景清理、缺失区域补全和组件干净化。

## 项目目录约定

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

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

初始化：

```bash
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. 运行：

The rest: https://github.com/binggandata/bggg-skills/blob/HEAD/bggg-creator-image2ppt/SKILL.md