pptopic/README.md

pptopic

将 PowerPoint 演示文稿导出为长图的工具。

功能

• 将 PPTX 文件的所有幻灯片垂直拼接为一张长图
• 支持 JPG 和 PNG 格式输出
• 支持自定义输出宽度和目录
• 内置图片优化功能，使用图片优化引擎进行无损压缩

新手使用说明

如果你是第一次使用命令行工具，请按以下步骤操作。

准备工作

• PowerPoint：需要安装 Microsoft PowerPoint（Office 2016 或更新版本）
• 网络连接：安装过程中需要下载工具

第一步：安装 uv

uv 是一个 Python 包管理器，用来安装 pptopic 及其依赖。

打开 PowerShell（在开始菜单搜索 "PowerShell"），进入本项目的目录：

cd pptopic

运行项目自带的安装脚本：

.\uv-installer.ps1

该脚本会自动下载最新版本的 uv 并添加到系统 PATH。如果你在中国大陆，脚本已内置 GitHub 加速镜像，无需额外配置。

安装完成后，关闭并重新打开 PowerShell，验证安装：

uv --version

如果你已安装 scoop，也可以直接 scoop install uv。 如果想安装特定版本的 uv，可以在运行脚本前设置环境变量：$env:UV_INSTALLER_VERSION = "0.11.20"

第二步：安装 Python

使用 uv 安装 Python 3.13 或更新版本：

uv python install 3.13

第三步：安装 pptopic

uv pip install -e .

第四步（可选）：安装 pngquant 图片优化工具

虽然是可选安装，但我超级建议你安装，因为ppt导出后，图片通常较大，不进行图片无损压缩，会导致文件大小过大。

如果你需要对导出的图片进行压缩优化，运行：

.\install-pngquant.ps1

该脚本会：

1. 如果你已安装 scoop → 通过 scoop 安装 pngquant
2. 如果没有 scoop → 自动下载并安装到 %APPDATA%\pngquant，并添加到 PATH

安装完成后，重新打开 PowerShell，验证安装：

pngquant --version

自定义安装目录：.\install-pngquant.ps1 -InstallDir "D:\Tools\pngquant" 强制重新安装：.\install-pngquant.ps1 -Force

第五步：开始使用

# 导出 PPTX 为长图
pptopic export presentation.pptx

# 优化图片
pptopic optimize image.png

至此安装完成。如果任何步骤遇到问题，请参考下方详细说明。

安装

安装 uv

使用项目自带的安装脚本（推荐）：

.\uv-installer.ps1

该脚本自动检测 uv 最新版本，支持国内 GitHub 加速镜像下载（mirror.ghproxy.com、ghproxy.net），并自动将 uv 添加到系统 PATH。

也可以通过 scoop 安装：

scoop install uv

安装 pptopic

cd pptopic
uv sync
uv pip install -e .

使用

导出 PPTX 为长图

# 基本用法
pptopic export presentation.pptx

# 指定输出文件名
pptopic export presentation.pptx --output result.png

# 优化导出的图片
pptopic export presentation.pptx --optimize -o result.png

# 自定义宽度和最大高度
pptopic export presentation.pptx --width 1080 --optimize --max-height 20000

单独优化图片

# 优化图片
pptopic optimize image.png

# 指定输出文件
pptopic optimize image.png --output optimized.png

# 自定义优化参数
pptopic optimize image.png --max-height 20000 --engine pngquant

系统要求

• Windows 系统（使用 win32com 调用 PowerPoint）
• Python >= 3.13
• Microsoft PowerPoint

图片优化

为了获得最佳的图片压缩效果，推荐使用 pngquant 进行图片压缩。

自动安装脚本

使用提供的 PowerShell 脚本安装 pngquant：

.\install-pngquant.ps1

该脚本支持两种安装方式：

1. 已安装 scoop → 通过 scoop install pngquant 安装
2. 未安装 scoop → 从 pngquant 官网下载并安装到 %APPDATA%\pngquant，自动添加到 PATH

# 自定义安装目录
.\install-pngquant.ps1 -InstallDir "D:\Tools\pngquant"

# 强制重新安装
.\install-pngquant.ps1 -Force

# 不修改 PATH
.\install-pngquant.ps1 -NoModifyPath

手动安装

scoop install pngquant

或从 pngquant.org 下载 Windows 版本手动配置。

License

MIT License