KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

PDF2PPT

★ 30 Open GitHub ↗

Test repo for hosted deployment refactor of PDF2PPT

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PDF2PPT

> 将扫描版 PDF、课件截图和图片型文档转换为尽量高保真、尽量可编辑的 PPTX。

![Python](https://img.shields.io/badge/Python-3.11+-3776AB?logo=python&logoColor=white)
![FastAPI](https://img.shields.io/badge/FastAPI-009688?logo=fastapi&logoColor=white)
![Next.js](https://img.shields.io/badge/Next.js-000000?logo=nextdotjs&logoColor=white)
![Docker](https://img.shields.io/badge/Docker-2496ED?logo=docker&logoColor=white)
![License](https://img.shields.io/badge/License-MIT-green.svg)

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/ZiChuanLan/PDF2PPT)
[![Deploy on Zeabur](https://zeabur.com/button.svg)](https://zeabur.com/templates/UKLIVV)

[中文](./README.md) | [English](./README_EN.md)

[在线文档](https://zichuanlan.github.io/PDF2PPT/) · [在线体验](#在线体验) · [快速开始](#快速开始) · [部署选项](#部署选项) · [License](#license)

`PDF2PPT` 是一个面向实际使用和部署的开源服务。  
它不是简单地把 PDF 每页导成一张图，而是尽量把页面重建为可编辑文本、独立图片区域和清理后的页面底图，再导出为 PowerPoint。

## 在线体验

| 项目 | 地址 / 信息 |
| --- | --- |
| 演示站点 | <https://ppt.015201314.xyz/> |
| 访问密码 | `lanPDF2PPT2026!` |

## 介绍

处理扫描版 PDF、课件截图和图片型文档时，常见做法往往只是整页截图导出，后续几乎无法编辑。  
`PDF2PPT` 的目标不是“把 PDF 贴进 PPT”，而是尽量把页面重建为可编辑文本、独立图片区域和页面底图，在保留原稿观感的同时提高后续编辑能力。

| 典型问题 | PDF2PPT 的处理方式 |
| --- | --- |
| 每页只能导成一张大图 | 尽量拆出文本层、图片块和页面底图 |
| OCR 只是附加能力 | OCR 与页面重建是核心链路 |
| 只能本地试一下 | 支持 Web、API、Worker 和标准部署 |
| 路线单一，难以调优 | 可切换本地 OCR、远程 OCR 与文档解析链路 |

## 为什么用它

- 不只是截图式导出，而是尽量把页面重建为文本层、图片块和页面底图
- 不只适合单机试用，也适合部署成 Web、API、Worker 的完整服务
- 不绑定单一路线，可以在本地 OCR、远程 OCR 和文档解析链路之间切换

## 适合谁

- 需要处理扫描版 PDF、课件截图、图片型报告的个人用户
- 想把 PDF 转 PPT 能力做成内部服务的团队或开发者
- 希望把转换流程接入自动化、脚本或 MCP 客户端的集成方

## 核心能力

- 高保真页面重建，优先兼顾原稿观感与可编辑性
- 支持本地 OCR、远程 OCR、百度文档解析、MinerU 等多种链路
- 提供 Web 上传、任务跟踪、结果下载和 API 接入
- 支持标准 Docker 部署、Hosted 单服务模式、Render 和 Zeabur

## 界面预览

| 跟踪页面 | 任务记录 |
| --- | --- |
| ![PDF2PPT 跟踪页面](https://i.postimg.cc/pVshZ5t5/gen-zong-ye-mian.png) | ![PDF2PPT 任务记录](https://i.postimg.cc/3rt4B0Hy/ren-wu-ji-lu.png) |

| AIOCR 设置 | 云端 MinerU 设置 |
| --- | --- |
| ![PDF2PPT AIOCR 设置](https://i.postimg.cc/CMcBNnVq/she-zhi-aiocr.png) | ![PDF2PPT 云端 MinerU 设置](https://i.postimg.cc/gcgXDLPR/she-zhi-yun-duanmineru.png) |

## 快速开始

### 本地体验

```bash
make dev-local
```

默认会启动：

- Web: `http://localhost:3000`
- API: `http://127.0.0.1:8000`

### 完整部署

适合完整部署 `web + api + worker + redis`：

```bash
cp .env.example .env
docker compose up -d --build
```

常用检查命令：

```bash
docker compose ps
docker compose logs -f
curl http://127.0.0.1:8000/health
```

### 轻量托管后端

适合先在云平台验证后端：

```bash
cp .env.example .env
docker compose -f docker-compose.hosted.yml up -d --build
```

推荐两种方式：

- 最低成本验证：`REDIS_URL=memory://`
- 接入托管 Redis：`REDIS_URL=<your-redis-url>` 且 `EMBEDDED_WORKER_CONCURRENCY=1`

## 部署模式

首次访问时会进入初始化向导，选择部署模式并创建管理员账号。

| 模式 | 适合场景 | 登录方式 | API 密钥管理 |
| --- | --- | --- | --- |
| 自用模式 | 个人使用 | 自动登录（退出后需手动登录） | 用户自行配置 |
| 公开模式 | 团队/公开部署 | 用户名密码登录 | 管理员统一配置 |

- **自用模式**：首次访问自动登录，无需注册。退出后需输入密码重新登录。
- **公开模式**：支持多用户注册（可关闭）、邀请码、配额管理。管理员在站点配置中统一管理 API 密钥。

## 基本使用流程

1. 上传 PDF
2. 提交转换参数并创建任务
3. 等待任务完成后下载 `output.pptx`

首次运行如果想优先求稳，建议从 `remote_ocr + aiocr + fullpage` 开始。

## 部署选项

| 模式 | 适合场景 | 入口 |
| --- | --- | --- |
| 本地体验 | 本机快速试用与调试 | `make dev-local` |
| 完整部署 | 长期运行或生产部署 | [`docker-compose.yml`](docker-compose.yml) |
| 轻量托管后端 | 云平台快速验证后端 | [`docker-compose.hosted.yml`](docker-compose.hosted.yml) |
| Render | 一键部署 | [`render.yaml`](render.yaml) |
| Zeabur | 模板化部署 | [`zeabur.template.yaml`](zeabur.template.yaml) |

## 文档

更详细的架构、OCR 链路、MCP 集成、部署细节和 FAQ 已迁移到文档站：

- [文档站首页](https://zichuanlan.github.io/PDF2PPT/)
- [功能详解](https://zichuanlan.github.io/PDF2PPT/guide/feature-tour)
- [设置与高级设置](https://zichuanlan.github.io/PDF2PPT/guide/settings-reference)
- [部署指南](https://zichuanlan.github.io/PDF2PPT/guide/deployment)
- [MCP 集成](https://zichuanlan.github.io/PDF2PPT/guide/mcp-integration)
- [FAQ 与排障](https://zichuanlan.github.io/PDF2PPT/guide/faq)

## License

MIT. See [LICENSE](LICENSE).

PDF2PPT

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README