企业官网建设流程全解析

PPT Master 国内下载实操指南：从 AtomGit 镜像到验证通过的完整流程

【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master

PPT Master 是一个把文档或主题转成原生 PowerPoint 演示文稿的工具，AI 在 Claude Code、Codex、Cursor、VS Code agent 等支持 Agent 的环境中运行，产出带原生形状、图表和表格的.pptx。主仓库在 GitHub，国内网络下直连经常拖不动，官方为此提供了 AtomGit 完整仓库镜像。PPT Master 下载这件事从拿源码到跑通第一条生成链路，中间会卡在网络传输、Python 版本、pip 环境和后续更新四个位置，每个位置的处理方式不一样。装完依赖后别急着关终端，先跑一次导入检查和最小生成任务，确认核心链路没问题再离开。

动手前：确认 Python 版本和 Git 是否就绪

PPT Master 唯一硬性要求是 Python 3.10 以上：

python --version

或

python3 --version

输出低于 3.10 就得先升级或切换解释器。这一点比后面所有步骤都重要，装完依赖后导入报ModuleNotFoundError，十有八九就是解释器版本对不上。

如果打算走 Git clone 路线，还要确认本机已安装 Git；走 ZIP 路线的话 Git 可以不管。

另外一个容易踩的点：仓库体积超过 1 GB，因为包含完整 Git 历史和内置的示例 deck 素材。传输时间明显偏长是必然的，建议挑网络稳定的时段传输，中途断了就重新来。

拿代码：Git clone 与 ZIP 两条路线，各自走完整闭环

PPT Master 的官方发布渠道只有两个：GitHub 主仓库和 AtomGit 完整仓库镜像。其他平台上流传的转发版本都不官方，MIT 协议下使用它们要保留署名。选哪条路线取决于用途，两条路线从获取到验证自成闭环。

长期开发路线：clone AtomGit 镜像

准备在国内长期使用、持续跟进版本更新，直接 clone AtomGit 镜像：

git clone https://atomgit.com/hugohe3/ppt-master.git cd ppt-master

clone 的优势是随时可以拉取最新版，官方文档对国内网络环境也推荐这种获取方式。

快速体验路线：从 AtomGit 下载 ZIP

只想先看看效果，打开 AtomGit 镜像页，选择"克隆/下载 → 下载ZIP"，把压缩包存到本地任意目录再解压。

⚠️ ZIP 路线有三个边界要心里有数：

• ZIP 里没有 Git 历史，没法git pull。以后想更新，得重新下载最新版 ZIP、解压到新目录，把旧目录里的.env和projects/复制过去，再重装一次依赖；
• 完整仓库之外还有一个约 56 MB 的纯技能包ppt-master-skill-*.zip，它只发布在 GitHub Releases 页面，AtomGit 上没有对应入口。GitHub 连不上时没有替代小包可用，只能走完整仓库镜像；
• 不管哪条路线，都要求 Python 3.10+，外加一个已安装、已鉴权、能读写文件并执行 shell 命令的 Agent host。

跑起来：在正确环境装依赖，再做导入检查

安装依赖：认准仓库根目录和同一个解释器

无论 clone 还是 ZIP，解压或克隆完成后都在仓库根目录执行：

pip install -r requirements.txt

如果pip命令无法识别，换成：

python -m pip install -r requirements.txt

skill-only 安装则在同时包含SKILL.md与requirements.txt的目录里执行：

python3 -m pip install -r "<installed-skill-dir>/requirements.txt"

等到末尾出现Successfully installed ...，说明这一步结束。国内pip install网络不通时，官方文档给出清华 PyPI 镜像：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

Windows 上另有两种情况：报权限错误就改用pip install --user -r requirements.txt，或以管理员身份运行终端；走代理的话给命令追加--proxy http://your-proxy:port，地址换成你实际的代理端口。

验证安装：先跑导入检查，再走一次最小生成

核心检查是导入项目依赖的两个关键包：

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

输出All core dependencies OK说明核心环境没问题。macOS / Linux 把命令里的python换成python3即可，检查方式一样。

报错了按顺序处理：ModuleNotFoundError表示pip装进了另一个 Python 环境，用python -m pip install -r requirements.txt确保依赖装进同一个环境；import fitz失败时先升级 pip，再试pip install PyMuPDF --only-binary :all:，仍然失败就需要安装 Visual C++ Build Tools 提供编译支持。

装完依赖后，想在 Agent 里打开ppt-master目录，明确要求生成一份 3 页的 "Hello World" 测试 PPT，来确认整条生成链路。成功标志是活动项目的exports/目录里出现原生 DrawingML 的.pptx文件，并且能在演示文稿应用中打开后逐元素编辑。

以后的维护：clone 和 ZIP 两种装法的更新方式不同

不确定自己当初是哪种装法，直接运行python3 skills/ppt-master/scripts/update_repo.py：当前目录不是 Git clone 版本时，脚本会提示你按 ZIP 方式迁移——重新下载 ZIP、解压、迁移.env与projects/、重装依赖。两条路线的分歧只在获取和维护环节，装依赖和验证的命令完全一致；而无论哪条路线走下来，产物始终是能在 PowerPoint 里逐形状、逐图表编辑的真实.pptx文件。

【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master