PPT Master 如何升级到最新版本Git clone 与 ZIP 安装方式的区别【免费下载链接】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、版本落后之后升级到最新版本是长期使用中必然会遇到的操作。升级路径取决于你当初的安装方式Git clone 安装可以一条命令拉取最新版并自动同步依赖ZIP 下载安装没有 Git 历史只能重新下载、解压并手动迁移本地配置。本文按 README 的 Quick Start / Updating Later、FAQ 和仓库自带的 update_repo.py 脚本本身说明两条升级路径并给出升级后的验证方式。两种安装方式的区别在哪里README.md 的 Set Up 一节把初始安装分成两个选项两者对升级能力的影响完全不同Option A — Git cloneREADME 标注为推荐路径要求已安装 Gitgit clone https://github.com/hugohe3/ppt-master.git cd ppt-master pip install -r requirements.txtREADME 说明它是 preferred path原因是 a clone can pull the latest version at any time。Option B — Download ZIP无需 Git适合快速体验在 GitHub 页面点击Code → Download ZIP解压后执行pip install -r requirements.txt。README 明确指出ZIP 包没有 Git 历史因此不能git pull。如果完整 ZIP 太大或下载失败README 给出替代物Releases 页面上的 skill-only 包ppt-master-skill-*.zip约 56 MB完整可用但不含 bundled example decks。FAQ 对两者的结论一致长期使用建议 Git cloneZIP 适合快速体验但没有 Git 历史、不能自动git pull。先判断自己属于哪种安装方式查看项目目录下是否有.git目录即可区分。FAQ 还给了一个更直接的办法不确定时用哪种方式时直接在项目文件夹里运行更新脚本让脚本自己判断python3 skills/ppt-master/scripts/update_repo.py如果该目录不是 Git clone脚本不会报错退出而是打印一份 ZIP 安装的迁移步骤下载最新 ZIP → 解压到新目录 → 复制.env与projects/→ 重新安装依赖。Git clone 安装的升级主路径运行前需要满足三个前提Python 3.10所有安装路径的最低要求环境中可用git脚本会先检查缺失时报Missing executable: git仓库内没有未提交的被跟踪文件改动。脚本先用git status --porcelain --untracked-filesno检查工作区发现改动会报Tracked local changes detected. Please commit or stash them before running the update command.并终止——需要先 commit 或 stash 再运行。副作用说明脚本在仓库根目录执行git pull --ff-only更新代码并在requirements.txt含其中-r引用的本地文件发生变化时自动执行pip install -r requirements.txt同步依赖它不处理 Node.js、Pandoc 等系统级依赖脚本结束时会明确提示。在ppt-master目录内执行python3 skills/ppt-master/scripts/update_repo.py脚本的关键输出均为脚本实际会打印的内容提交哈希部分为变量值代码没有变化时Repository is already up to date.代码有更新时Updated from 7位提交哈希 to 7位提交哈希.依赖同步判断requirements 的 include 树有变化时打印Requirements include tree changed. Syncing Python dependencies...并执行 pip 安装无变化时打印Requirements include tree unchanged. Skipping Python dependency sync.可选分支只拉代码、依赖手动处理时加--skip-pip此时即使 requirements 的 include 树有变化脚本也只打印Skipped Python dependency sync (--skip-pip).并跳过 pip 同步。脚本结束前还会固定打印一条提示系统依赖如 Node.js 和 Pandoc仍需手动安装。README 说明 Pandoc 只在使用.doc、.odt、.rtf等旧格式文档时才需要如果你不碰这类格式可以忽略这条提示。ZIP 下载安装的升级替代路径ZIP 解压出的目录没有.git脚本和git pull都不可用。按 README.md 的 Updating Later 与 FAQ 表格手动步骤是下载最新 ZIP。FAQ 补充中国大陆访问 GitHub 不便时完整仓库在 AtomGit 上有镜像可以 clone 或下载其 ZIP。解压到一个新目录。把旧目录里的.env和projects/文件夹复制到新目录——前者保存 API key 等配置后者是你自己的项目数据。在新目录里执行pip install -r requirements.txt另一条独立分支如果当初是通过 skill marketplace 安装的仓库自带.claude-plugin/marketplace.json按 FAQ 的表格应通过对应的 marketplace / skills 工具重新安装或更新不走本文两条路径。升级后如何验证FAQ 给出的 macOS / Linux 最小依赖检查命令同样适用于升级后确认环境完整python3 -c import pptx; import fitz; print(All core dependencies OK)该命令检查核心 Python 包是否可导入。FAQ 进一步建议用一次不带源文件的三页 Hello World Quick 模式生成做端到端验证它同时覆盖项目初始化、SVG 生成、校验和导出成功条件是当前激活项目的exports/目录中出现 PPTX且文件能在演示软件中打开。版本确认方式按安装方式区分git clone 升级以脚本打印的Updated from ... to ...提交哈希对为准skill-only 类安装不带.gitgit describe无法报告版本FAQ 说明安装版本记录在 skill 的SKILL.mdfrontmatter 的metadata.version字段——例如当前仓库 skills/ppt-master/SKILL.md 中该值为6.3.0。限制与已知边界有未提交的被跟踪改动时脚本直接终止先 commit/stash 再重跑脚本依赖仅为 Python 标准库脚本 docstring 标注 None (standard library only)无需额外安装即可运行--skip-pip只跳过依赖同步不跳过git pull跳过后需自行执行pip install -r requirements.txt系统依赖Node.js、Pandoc不在脚本职责内用到相关功能时按 README.md 的平台说明自行安装如果你一直用 ZIP 方式且打算长期使用脚本在非 Git 目录下打印的提示里给出了迁移建议改用git clone https://github.com/hugohe3/ppt-master.git安装之后即可用一条命令更新。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
