中国大陆如何用 AtomGit 镜像拿 PPT Master 源码？
【免费下载链接】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 让 AI 在 Agent 工具中把文档或主题直接生成原生.pptx演示文稿，输出带原生形状、图表与表格，可逐元素编辑。本文只讲一条线：在中国大陆网络环境下，如何拿到源码并完成 Python 环境搭建。
先把三件事确认好
动手拉代码前，在终端确认：
- Python 3.10+是唯一硬性要求：跑
python --version（或python3 --version），输出在 3.10 以上即可； - 走 Git clone 路线时，本机已安装 Git；
- 仓库体积超过 1 GB（含 Git 历史与内置示例 deck 素材），下载耗时较长属正常现象。
所有安装方式还要求一个已安装、已鉴权、能读写文件并执行 shell 命令的 Agent host。
💡 官方发布渠道只有两个：GitHub 主仓库与AtomGit完整镜像。其他平台上的转发版本均为非官方，MIT 协议下使用需保留署名。AtomGit 是完整仓库镜像，clone 与下载 ZIP 均可，适合访问 GitHub 不便的场景。
打算长期用 → 走镜像克隆
需要随时拉取更新，clone 是推荐路线：可随时拉到最新版，不用重新下载整包。
目的：把完整仓库从镜像拉到本地目标目录。AtomGit 镜像与当前平台镜像同为完整仓库镜像，内容一致，本文以当前平台地址为例。
git clone https://gitcode.com/GitHub_Trending/ppt/ppt-master cd ppt-master→ 跑完当前目录出现
ppt-master，且你已在仓库根目录。
- 如果报
git: command not found，就先装 Git，再重跑同前命令； - 首次拉取慢属正常，1 GB+ 的体积决定了耗时；
- GitHub 主仓库访问顺畅时，也可直接克隆主仓库（内容同为完整）。
只想先跑通看看 → 下载完整 ZIP
只想快速体验，ZIP 就够：打开 AtomGit 镜像页面，选克隆/下载 → 下载ZIP，解压到本地任意目录。
⚠️ 这条路的边界，提前知道：
- ZIP 包没有 Git 历史，不能
git pull。更新时要重新下载最新 ZIP、解压到新目录，把旧目录的.env和projects/复制过去，再重装依赖； - 纯技能包
ppt-master-skill-*.zip（约 56 MB）只发布在 GitHub Releases，镜像上没有对应入口，不能用该小包替代，只能通过完整镜像获取。
pip 装依赖，国内网络一行加速
目的：把requirements.txt声明的全部 Python 依赖装进当前环境，在仓库根目录执行：
pip install -r requirements.txt→ 最后看到
Successfully installed ...即可。
- 如果
pip无法识别，改用python -m pip install -r requirements.txt，确保依赖装进你运行的同一环境；skill-only 安装用python3 -m pip install -r "<installed-skill-dir>/requirements.txt"，在同时包含SKILL.md与requirements.txt的目录里执行； - 国内网络安装超时或失败时，同前命令改用清华 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，下载与依赖安装这条路径走通。
- 如果报
ModuleNotFoundError，说明依赖装进了另一个 Python 环境，用python -m pip前缀重跑依赖安装，装进同一环境即可； import fitz失败时，先升级 pip，再试pip install PyMuPDF --only-binary :all:；仍失败需安装 Visual C++ Build Tools。
macOS / Linux 把python换成python3，其余不变。
想进一步确认整条生成链路：在 Agent 中打开ppt-master目录，显式要求快速生成一份 3 页 “Hello World” 测试 PPT。成功标志是活动项目的exports/目录出现原生 DrawingML 的.pptx，且能在演示文稿应用中打开逐元素编辑。
