PPT Master 开源AI生成原生可编辑PPTX全攻略，零代码实现文档一键转演示文稿

本文介绍开源AI工具PPT Master，可一键将PDF/DOCX/网页等文档转换为原生可编辑的PPTX文件。该项目基于Python 3.10+运行，支持20+模板风格，输出内容完全可编辑，数据本地处理保障安全。相比同类工具，PPT Master开源免费、可定制模板、专业性强，特别适合咨询、学术等场景。

无巧不成书

1546人浏览 · 2026-04-27 16:05:43

无巧不成书 · 2026-04-27 16:05:43 发布

在这里插入图片描述

在这里插入图片描述

文章目录

2026最新 | PPT Master 开源AI生成原生可编辑PPTX全攻略，零代码实现文档一键转演示文稿

2026最新 | PPT Master 开源AI生成原生可编辑PPTX全攻略，零代码实现文档一键转演示文稿

🧠 核心内容思维导图

一、项目核心概述 📖

1.1 什么是PPT Master

PPT Master是一套开源的AI驱动PPT生成标准化工作流（Skill），可在具备Agent智能体（能自主读取文件、执行命令、完成多轮任务的AI）能力的AI IDE中运行，实现PDF、DOCX、XLSX/XLSM、网址、Markdown、PPTX等任意格式文档到原生可编辑PPTX文件的端到端转换。

项目核心设计哲学：AI是你的设计师，不是完工师。生成的PPTX是高质量的设计起点，而非无需修改的最终成品，工具的核心价值是帮用户消除90%从零开始的工作量，而非替代人在最后一公里的审美与内容判断。

与市面主流AI PPT工具本质区别：其生成的PPT所有元素（形状、文本框、图表、矢量图）均为PowerPoint原生可编辑对象，而非图片嵌入、网页截图或不可修改的模板填充，可直接在Office中进行精细化修改，无需二次排版重构。

项目官方仓库（2026年4月持续活跃维护，定期更新模板与功能）：

主仓库（GitHub）：https://github.com/hugohe3/ppt-master
国内镜像（AtomGit，自动同步，国内访问速度更优）：https://atomgit.com/hugohe3/ppt-master
在线效果预览：https://hugohe3.github.io/ppt-master/

1.2 核心优势特性

特性维度	详细说明
原生可编辑输出	生成的PPTX文件完全兼容Office Open XML标准，所有元素可直接点击编辑，无图片化文本、无不可修改的截图内容，支持Office 2016+全功能编辑
全格式源文件兼容	支持PDF、DOCX、PPTX、XLSX/XLSM、EPUB、HTML、LaTeX、RST、网页链接（含微信公众号文章）、Markdown，甚至直接粘贴文本内容即可生成
成本透明可控	工具本身完全开源免费（MIT协议），唯一成本为大语言模型（LLM）调用费用，成本可预估、无隐藏订阅消费，单份PPT最低成本可至0.08美元
数据安全可控	项目为本地运行的开源代码，源文件不会上传至PPT Master相关的任何第三方服务器；仅需将生成所需的文本内容通过大模型API传输至对应服务商，用户可自主选择模型，甚至使用本地开源大模型完全隔离数据
无平台锁定	兼容几乎所有主流AI IDE与大语言模型，不绑定单一厂商服务，用户可自由切换驱动载体与模型，无平台捆绑限制
多风格多场景适配	内置20+成熟模板，覆盖顶级咨询（MBB级）、学术、科技、品牌、政务、创意等风格，支持16:9、4:3、小红书、抖音竖版等10+种画布格式
全流程可定制	支持自定义品牌模板、设计规范、工作流，内置3种不同定位的执行师，适配通用场景、咨询数据可视化、顶级专业咨询等不同需求
持续迭代更新	2026年4月最新更新已集成Excel工作簿转换、图表坐标审查、SVG布局精度优化等能力，社区持续维护更新

1.3 同类工具核心对比

对比项	PPT Master	Gamma	WPS AI	Microsoft Copilot PPT生成
输出格式	原生可编辑PPTX，全元素可修改，无图片化内容	网页导出为主，PPT文件多为图片嵌入，文本无法直接编辑	原生PPT格式，但样式自由度低，自定义能力弱	仅基础文本框架，样式能力弱，图表多为图片嵌入
开源属性	完全开源，MIT协议，代码全透明	闭源SaaS服务，代码不可见	闭源商业软件，代码不可见	闭源商业服务，代码不可见
数据安全	本地运行，源文件不上传第三方服务器，可使用本地大模型完全隔离数据	需完整上传源文件至平台服务器，数据留存不可控	需上传文件至WPS云端，数据留存不可控	需上传文件至微软服务器，数据留存不可控
成本模式	工具永久免费，仅需支付大模型调用费用，单份PPT成本最低0.08美元	按月订阅付费，免费版功能严重受限	会员订阅付费，免费版有次数限制	随Copilot订阅捆绑，无单独付费通道
自定义能力	全流程可定制，支持自定义模板、设计规范、工作流，品牌适配度100%	模板固定，自定义能力弱，仅能修改基础配色	样式限制多，品牌适配差，无法自定义工作流	仅基础内容生成，无深度定制能力
商用授权	MIT协议，生成内容版权完全归属用户，无商用限制	免费版内容不可商用，商用需企业订阅	生成内容可商用，但版权归属有平台约束	生成内容可商用，版权归属用户
专业能力	支持MBB级咨询风格、复杂数据可视化、学术深度内容、长文档结构化拆解	仅适合轻量营销、简单分享场景，专业内容适配差	仅适合基础办公场景，复杂数据可视化能力弱	仅适合基础文本框架生成，无专业设计能力

