如何在 macOS 或 Linux 上检查 PPT Master 依赖安装并完成首次 Quick 生成【免费下载链接】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 后通常要做两件事确认 Python 依赖真正装进了当前解释器然后跑一次最小规模的 Quick 生成验证项目初始化 → SVG 创作 → 质量检查 → PPTX 导出这条链路能完整走通。PPT Master 是一个跑在 agent 工具里的工作流你负责装环境装好后的生成全部通过对话完成。本文适用前提来自项目文档所有安装方式都要求 Python 3.10以及一个已安装、已认证、能读写文件并执行 shell 命令的 agent 宿主Claude Code、VS Code Copilot、Codex 等。准备条件与目录角色开始之前先分清三个目录这是 Getting Started 中明确要求的模型目录是什么从哪里来已安装 skill 目录含SKILL.md、requirements.txt、workflows 和脚本的 PPT Master 包完整仓库克隆或 ZIP 中为skills/ppt-master/工作文件夹你在 agent 中打开的、持久且可写的文件夹完整仓库克隆或 ZIP 时通常是仓库根目录活动项目一次生成的 sources、SVG、报告、备份和导出agent 自动在working-folder/projects/生成的项目名/下初始化并报告准确路径不要手动创建projects/name——agent 驱动的运行时由 Default Generate Step 2 或 Quick 初始化来创建活动项目并报告其精确路径。安装 Python 与项目macOS 和 Linux 上先准备 PythonREADME Quick Start 给出的命令# macOS brew install python # Ubuntu / Debian需要 sudo 权限会安装系统包 sudo apt install python3 python3-pip然后获取项目并安装依赖。推荐 Git clone可以随时拉取最新版本git clone https://github.com/hugohe3/ppt-master.git cd ppt-master在项目根目录安装 Python 依赖python3 -m pip install -r requirements.txt根目录的 requirements.txt 本身通过-r skills/ppt-master/requirements.txt递归引用了完整依赖列表所以从仓库根目录装这一份就覆盖了全部能力安装完成时pip会输出Successfully installed ...。检查依赖安装依赖装完后运行 FAQ 中 macOS / Linux 与 Windows 共用的核心导入检查python3 -c import pptx; import fitz; print(All core dependencies OK)这条命令检查的是核心 Python 包能否被当前python3导入。看到All core dependencies OK说明核心依赖就绪出现ModuleNotFoundError或ImportError时跳到文末的检查不通过时一节。完成首次 Quick 生成导入检查通过后在 agent 工具中打开仓库根目录作为工作文件夹IDE 类工具用File → Open FolderCLI agent 先cd ppt-master再启动。然后在聊天面板里发出文档中的冒烟测试指令Windows 安装指南 Step 5 的原话FAQ 确认 macOS/Linux 使用同样的最小检查且不带源文件Quickly generate a simple 3-page test PPT with a cover, one content page, and a closing page. Topic: Hello World. No need to confirm with me.为什么这条指令适合当冒烟测试明确要求quick generation才会触发 Quick 生成 profile。Quick 跳过 Strategist 分析、design_spec.md/spec_lock.md工件和阶段性确认停顿——你显式说出的要求会被遵守没说的由 agent 直接决定并继续不会中途回来问。它会照常执行源转换本例无源文件则跳过、逐页 SVG 创作、锁定无关的最终质量检查最后用--quick-generate导出。Quick 是一次性、不可恢复的 profile如果执行中途上下文丢失需要重新发起一次 Quick而不是从文件恢复计划。验证生成结果生成结束后按以下标准判断依据 FAQ 与 Windows 安装指南活动项目的exports/目录下出现 PPTX默认输出路径形如active-project/exports/project-name_timestamp.pptx注意这不是仓库根目录下无定语的exports/。用 agent 报告的活动项目路径去找文件完整仓库克隆时通常位于repository-root/projects/generated-project-name/exports/...。该文件能在演示应用中打开且内容是可逐元素编辑的原生 DrawingML 对象由svg_output/转换而来。两个与 Default 流程不同的预期行为避免误判为异常Quick 跳过finalize_svg.py所以没有svg_final/预览目录Default 流程才会产出自包含的可视化预览 SVG。Quick 不生成design_spec.md或spec_lock.md其内容与资源决策只存在于活动 agent 上下文中。文件存在且能打开即环境检查完成。可选skill-only 安装如果完整仓库Git 历史加示例 deck 资产超过 1 GB下载困难可以只装 skill通过npx skills add hugohe3/ppt-master或 Releases 页的ppt-master-skill-*.zip约 56 MB仅 skill 文件。此时依赖要从含SKILL.md和requirements.txt的安装目录安装python3 -m pip install -r installed-skill-dir/requirements.txtinstalled-skill-dir替换为你的实际安装目录。npx路径额外要求 Node.js/npm 提供的npx命令仓库未声明 Node/npm 最低版本。skill-only 安装没有.git无法用git describe报告版本安装版本记录在该 skillSKILL.mdfrontmatter 的metadata.version字段。工作文件夹也不再是仓库根目录而是你自己选定的持久可写目录导入检查与 Quick 冒烟测试的做法与上文相同。检查不通过时以下条目来自 Windows 安装指南 的 Troubleshooting 部分属于解释器与环境层面的通用问题ModuleNotFoundError/ 导入检查失败通常是pip装到了另一个 Python。改用python3 -m pip install -r requirements.txt让 pip 与运行检查的python3属于同一解释器后重装。import fitz失败先升级 pippython3 -m pip install --upgrade pip再尝试预编译 wheelpip install PyMuPDF --only-binary :all:。权限错误可尝试pip install --user -r requirements.txt。下一步环境验证完成后两条文档明确给出的后续路径生成正式 deck给 agent 可读取的源材料PDF、DOCX、Markdown、URL 或粘贴文本正常请求会先确认设计 spec想跳过确认就显式要求 quick generation。更新到最新版Git clone 安装在ppt-master目录内运行python3 skills/ppt-master/scripts/update_repo.py脚本会拉取最新版本并在requirements.txt变化时同步 Python 依赖。【免费下载链接】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），仅供参考 如何在 macOS 或 Linux 上检查 PPT Master 依赖安装并完成首次 Quick 生成
如何在 macOS 或 Linux 上检查 PPT Master 依赖安装并完成首次 Quick 生成【免费下载链接】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 后通常要做两件事确认 Python 依赖真正装进了当前解释器然后跑一次最小规模的 Quick 生成验证项目初始化 → SVG 创作 → 质量检查 → PPTX 导出这条链路能完整走通。PPT Master 是一个跑在 agent 工具里的工作流你负责装环境装好后的生成全部通过对话完成。本文适用前提来自项目文档所有安装方式都要求 Python 3.10以及一个已安装、已认证、能读写文件并执行 shell 命令的 agent 宿主Claude Code、VS Code Copilot、Codex 等。准备条件与目录角色开始之前先分清三个目录这是 Getting Started 中明确要求的模型目录是什么从哪里来已安装 skill 目录含SKILL.md、requirements.txt、workflows 和脚本的 PPT Master 包完整仓库克隆或 ZIP 中为skills/ppt-master/工作文件夹你在 agent 中打开的、持久且可写的文件夹完整仓库克隆或 ZIP 时通常是仓库根目录活动项目一次生成的 sources、SVG、报告、备份和导出agent 自动在working-folder/projects/生成的项目名/下初始化并报告准确路径不要手动创建projects/name——agent 驱动的运行时由 Default Generate Step 2 或 Quick 初始化来创建活动项目并报告其精确路径。安装 Python 与项目macOS 和 Linux 上先准备 PythonREADME Quick Start 给出的命令# macOS brew install python # Ubuntu / Debian需要 sudo 权限会安装系统包 sudo apt install python3 python3-pip然后获取项目并安装依赖。推荐 Git clone可以随时拉取最新版本git clone https://github.com/hugohe3/ppt-master.git cd ppt-master在项目根目录安装 Python 依赖python3 -m pip install -r requirements.txt根目录的 requirements.txt 本身通过-r skills/ppt-master/requirements.txt递归引用了完整依赖列表所以从仓库根目录装这一份就覆盖了全部能力安装完成时pip会输出Successfully installed ...。检查依赖安装依赖装完后运行 FAQ 中 macOS / Linux 与 Windows 共用的核心导入检查python3 -c import pptx; import fitz; print(All core dependencies OK)这条命令检查的是核心 Python 包能否被当前python3导入。看到All core dependencies OK说明核心依赖就绪出现ModuleNotFoundError或ImportError时跳到文末的检查不通过时一节。完成首次 Quick 生成导入检查通过后在 agent 工具中打开仓库根目录作为工作文件夹IDE 类工具用File → Open FolderCLI agent 先cd ppt-master再启动。然后在聊天面板里发出文档中的冒烟测试指令Windows 安装指南 Step 5 的原话FAQ 确认 macOS/Linux 使用同样的最小检查且不带源文件Quickly generate a simple 3-page test PPT with a cover, one content page, and a closing page. Topic: Hello World. No need to confirm with me.为什么这条指令适合当冒烟测试明确要求quick generation才会触发 Quick 生成 profile。Quick 跳过 Strategist 分析、design_spec.md/spec_lock.md工件和阶段性确认停顿——你显式说出的要求会被遵守没说的由 agent 直接决定并继续不会中途回来问。它会照常执行源转换本例无源文件则跳过、逐页 SVG 创作、锁定无关的最终质量检查最后用--quick-generate导出。Quick 是一次性、不可恢复的 profile如果执行中途上下文丢失需要重新发起一次 Quick而不是从文件恢复计划。验证生成结果生成结束后按以下标准判断依据 FAQ 与 Windows 安装指南活动项目的exports/目录下出现 PPTX默认输出路径形如active-project/exports/project-name_timestamp.pptx注意这不是仓库根目录下无定语的exports/。用 agent 报告的活动项目路径去找文件完整仓库克隆时通常位于repository-root/projects/generated-project-name/exports/...。该文件能在演示应用中打开且内容是可逐元素编辑的原生 DrawingML 对象由svg_output/转换而来。两个与 Default 流程不同的预期行为避免误判为异常Quick 跳过finalize_svg.py所以没有svg_final/预览目录Default 流程才会产出自包含的可视化预览 SVG。Quick 不生成design_spec.md或spec_lock.md其内容与资源决策只存在于活动 agent 上下文中。文件存在且能打开即环境检查完成。可选skill-only 安装如果完整仓库Git 历史加示例 deck 资产超过 1 GB下载困难可以只装 skill通过npx skills add hugohe3/ppt-master或 Releases 页的ppt-master-skill-*.zip约 56 MB仅 skill 文件。此时依赖要从含SKILL.md和requirements.txt的安装目录安装python3 -m pip install -r installed-skill-dir/requirements.txtinstalled-skill-dir替换为你的实际安装目录。npx路径额外要求 Node.js/npm 提供的npx命令仓库未声明 Node/npm 最低版本。skill-only 安装没有.git无法用git describe报告版本安装版本记录在该 skillSKILL.mdfrontmatter 的metadata.version字段。工作文件夹也不再是仓库根目录而是你自己选定的持久可写目录导入检查与 Quick 冒烟测试的做法与上文相同。检查不通过时以下条目来自 Windows 安装指南 的 Troubleshooting 部分属于解释器与环境层面的通用问题ModuleNotFoundError/ 导入检查失败通常是pip装到了另一个 Python。改用python3 -m pip install -r requirements.txt让 pip 与运行检查的python3属于同一解释器后重装。import fitz失败先升级 pippython3 -m pip install --upgrade pip再尝试预编译 wheelpip install PyMuPDF --only-binary :all:。权限错误可尝试pip install --user -r requirements.txt。下一步环境验证完成后两条文档明确给出的后续路径生成正式 deck给 agent 可读取的源材料PDF、DOCX、Markdown、URL 或粘贴文本正常请求会先确认设计 spec想跳过确认就显式要求 quick generation。更新到最新版Git clone 安装在ppt-master目录内运行python3 skills/ppt-master/scripts/update_repo.py脚本会拉取最新版本并在requirements.txt变化时同步 Python 依赖。【免费下载链接】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），仅供参考