# 让 Codex 帮你把位图 PPT 还原成可编辑分层 PPTX：SlideLift 安装与使用

整页都是一张大图的 PPT 或海报，还原成背景、人物、物品、文字底板各一层、文字可改的 PPTX。全程由 Codex 替你操作，你只需要复制粘贴两段话。

---

SlideLift 是 [imagePPTedit](/projects/image-ppt-edit/) 项目留下的开源代码：它把整页都是一张图的 PPT 或海报拆成背景、人物或物品、文字底板三层，文字重建成可编辑的文本框。它已经改成一个 skill，在你自己的 AI 编程工具里加载仓库就能跑，不用任何服务器和账号。这篇按 Codex 写，Claude Code 同理。

## 适用场景

- 用 AI 生成的图批量做 PPT，图好看但没法改，交付给客户的却必须能编辑。
- 手上只有导出的图片版课件或海报，要改几个字、挪一下标题。
- 想在自己电脑上跑，不把文件传到别人的服务器。

## 开始前的准备

- 一台 Mac，预留 3 GB 磁盘（依赖加模型权重）。
- 装好 Codex，并用 ChatGPT 账号登录过。
- 有 PowerPoint 或 LibreOffice 更好，它们用来生成质检对比图；没有也能出成品。
- Windows 目前不支持原生运行，要走 WSL2，见文末「边界与注意事项」。

## 操作步骤

### 第 1 步：让 Codex 帮你装（约 10 到 20 分钟，只做一次）

打开「终端」，输入 `codex` 回车，把下面这段话整段粘贴发送：

```text
帮我安装 SlideLift，按顺序做：
1. 用 git clone https://github.com/coolbreezecoin/imagePPTedit.git 下载到 ~/imagePPTedit（已存在就跳过）
2. 进入 ~/imagePPTedit 执行 bash setup.sh。它会下载约 630MB 模型，可能要跑十几分钟，一直等到它打印"安装完成"，中途不要中断
3. 再执行 .venv/bin/python -c "from rembg import new_session; [new_session(n) for n in ('u2net_human_seg','isnet-general-use')]" 预下载抠图模型
4. 装完告诉我：自检有没有通过，检测到的渲染器是 PowerPoint、LibreOffice 还是都没有
过程中需要网络或权限就直接申请，我会允许。
```

中途弹出的权限确认一律选允许。它说装好了就完成了，以后不用再做。

### 第 2 步：在程序目录里打开 Codex

每次使用都从这一行开始：

```bash
cd ~/imagePPTedit && codex
```

### 第 3 步：把文件交给它

把这段话发给它，路径改成你的文件。把文件拖进终端窗口，路径会自动出现：

```text
把 ~/Desktop/xxx.pptx 还原成分层可编辑的 PPTX。按本目录 SKILL.md 的六步流程做：起草标注和看质检对比图这两步你要亲自逐页做，有问题按 troubleshooting 改完只重跑那一页。做完告诉我成品路径，并把 qa 里的对比图给我看一眼。
```

如果是图片，开头改成「把 ~/Desktop/海报1.png 和 ~/Desktop/海报2.jpg 还原成分层可编辑的 PPTX」，其余不变。

### 第 4 步：等它跑完，拿成品

一页一到几分钟，二十页的课件半小时上下，弹权限确认就选允许。成品在 `~/imagePPTedit/output/` 里，文件名以 `_分层可编辑.pptx` 结尾，用 PowerPoint 打开即可。

### 第 5 步：要改东西直接说

它只重跑那一页，例如：

- 第 3 页的标题往左挪一点
- 第 5 页第二行的「的」是错字，应该是「地」
- 第 2 页的人物别单独成层，留在背景里

## 常见问题

**老是弹权限确认怎么办？** 在自己电脑上可以放开沙箱启动：`cd ~/imagePPTedit && codex -s danger-full-access`。这会让它不再逐项询问，只在你信任这台电脑和这个目录时用。

**PowerPoint 报错 -9074 或卡住？** 彻底退出 PowerPoint，让它重跑那一页。还不行就对它说「改用 LibreOffice 渲染，命令前加 SLIDELIFT_RENDERER=libreoffice」。仓库要放在用户目录下，macOS 的 PowerPoint 访问不了 /tmp 这类系统路径。

**哪些内容效果不好？** 躺姿或严重遮挡的人物可能抠不全，超宽横幅精度受损，密排小字默认整块保真成层。毛笔书法和特效艺术字会保留为图片层，不转字体，转了必失真。

**文件会传到哪里？** 抠图、擦除、组装都在你电脑上跑；页面图片会发给 OpenAI 用于看图标注，这是 Codex 工作的一部分。介意的话不要处理含敏感信息的文件。

**怎么更新？** 对 Codex 说「进入 ~/imagePPTedit 执行 git pull 和 bash setup.sh」。

## 边界与注意事项

- 这是一个已停项目留下的代码，不再主动维护。问题可以在仓库里提，能不能改看情况。项目为什么停、内测数据是多少，都在[项目页](/projects/image-ppt-edit/)。
- Windows 用户要先装 WSL2 里的 Ubuntu，在里面执行 `sudo apt install -y zsh git curl libreoffice fonts-noto-cjk`，Codex 也装在 WSL 里；之后步骤相同，第 3 步那段话末尾加一句「所有 pipeline 命令前面都要加 SLIDELIFT_RENDERER=libreoffice」。这条路线没有完整验证过。
- 只想把 PPTX 每页转成图片，不需要装环境，用站内的[PPT 转图片](/tools/ppt-to-images/)就行，它就是这条流水线里质检那一步。

---

本文同步自凉风Lab。原文与后续更新：https://liangfenglab.com/guides/slidelift-with-codex/