二、前置环境准备 ⚙️

PPT Master的核心运行依赖仅为Python 3.10+，其余依赖均可通过pip一键安装，零基础用户无需复杂配置即可完成环境搭建。

2.1 核心依赖：Python 3.10+ 环境安装

Python是PPT Master唯一必须安装的基础软件，以下为分平台的官方标准安装指引，所有步骤均经过2026年最新版本验证。

Windows平台安装（官方标准步骤）

访问Python官方下载页面，下载3.10及以上版本的Windows安装包，推荐3.11/3.12稳定版
运行安装包，务必勾选安装界面底部的「Add python.exe to PATH」选项（这是Windows上最常见的安装失误，不勾选会导致后续所有命令无法识别）
选择「Install Now」完成默认安装，安装完成后重启终端
验证安装：打开PowerShell（开始菜单搜索「PowerShell」），执行以下命令，输出版本号即安装成功

python --version

补充说明：Anaconda / Miniconda 安装的Python也可使用，只要版本满足3.10+即可

macOS平台安装

推荐使用Homebrew包管理器一键安装，执行以下命令：

brew install python

无Homebrew环境可直接从Python官方下载页面下载对应安装包，按指引完成安装
验证安装：打开终端，执行以下命令，输出版本号即安装成功

python3 --version

Linux/Ubuntu平台安装

执行以下apt命令一键完成安装：

sudo apt update
sudo apt install python3 python3-pip python3-venv

验证安装：

python3 --version
pip3 --version

2.2 边缘场景可选依赖说明

以下两个工具仅为极端场景的兜底方案，99%的用户无需安装，仅在遇到对应场景时再配置即可，与官方CONTRIBUTING.md规范完全对齐：

可选依赖	最低版本	适用场景	安装命令
Node.js	18.0.0+	微信公众号文章解析失败时，作为兜底解析方案（默认curl_cffi已支持微信文章抓取）	macOS: `brew install node` Ubuntu: `sudo apt install nodejs npm`
Pandoc	3.0+	需要转换.doc、.odt、.rtf、.tex等小众文档格式时（.docx/.html等主流格式已原生支持，无需Pandoc）	macOS: `brew install pandoc` Ubuntu: `sudo apt install pandoc`
CairoSVG	2.7.0+	需要在不原生支持SVG的旧版Office中获得更清晰的PNG后备图时（默认svglib已满足绝大多数场景）	先安装GTK3 Runtime，再执行`pip install cairosvg`

版本校验命令：

# Node.js版本校验
node --version
# Pandoc版本校验
pandoc --version

2.3 AI Agent工具与模型选型

PPT Master的运行需要具备文件读写、命令执行、多轮对话能力的AI Agent作为驱动载体，以下为官方推荐的可选方案，用户可根据自身使用习惯选择：

主流Agent工具推荐

Agent类型	主流工具推荐	适用场景
IDE内置Agent	Cursor、Trae、Windsurf、Zed	零基础用户首选，编辑器原生集成AI能力，开箱即用，无需额外配置插件
IDE插件/扩展	GitHub Copilot、Claude Code、Continue、通义灵码	已有VS Code/JetBrains使用习惯的用户，无需更换编辑器，安装插件即可使用
CLI终端Agent	Aider、Claude Code CLI	熟悉终端操作的开发者，适合脚本化、批量生成场景

官方模型推荐与注意事项

效果最优首选：Claude 3 Opus/Sonnet，是官方测试最充分的模型，SVG排版的坐标计算精度、布局一致性表现显著优于其他模型，是唯一推荐用于复杂专业PPT的模型
可用平替方案：GPT-4o、GPT-4.1、Gemini 3.1、通义千问、智谱、DeepSeek、Kimi等主流大模型均可正常驱动，但GPT系列更容易出现文字超出容器、元素错位、坐标计算失误等排版问题，非Claude模型建议开启Fast模式降低预期
成本参考：
- 订阅制模型（如Copilot）：月付固定费用，单份10页PPT仅需消耗2次Sonnet请求，超额成本低至0.08美元
- 按token计费模型（如Claude、GPT）：直接使用API生成一份10-15页PPT，成本约0.2-5美元，取决于模型级别与内容复杂度
地区限制说明：Claude、GPT、Gemini的官方API对国内地区有访问限制，需对应地区的网络环境；国内用户可优先选择通义千问、智谱、DeepSeek、Kimi等可直接访问的大模型

三、项目部署与初始化 🚀

本文提供两种官方支持的部署方式，零基础用户推荐使用ZIP包快速部署，开发者推荐Git克隆部署，两种方式均经过官方验证，可稳定运行。

