ppt-image-to-editable-ppt

分类: 开发与编程 | 上传者: GuopengLin | 下载: 0 | 版本: v1.0（最新）

将 PPT 幻灯片屏幕截图或导出的幻灯片图像转换为可编辑的 PowerPoint 幻灯片。当 Codex 需要从一张或多张幻灯片图像中提取图像/图标/材质资源作为单独的 PNG、使用可编辑文本框、本机形状和可移动图片对象重建幻灯片、批处理多个页面图像以及将重建的页面合并为完整的 .pptx 文件时使用。

更新日志: Source: GitHub https://github.com/GuopengLin/Image2PPT

目录结构

当前层级: tree/main/

📁 assets/
- 📄 logo.png 592.9 KB
📁 references/
- 📄 auto-extract.md 2.4 KB
- 📄 layout-json.md 2.2 KB
- 📄 reconstruction-sop.md 1.5 KB
📁 scripts/
- 📁 deck/
  - 📄 build_pptx_from_layout.py 24.8 KB
  - 📄 combine_layouts.py 2.7 KB
- 📁 icon/
  - 📄 __init__.py 1.2 KB
  - 📄 detect.py 17.9 KB
  - 📄 inpaint.py 2.1 KB
- 📁 ocr/
  - 📄 ocr_cross_verify.py 23.0 KB
  - 📄 ocr_paddle.py 7.7 KB
  - 📄 ocr_review_apply.py 8.2 KB
  - 📄 ocr_review_autoclear.py 6.3 KB
  - 📄 prepare_ocr.py 22.1 KB
  - 📄 render_annotated_review.py 8.2 KB
- 📁 optional/
  - 📄 find_template_logos.py 11.6 KB
  - 📄 rmbg_postprocess.py 5.7 KB
- 📁 page/
  - 📄 _heuristics.py 19.6 KB
  - 📄 build_inventory.py 46.8 KB
  - 📄 erase_text.py 38.0 KB
  - 📄 inventory_to_layout.py 101.6 KB
  - 📄 run_pipeline.py 36.9 KB
- 📁 tables/
  - 📄 detect_tables.py 11.8 KB
  - 📄 table_recognize.py 11.1 KB
- 📁 verify/
  - 📄 inspect_pptx.py 2.6 KB
  - 📄 render_preview.py 3.8 KB
- 📄 bootstrap.sh 4.6 KB
- 📄 build_deck.py 10.9 KB
- 📄 image_sources.py 2.1 KB
- 📄 warmup.py 3.4 KB
📄 .gitattributes 19 B
📄 .gitignore 430 B
📄 AGENTS.md 1.4 KB
📄 LICENSE 1.8 KB
📄 README.md 5.5 KB
📄 README_EN.md 3.0 KB
📄 requirements.txt 113 B
📄 SKILL.md 3.8 KB

SKILL.md

---
name: ppt-image-to-editable-ppt
description: Convert PPT slide screenshots or exported slide images into editable PowerPoint decks. Use when Codex needs to extract image/icon/material assets from one or many slide images as separate PNGs, rebuild the slides with editable text boxes, native shapes, and movable picture objects, batch-process multiple page images, and merge the reconstructed pages into a complete .pptx file.
---

# PPT Image To Editable PPT

## Overview

Turn slide images into a reconstructed, editable PowerPoint deck. Text
stays as real editable PowerPoint text. Icons, logos, photos and
decorative bands come out as separate movable PNG picture objects.
Cards, frames, circles and rules are rebuilt as native shapes/lines
where the source geometry is simple enough.

This skill is for slide screenshots or exported slide images. If a
native `.pptx` already exists, edit that directly.

Supported input formats use `page_NN.<ext>` naming and include PNG,
JPG/JPEG, WebP, BMP, and TIF/TIFF. Extracted assets and previews are
written as PNG.

## Dependencies

Run the bootstrap script from the repository root:

```bash
bash scripts/bootstrap.sh
```

It installs the Python packages in `requirements.txt`, local OCR tools,
LibreOffice, Poppler, and model caches where the platform supports
automatic installation. On managed systems, install these manually and
use `bash scripts/bootstrap.sh --no-system`.

## Run Directory

Every job goes under:

```text
output_project/<name>_<YYYYMMDD_HHMMSS>/
├── slides.pptx
├── qa.json
├── previews/
├── ocr/
├── inventory/
├── manifests/
├── layouts/
├── assets/
└── debug/
```

## Workflow

Prepare source images:

```text
slides/
├── page_01.png
├── page_02.jpg
└── page_03.webp
```

Run:

```bash
RUN="output_project/demo_$(date +%Y%m%d_%H%M%S)"
SRC="slides"

python scripts/ocr/prepare_ocr.py \
  --source-dir "$SRC" \
  --work-dir "$RUN"

python scripts/ocr/ocr_review_apply.py --work-dir "$RUN"

python scripts/build_deck.py \
  --source-dir "$SRC" \
  --work-dir "$RUN"
```

`prepare_ocr.py` loads PaddleOCR once, runs OCR across all pages, builds
review packets for uncertain entries, and pre-fills `corrected_text`
with local consensus picks. `ocr_review_apply.py` merges those picks into
the OCR JSON files. `build_deck.py` runs erase, inventory extraction,
layout generation, deck assembly, QA inspection, and preview rendering.

## Optional Review

After `build_deck.py`, check whether it reports OCR entries that may
benefit from manual review. If the user wants the extra pass:

1. Open `ocr/page_NN.ocr_review.annotated.png`.
2. Edit `ocr/page_NN.ocr_review.json`.
3. Set `corrected_text` to the desired text, or to `""` when the OCR
   detection is not real editable text.
4. Rerun:

```bash
python scripts/ocr/ocr_review_apply.py --work-dir "$RUN"
python scripts/build_deck.py --source-dir "$SRC" --work-dir "$RUN"
```

## Useful Flags

- `--pages 1,4,8`: process only selected pages.
- `--skip-render`: skip LibreOffice preview generation.
- `--detect-tables`: enable optional native table reconstruction.
- `--icon-review`: emit icon-vs-text review packets.
- `--icon-decisions`: apply filled icon review decisions on a rerun.

## Validation Standard

A job is done when:

- meaningful visual assets are present as PNG picture objects or native
  shapes;
- ordinary text is editable in the PPTX;
- extracted PNG assets are independent objects, not a flattened full-page
  background;
- `inspect_pptx.py` reports no failures;
- previews have been compared with the source images, or the final
  response states why preview rendering was skipped or unavailable.

Final responses should include the final `.pptx` path, the preview
directory, the QA report, and any known fidelity differences.

登录后下载/点赞/收藏 ❤ 8 | ★ 0

ppt-image-to-editable-ppt

目录结构

SKILL.md

举报内容

提示