⚠️ 【强制路径规范】
项目解压/克隆的目录路径绝对禁止包含中文、空格、特殊字符（如括号、感叹号），否则会出现Python文件读取失败、AI找不到路径、命令执行报错等一系列问题，推荐路径示例：

Windows：C:\Users\你的用户名\ppt-master 或 D:\code\ppt-master

macOS/Linux：/home/xxx/code/ppt-master 或 ~/Documents/code/ppt-master

3.1 方式一：ZIP包快速部署（零基础免Git）

该方式无需安装Git，适合完全零基础的用户，步骤与官方Windows安装指南完全对齐：

打开项目仓库，下载ZIP包
- AtomGit国内镜像（优先推荐，国内无访问限制，速度更快）：打开https://atomgit.com/hugohe3/ppt-master，点击「克隆/下载」→ 「下载ZIP」
- GitHub仓库：打开https://github.com/hugohe3/ppt-master，点击绿色Code按钮 → Download ZIP
将下载的ZIP包完整解压到符合上述路径规范的本地目录
进入解压后的项目根目录（必须是包含requirements.txt、skills文件夹、docs文件夹的目录，而非上级目录），完成后续依赖安装

3.2 方式二：Git克隆部署（开发者首选）

该方式可便捷获取项目最新更新，适合有Git基础的用户，需提前安装Git。

克隆命令模板

# AtomGit国内镜像克隆（优先推荐，国内无访问限制，速度更快）
git clone https://atomgit.com/hugohe3/ppt-master.git --depth=1

# GitHub仓库克隆
git clone https://github.com/hugohe3/ppt-master.git --depth=1

# 进入项目根目录（后续所有命令必须在该目录下执行）
cd ppt-master

命令参数解释：

--depth=1：浅克隆参数，仅克隆最新版本代码，不下载完整历史记录，大幅提升克隆速度，降低超时概率
cd ppt-master：切换终端工作目录到项目根目录，后续所有pip、python命令均需在该目录下执行

项目更新方法

后续项目有版本更新时，在项目根目录执行以下命令即可同步最新代码：

# AtomGit镜像
git pull origin main
# GitHub仓库
git pull origin main

3.3 Python依赖库安装

完成项目部署后，必须在项目根目录下执行以下命令，安装所有Python依赖库，步骤与官方指南完全对齐。

嫌麻烦可直接安装

📌 【推荐方式】Python虚拟环境安装（避免污染系统Python环境）
虚拟环境可以为项目创建独立的Python运行环境，避免多项目之间的依赖冲突，是Python开发的最佳实践，步骤如下：

步骤1：创建虚拟环境

# Windows平台
python -m venv venv

# macOS/Linux平台
python3 -m venv venv

步骤2：激活虚拟环境

# Windows CMD平台
venv\Scripts\activate.bat

# Windows PowerShell平台
venv\Scripts\Activate.ps1

# macOS/Linux平台
source venv/bin/activate

激活成功后，终端前缀会出现(venv)标识，表示当前已进入虚拟环境，后续所有pip命令都会将依赖安装到该虚拟环境中，不会影响系统Python。

步骤3：安装依赖库

# 国内用户优先使用清华镜像源，大幅提升安装速度，避免超时失败
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 海外用户直接执行官方默认命令
pip install -r requirements.txt

【兜底方式】全局安装（仅无管理员权限的临时场景使用）

# Windows平台
python -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple --user

# macOS/Linux平台
python3 -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple --user

安装成功官方校验命令

执行以下命令，输出All core dependencies OK即表示所有核心依赖安装成功，无报错：

python -c "import pptx; import fitz; print('All core dependencies OK')"

四、PPT生成全流程实操 🎨

本章节严格对齐官方SKILL.md中的核心Pipeline：Source Document → Create Project → Template Option → Strategist → [Image_Generator] → Executor → Post-processing → Export，所有步骤均经过官方验证，零基础可直接复制执行。

4.1 【必做】IDE工作目录配置

这是90%新手执行失败的核心原因：必须将AI IDE的工作目录切换到PPT Master项目根目录，否则AI无法找到SKILL.md规则文件、无法读取源材料、无法写入生成的PPT文件。

主流IDE工作目录配置方法

Cursor/VS Code：
- 打开IDE，点击左上角「文件」→ 「打开文件夹」
- 选择PPT Master项目根目录（包含requirements.txt、skills文件夹的目录）
- 确认IDE左侧资源管理器显示的是项目根目录的文件，而非上级目录
JetBrains系列（PyCharm/IDEA）：
- 打开IDE，点击「打开」，选择PPT Master项目根目录
- 确认项目结构中，根目录被标记为「Sources Root」
其他IDE：确保IDE的当前工作目录为项目根目录，可在IDE终端执行pwd（macOS/Linux）或cd（Windows）命令查看当前路径，确认路径为项目根目录。

4.2 源材料准备

PPT Master支持多种源材料输入，2026年4月最新版本已新增Excel工作簿（.xlsx/.xlsm）支持，推荐以下两种输入方式：

文件输入（推荐）：将需要转换的PDF、DOCX、XLSX、PPTX、图片等素材放入项目根目录的projects/文件夹下，记录文件的相对路径或绝对路径，后续直接粘贴到AI对话中。
- 相对路径示例：projects/2026Q1财务报告.xlsx
- 绝对路径示例：C:\Users\xxx\ppt-master\projects\硕士毕业论文.pdf
文本输入：直接将需要生成PPT的文本内容、大纲、Markdown格式内容粘贴到AI对话窗口，适合无原始文件的快速生成场景。

4.3 加载核心工作流（必做，否则AI会丢失规则）

首先让AI读取项目核心规则文件，完整掌握PPT生成的标准流程、设计规范与输出要求，指令如下，必须优先执行：

请先读取当前项目根目录下 skills/ppt-master/SKILL.md 文件，完整掌握PPT生成的核心工作流、角色定义、执行规范与输出规则，确认完成后回复我。

4.4 AI生成指令编写

AI确认完成规则读取后，发送生成指令，以下为官方标准通用指令模板，可根据自身需求修改，[]内为需要替换的内容，所有模板均经过多模型验证，可直接复制使用。

通用基础指令模板

请严格按照SKILL.md中的串行执行规范，基于以下材料生成一份原生可编辑PPTX文件：
1. 源材料：[粘贴文件相对路径/完整文本内容/网页链接]
2. 核心设计规范（八项确认）：
   - 画布格式：[16:9标准PPT/4:3传统PPT/小红书3:4/抖音9:16竖版等，默认16:9]
   - 页面数量范围：[8-15页，根据内容长度调整]
   - 目标受众：[如企业管理层/高校答辩评委/产品用户/政府领导等]
   - 风格目标：[自由设计/顶级咨询MBB级/通用商务/学术答辩/科技风/政务风/品牌营销风等]
   - 配色方案：[如专业蓝系/品牌主色#xxxxxx/政务深蓝/暖白简约风等]
   - 图标使用方案：[简约线性图标/品牌图标/无图标/场景化图标等]
   - 字体方案：[如无衬线微软雅黑/思源黑体/品牌指定字体等]
   - 图片使用方案：[AI自动生成配图/使用本地images目录图片/无配图纯内容等]
3. 执行要求：
   - 执行师选择：[通用Executor_General/咨询数据可视化Executor_Consultant/顶级咨询MBB级Executor_Consultant_Top]
   - 生成流程必须严格串行逐页生成，保证全文档视觉风格与布局一致性
   - 所有元素均为PowerPoint原生可编辑对象，不使用图片化文本与图表，适配Microsoft Office 2016+
4. 输出要求：
   - 生成完成后，将最终原生PPTX文件与SVG快照版保存到项目根目录的exports/文件夹下
   - 文件命名为「[自定义文件名]_YYYYMMDD.pptx」

高频场景指令示例

高校学术答辩场景

请严格按照SKILL.md中的串行执行规范，基于以下材料生成一份硕士毕业论文答辩PPT：
1. 源材料：projects/硕士毕业论文.pdf
2. 核心设计规范（八项确认）：
   - 画布格式：16:9标准PPT
   - 页面数量范围：15页
   - 目标受众：高校答辩评委老师
   - 风格目标：严谨学术风
   - 配色方案：高校校徽主色#004098+简约白灰
   - 图标使用方案：简约线性学术图标，不使用花哨装饰
   - 字体方案：标题黑体，正文宋体，符合高校学术规范
   - 图片使用方案：使用论文中的实验图表，补充AI生成的原理示意图
3. 执行要求：
   - 执行师选择：Executor_Consultant，保证数据图表清晰可视化
   - 内容重点突出研究背景、创新点、实验结果与结论，逻辑结构符合答辩流程
   - 所有图表均转换为PowerPoint原生可编辑形状，数据标注清晰
   - 严格串行逐页生成，保证全文档风格统一
4. 输出要求：
   - 保存到exports/文件夹，命名为「硕士毕业论文答辩_20260427.pptx」
   - 同步生成答辩演讲备注，保存到notes目录下

企业经营汇报场景

请严格按照SKILL.md中的串行执行规范，基于以下材料生成一份企业季度经营汇报PPT：
1. 源材料：projects/2026Q1经营数据.xlsx
2. 核心设计规范（八项确认）：
   - 画布格式：16:9标准PPT
   - 页面数量范围：10页
   - 目标受众：企业管理层与董事会
   - 风格目标：顶级咨询MBB级
   - 配色方案：商务深蓝+品牌主色，简约克制
   - 图标使用方案：极简商务图标，重点突出数据
   - 字体方案：无衬线字体，标题加粗，正文清晰易读
   - 图片使用方案：AI生成匹配的商务可视化配图，不使用冗余图片
3. 执行要求：
   - 执行师选择：Executor_Consultant_Top，使用MBB级数据可视化技巧
   - 重点突出业绩完成情况、核心指标、问题分析与后续规划
   - 所有数据图表均为原生可编辑形状，保证视觉专业度
   - 严格串行逐页生成，保证全文档布局与风格一致性
4. 输出要求：
   - 保存到exports/文件夹，命名为「2026Q1经营汇报_20260427.pptx」

4.5 PPT生成与文件校验

AI完成生成后，会在项目根目录的exports/文件夹下生成两个文件，与官方规范完全对齐：

[文件名]_YYYYMMDD.pptx：原生可编辑PPTX主文件，包含原生PowerPoint形状，所有文字、图形、颜色均可直接编辑，推荐用于编辑与交付，需要Office 2016或更高版本
[文件名]_YYYYMMDD_svg.pptx：SVG快照版，作为像素级视觉参考备份保留，不建议作为最终编辑文件

官方标准生成文件校验清单

可编辑性校验：打开PPT，点击文本框、图表、形状，确认可直接编辑，无图片化内容、无不可选中的元素
内容完整性校验：核对PPT内容与源材料一致，无遗漏核心信息、无逻辑混乱、无虚假生成内容
样式完整性校验：确认所有元素正常显示，无空白占位、无乱码、无格式错乱、无文字溢出边框
兼容性校验：确认文件可在Microsoft Office 2016+中正常打开，无文件损坏提示

📌 兼容说明：
生成的PPTX文件兼容Microsoft Office 2013 SP1及以上版本，推荐2016+以获得最佳渲染效果；WPS 2023及以上版本可正常打开编辑，但部分复杂SVG元素的渲染效果与Office原生存在差异（源于WPS对SVG的CSS样式、渐变填充支持度较低）。

⚠️ 受保护视图解除方法：
若打开PPT时提示“受保护的视图”，点击PPT上方的「启用编辑」按钮，即可解除限制，正常编辑所有元素。

4.6 二次编辑优化

生成完成后，可直接在PowerPoint中进行精细化调整，也可通过AI对话进行二次优化，官方推荐优化指令示例：

请严格按照SKILL.md规范，对exports/[生成的PPT文件名].pptx进行以下优化：
1. 单独重新生成第3页，修正标题与图表重叠的布局问题，优化数据可视化效果
2. 统一全文档的字体为微软雅黑，标题字号统一为32号，正文字号统一为20号
3. 为第5-8页补充匹配的AI生成配图，保持全文档图片风格一致
4. 优化完成后，保存为新的文件到exports/文件夹，命名为「优化版_原文件名.pptx」

📌 官方提示：生成的PPTX是高质量的设计起点，而非最终成品。在PowerPoint中做少量精细化调整是正常的，可大幅提升最终演示效果。

五、高级功能与个性化配置 🔧

5.1 全格式源文件支持

2026年4月最新版本已新增Excel工作簿原生支持，完整支持的源文件格式与转换方法如下：

源文件格式	官方转换脚本	核心能力说明
PDF	`pdf_to_md.py`	原生支持PDF文本与表格提取，自动转换为结构化Markdown
DOCX/Word	`doc_to_md.py`	原生支持.docx格式，自动保留标题层级、表格、列表结构
XLSX/XLSM/Excel	`excel_to_md.py`	2026年4月新增，支持合并单元格传播、数值列右对齐、浮点数格式化、最大行列截断保护、仅可见工作表导出
PPTX/PowerPoint	`ppt_to_md.py`	原生支持PPTX文件提取，转换为结构化Markdown用于二次生成
网页/微信公众号	`web_to_md.py`	原生支持网页链接抓取，含微信公众号文章，curl_cffi默认支持TLS指纹模拟
Markdown/纯文本	原生直接支持	直接读取，无需转换，支持完整Markdown语法
EPUB/HTML/LaTeX/RST	`doc_to_md.py`	原生支持，小众格式可通过Pandoc兜底转换

5.2 AI图片生成能力配置

PPT Master内置了多供应商AI图片生成脚本，支持Gemini、OpenAI、FLUX、通义千问、智谱等主流生图模型，配置步骤与官方规范完全对齐：

复制环境变量模板文件，分平台命令如下：

# Linux/macOS 平台
cp .env.example .env

# Windows PowerShell 平台
Copy-Item .env.example .env

# Windows CMD 平台
copy .env.example .env

用文本编辑器打开项目根目录下的.env文件，填入对应的AI模型API密钥，以下为官方完整配置模板：

# ==================== 必填配置项 ====================
# 图片生成后端，必须显式指定，可选值：gemini/openai/flux/aliyun/baidu/zhupu等
IMAGE_BACKEND=gemini

# ==================== Gemini模型配置 ====================
# 你的Gemini API密钥，申请地址：https://aistudio.google.com/apikey
GEMINI_API_KEY=你的Gemini API密钥
# 指定使用的Gemini模型版本
GEMINI_MODEL=gemini-3.1-flash-image-preview

# ==================== OpenAI模型配置（可选） ====================
# 你的OpenAI API密钥，申请地址：https://platform.openai.com/api-keys
# OPENAI_API_KEY=你的OpenAI API密钥
# OPENAI_IMAGE_MODEL=dall-e-3

# ==================== 国内模型配置（可选） ====================
# 通义千问、智谱、文心一言等模型配置，可通过以下命令查看完整支持列表
# python3 skills/ppt-master/scripts/image_gen.py --list-backends

查看完整的支持模型列表，执行以下官方命令：

python3 skills/ppt-master/scripts/image_gen.py --list-backends

本地图片使用方法：将自己的图片放到项目的images/目录下，AI会自动读取并使用这些图片，无需额外配置。

5.3 自定义品牌模板制作

PPT Master内置了/create-template完整工作流，支持用户制作贴合自身品牌、行业的自定义PPT模板，官方标准三步制作法如下：

第一步：准备参考材料

最简方式：将参考PPT的关键页面类型分别截图保存，包括封面、目录页、章节页、内容页、结尾页，放到同一个文件夹中，使用规范文件名：cover.png、toc.png、chapter.png、content.png、closing.png
最优方式：提供原始.pptx模板文件，PPT Master会自动从PPTX中提取可复用的背景图、logo、主题色和字体信息，用于模板重建
补充信息：准备模板名称、适用场景、风格基调、配色、类别、画布格式等信息，越详细生成效果越好

第二步：调用AI创建模板

使用AI编程代理（Claude Code、Codex等），发送以下指令，调用/create-template工作流生成模板：

请读取skills/ppt-master/workflows/create-template.md文件，完整掌握自定义模板创建规范，使用/create-template工作流，基于我提供的参考材料，生成一个可复用的PPT模板。
参考材料路径：[粘贴参考截图文件夹/原始PPTX文件路径]
模板基础信息：
- 模板ID：[英文唯一标识，如my_company_brand]
- 模板显示名称：[如XX公司品牌模板]
- 类别：[brand品牌/general通用/scenario场景/government政务/special特殊]
- 适用场景：[如企业内部汇报/政府项目申报/产品发布会等]
- 风格基调：[如现代克制、深蓝主色调、高端商务、简约国风等]
- 主题模式：[如浅色主题（白色背景+蓝色强调色）]
- 画布格式：[默认16:9，如需其他格式请注明]
- 关键词：[3-5个标签，如McKinsey、Consulting、品牌、政务等]

无需一次提供所有细节，AI代理会通过对话追问补齐缺失信息。

第三步：完成模板注册与使用

AI会自动完成模板分析、布局定义构建、模板注册，使其出现在PPT Master工作流的模板选项中，后续生成PPT时，直接指定使用该模板即可。

5.4 多模型适配优化

针对不同大模型，可在生成指令中添加官方推荐的优化参数，提升生成效果与兼容性：

GPT系列模型：添加指令“生成过程中，严格控制SVG元素的坐标精度，避免文字超出容器、元素错位，所有文本内容均使用PowerPoint原生文本框，简化复杂SVG布局，确保Office 2016+完美兼容”
国产大模型（通义千问、智谱、DeepSeek、Kimi等）：添加指令“简化复杂SVG布局，优先使用PowerPoint原生形状与图表，保证文件兼容性，避免使用复杂CSS样式的SVG元素，严格串行逐页生成，每完成2页进行一次布局校验”
本地开源大模型：添加指令“分步执行生成流程，严格遵循SKILL.md中的串行规范，每完成2个页面就进行一次校验，避免上下文长度限制导致的格式错误与内容丢失，优先保证内容完整性与文件可编辑性”

六、官方常见问题FAQ ❓

本章节完全对齐官方FAQ文档，覆盖用户高频提问的所有核心问题。

Q1：没有Claude账号，使用GPT、Gemini、国产大模型可以正常使用吗？

完全可以。PPT Master的工作流不绑定特定大模型，Claude Opus/Sonnet在布局精度、SVG渲染上的适配性最优，是官方测试最充分的模型；GPT-4o、GPT-4.1、Gemini 3.1、通义千问、智谱、DeepSeek、Kimi等所有主流大模型均可正常驱动，仅在复杂SVG绝对坐标布局的精度上存在轻微差异，基础的PPT生成能力完全不受影响。非Claude模型建议开启Fast模式，对排版精度的预期适当降低。

Q2：生成一份PPT需要多久？

一份典型的10–15页PPT，使用吞吐较快的模型，大约需要10–20分钟。生成流程是故意设计为串行逐页生成的，这样才能保持前后页面的视觉一致性；并行生成方案曾经测试过，结果是各页面风格不统一、缺乏整体观。如果感觉生成很慢，瓶颈通常在模型的token吞吐速度，而非脚本本身。

Q3：生成一份PPT的成本大概是多少？

成本完全取决于使用的大模型、PPT页数与内容复杂度，2026年最新官方成本参考如下：

订阅制模型（如GitHub Copilot、Cursor Pro）：每月10美元订阅提供300次普通请求，换算成高级Opus级别请求约100次，单份PPT仅需2次Sonnet请求，超额成本低至0.08美元
按token计费模型（如Claude、GPT）：直接使用API生成，一份PPT大约需要5美元；使用订阅制Copilot优化后，单份PPT成本可控制在0.08–0.24美元
本地开源大模型：API调用零现金成本，仅需承担硬件算力与电力成本，适合对数据安全要求极高的场景

Q4：三种执行师有什么区别？

Executor_General：通用场景，灵活布局，适合绝大多数日常PPT生成需求
Executor_Consultant：一般咨询场景，主打数据可视化，适合经营分析、数据汇报类PPT
Executor_Consultant_Top：顶级咨询（MBB 级），内置5大核心专业技巧，适合高端咨询报告、战略规划、董事会汇报等专业场景

Q5：生成的PPT可以用于商业用途吗？

可以，分为两个维度明确说明：

工具使用：PPT Master基于MIT开源协议发布，你可以自由使用、修改、分发该工具，仅需保留原作者的版权声明与许可声明即可
生成内容：通过该工具生成的PPT内容，版权完全归属用户本人，可用于个人、商业、学术等任意场景，无任何版权限制

注意：使用AI生成的图片、内容时，需遵守对应大模型服务商的商用协议规范。

Q6：可以批量生成PPT吗？

可以。通过CLI Agent（如Aider、Claude Code CLI）的非交互模式，可编写Shell/Python脚本，调用PPT Master的核心脚本，实现批量文档到PPT的自动化生成，适合企业级批量内容生产、多产品线汇报等场景。

Q7：生成的PPT文字超出边框、元素错位怎么办？

这几乎都是模型能力问题，不是PPT Master的bug。SVG排版本质上是纯手动绝对定位，需要模型准确计算坐标、字体度量和容器尺寸。
官方推荐解决办法：

切换到Claude（Opus 或 Sonnet）模型，这是最根本的解决方案
告诉AI哪一页有问题、具体是什么问题，它可以单独重新生成某一页
直接打开SVG源文件，让AI修正坐标参数
官方提示：生成的PPTX是高质量起点，不是最终成品，在PowerPoint中做少量调整是正常的

Q8：生成的图表可以编辑数据吗？

图表以自定义设计的SVG图形形式渲染，转换为原生PowerPoint形状，形状级别完全可编辑（移动、改色、改文字、调样式）。这是一个有意为之的选择，而非Excel驱动的图表对象：PowerPoint默认图表样式陈旧、视觉受限于固定模板，SVG图表则提供出版物级的视觉质量，并且可以在PowerPoint中直接精修。
如果你的工作流明确需要Excel驱动的数据编辑，可以在导出后，手动在PowerPoint里制作一张类似的原生图表。

Q9：能在导出前预览或修正某一页吗？

可以。你可以随时中断工作流，前几页生成后就可以查看并反馈意见，AI可以根据你的意见重新生成特定页面，不需要等到全部完成再修改。生成后的修正也一样简单，直接告诉AI：“第3页布局有问题——标题和图表重叠了”，它会修正那个特定的SVG页面。

Q10：AI生成的内容与源材料不符、逻辑混乱怎么办？

这是新手高频问题，官方根因与解决方案如下：

根因1：AI未正确读取源文件：检查文件路径是否正确，是否使用了相对路径，IDE工作目录是否为项目根目录
根因2：上下文长度不足：源文件内容过长，超出了模型的上下文窗口，导致内容丢失；解决方案：将源文件拆分为多个部分，分阶段生成，或选择上下文窗口更大的模型
根因3：未加载核心规则文件：AI未读取SKILL.md文件，丢失了生成规范，重新发送第一步的加载规则指令即可
根因4：指令不明确：在生成指令中明确要求“严格基于提供的源材料生成，不得添加源材料中不存在的虚假信息、虚构数据，核心内容必须与源材料完全一致”

Q11：生成的PPT在WPS中可以正常编辑吗？

可以。生成的PPTX文件完全兼容Office Open XML标准，WPS 2023及以上版本可正常打开与编辑，但部分复杂SVG元素在WPS中的渲染效果可能与Microsoft PowerPoint存在差异，源于WPS对SVG的CSS样式、路径动画、渐变填充的支持度低于Office原生渲染引擎。若主要使用WPS，建议在生成指令中添加“优先使用PowerPoint原生形状与图表，不使用复杂SVG元素”，提升兼容性。

七、新手高频报错与全解决方案 ⚠️

本章节完全对齐官方Windows安装指南与社区高频问题，覆盖99%的新手报错场景。

报错现象	核心根因	官方标准解决方案
Windows终端执行python命令，提示“python不是内部或外部命令，也不是可运行的程序或批处理文件”	安装Python时未勾选“Add python.exe to PATH”，系统无法在环境变量中找到Python执行程序	1. 重新运行Python安装包，勾选界面底部的“Add python.exe to PATH”后完成修复安装； 2. 若已安装，手动将Python的安装目录和Scripts目录添加到系统环境变量PATH中； 3. 重启终端后重新执行命令验证； 4. 临时替代方案：使用`py`或`python3`命令
执行pip install -r requirements.txt，提示“ERROR: Could not open requirements file: [Errno 2] No such file or directory: ‘requirements.txt’”	终端当前工作目录不在PPT Master项目的根目录下，无法找到依赖配置文件	1. 在文件管理器中打开PPT Master解压/克隆后的根目录（包含requirements.txt文件）； 2. Windows用户在地址栏输入cmd回车，直接在当前目录打开终端；macOS/Linux用户右键目录选择“在终端中打开”； 3. 确认终端路径为项目根目录后，重新执行安装命令
AI对话后仅返回普通文本，未执行PPT生成流程，无文件输出	AI未获取到项目核心工作流文件，丢失上下文，未按指定规则执行	1. 确认IDE工作目录为项目根目录； 2. 在AI对话窗口中，先发送指令“请先读取当前项目根目录下skills/ppt-master/SKILL.md文件，完整掌握PPT生成的核心工作流与规则，确认完成后回复我”； 3. 等待AI确认完成文件读取后，再发送PPT生成指令
输入微信公众号链接后，无法解析文章内容，提示抓取失败	Python环境下curl_cffi库无对应平台的预编译wheel，无法完成微信公众号的TLS指纹模拟	1. 按照文档指引安装Node.js 18+环境，作为兜底解析方案； 2. 临时解决方案：手动将微信文章内容复制为Markdown文本，直接粘贴到AI对话窗口中进行生成
生成的PPT打开后，部分图表/形状无法显示，出现空白占位	Office版本过低，不支持生成的SVG元素特性，或渲染引擎不兼容	1. 升级Microsoft Office至2013 SP1及以上版本，推荐2016+； 2. 若无法升级，在生成指令中添加“所有图表均使用PowerPoint原生图表元素，不使用SVG格式”，适配低版本Office； 3. 若使用WPS，切换到2023及以上最新版本并开启硬件加速渲染
Git clone命令执行时，提示“SSL certificate problem”或“网络超时”	国内网络访问GitHub受限，SSL证书验证失败或网络连接超时	1. 优先切换使用AtomGit国内镜像仓库的克隆地址，从根源避免该问题； 2. 为Git配置代理，或使用SSH方式克隆仓库
执行pip安装命令时，提示“ReadTimeoutError”超时失败	pip默认使用国外源，国内网络连接超时	1. 切换国内清华大学pip镜像源，执行命令：`pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple`； 2. 再次执行安装命令即可
执行Python命令时，提示“ModuleNotFoundError: No module named ‘xxx’”	依赖安装的Python环境，和当前执行命令的Python环境不对应，多版本冲突	1. 使用`python -m pip install`的方式安装依赖，确保依赖安装到当前Python环境中； 2. 激活虚拟环境后，重新执行安装命令； 3. 执行`python --version`和`pip --version`，确认两者的Python版本一致
Windows终端执行pip安装命令，提示“权限拒绝”或“写入失败”	终端未以管理员权限运行，无系统目录写入权限	1. 右键cmd/PowerShell，选择“以管理员身份运行”，重新执行安装命令； 2. 或在安装命令中添加`--user`参数，将依赖安装到当前用户目录，无需管理员权限
打开生成的PPT时，提示“文件已损坏，无法打开”	生成过程中AI写入文件异常，或文件传输过程中损坏	1. 查看exports文件夹下的_svg.pptx快照文件是否可正常打开，若可打开，重新执行生成指令即可； 2. 检查磁盘空间是否充足，确保有足够的空间写入文件； 3. 在生成指令中添加“分步骤写入文件，每完成一个页面就进行一次文件保存校验”
PowerShell执行激活虚拟环境命令，提示“脚本运行被禁用”	PowerShell默认执行策略限制了脚本运行	执行以下命令修改执行策略，按提示输入Y确认即可： `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
执行import fitz失败，提示模块错误	PyMuPDF安装失败，缺少对应平台的预编译包	1. 升级pip：`python -m pip install --upgrade pip`； 2. 重新安装预编译包：`pip install PyMuPDF --only-binary :all:`； 3. 仍失败则安装Visual C++ Build Tools后重新安装

八、项目官方资源与社区 📚

官方核心资源

项目主仓库（GitHub）：https://github.com/hugohe3/ppt-master
国内镜像仓库（AtomGit）：https://atomgit.com/hugohe3/ppt-master
在线效果预览（22个示例项目，309页内容）：https://hugohe3.github.io/ppt-master/

官方文档导航

文档名称	官方直链	核心内容
Windows安装指南	https://github.com/hugohe3/ppt-master/blob/main/docs/zh/windows-installation.md	Windows用户从零到可用的全步骤官方安装指引
核心工作流规则	https://github.com/hugohe3/ppt-master/blob/main/skills/ppt-master/SKILL.md	PPT生成的核心流程、角色定义、执行规范与输出要求
技术设计文档	https://github.com/hugohe3/ppt-master/blob/main/docs/zh/technical-design.md	项目架构、设计哲学与技术选型说明
示例项目合集	https://github.com/hugohe3/ppt-master/blob/main/examples/README.md	22个完整示例项目，共309页PPT，覆盖全场景风格
常见问题FAQ	https://github.com/hugohe3/ppt-master/blob/main/docs/zh/faq.md	全场景问题排查与官方标准解决方案
自定义模板工作流	https://github.com/hugohe3/ppt-master/blob/main/skills/ppt-master/workflows/create-template.md	自定义模板制作的完整规范与执行流程
画布格式规范	https://github.com/hugohe3/ppt-master/blob/main/skills/ppt-master/references/canvas-formats.md	全场景画布尺寸、比例、布局规范