PPT Master 生成的 PPT 文件在哪里projects 与 exports 目录结构说明【免费下载链接】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 并让 Agent 跑完第一次生成后最常见的卡点是.pptx到底写到了哪里直接答案它不在仓库根目录的某个exports/里而在活动项目目录下的exports/子目录中完整路径形如工作目录/projects/项目名/exports/项目名_时间戳.pptx完整仓库 clone 时工作目录就是仓库根目录。本文说明 PPT Master 的三层目录分工、projects/与exports/的结构和文件命名规则以及如何核对一次首次生成是否真正产出可用文件。以下结论来自 FAQ、Getting Started 与 SVG Pipeline 文档适用于所有安装方式完整仓库 clone、仓库 ZIP、skill-only 安装运行环境要求 Python 3.10 以及一个能读写工作目录、执行 shell 命令的已认证 Agent 宿主。先分清三个目录角色skill 目录、工作目录、活动项目PPT Master 把装在哪里从哪运行产物落在哪分成三个独立目录见 Getting Started目录是什么来自哪里已安装的 skill 目录包含SKILL.md、requirements.txt、workflows 和 scripts 的 PPT Master 包完整仓库 clone 或 ZIP 中即skills/ppt-master/marketplace/插件安装或 skill-only ZIP 有自己的安装/解压位置工作目录你在 Agent 中打开的持久、可写文件夹完整仓库 clone 或 ZIP 时通常是仓库根目录skill-only 安装时自己选一个文件夹不必是 skill 安装目录活动项目一次生成运行的来源、SVG 成品、报告、备份和导出物Agent 初始化到工作目录/projects/生成的项目名/下并报告精确路径由此推出本文的核心结论产物路径永远是工作目录下的projects/再进项目目录的exports/。完整仓库 clone 通常对应仓库根目录/projects/生成的项目名/exports/...skill-only 安装对应工作目录/projects/生成的项目名/exports/...。文档特别提示应以 Agent 报告的活动项目精确路径为准不要到仓库根目录找一个没有项目上下文的裸exports/。前置检查装好依赖并做最小安装验证首次使用先确认 Python 依赖已安装。完整仓库 clone 或 ZIP 在仓库根目录执行python3 -m pip install -r requirements.txtskill-only 安装则从包含SKILL.md和requirements.txt的安装目录执行python3 -m pip install -r installed-skill-dir/requirements.txtinstalled-skill-dir替换为你的实际 skill 目录。装完依赖后在 macOS/Linux 上运行与 Windows 指南相同的核心导入检查python3 -c import pptx; import fitz; print(All core dependencies OK)这条命令只检查核心 Python 包。它打印All core dependencies OK说明包可用但还不代表整条管线通了——接下来用一次真实的 Quick 生成来做端到端冒烟测试。让 Agent 跑一次最小生成顺便得到第一个 projects/ 目录依赖检查通过后按 FAQ 的最小安装检查方式让 Agent 用 Quick 模式、不带任何源文件生成一份三页 Hello World deck例如直接说quick mode 生成三页 Hello World PPT。这次运行会一并验证项目初始化、SVG 生成、质量校验和导出。你不需要手动创建projects/name/目录。Agent 驱动的 Default GenerateStep 2或 Quick 初始化会自动在活动项目路径下建好结构并向你报告精确路径。如果想手动或理解底层机制对应的是project_manager.py见 Project Toolspython3 skills/ppt-master/scripts/project_manager.py init my_presentation工作流文档里写作python3 ${SKILL_DIR}/scripts/project_manager.py ...其中${SKILL_DIR}指已安装的 skill 目录完整仓库 clone 时它就是skills/ppt-master/。项目目录命名规则不带--format时init创建名称_YYYYMMDD名称本身已以_YYYYMMDD结尾则不再追加日期。带--format且画布恰好匹配已注册格式如ppt169、xiaohongshu时目录保留名称_格式_YYYYMMDD形式例如my_widescreen_ppt169_20251116上例来自项目文档示例。有源文件时再执行import-sources把来源导入项目来源文件会落到项目内sources/。活动项目里的目录结构谁放哪、exports 只放最终 PPTX一次生成运行中活动项目目录工作目录/projects/项目名/下各目录分工如下依据 SVG Pipeline 文档 与 Project Tools路径内容sources/导入的源材料import-sources写入项目外的文件一律复制projects/内的文件默认移动svg_output/AI 逐页手写的完整可见页面设计源文件01_cover.svg… 之类文件名用统一宽度零填充页号原生 PPTX 导出读取的就是这里images/备好的图片资源含直接提供的位图、切片图notes/逐页演讲者备注启用 Notes/配音时才出现analysis/工具生成的来源事实与清单如 PPTX 源的 intake 包、页面上下文快照不是设计副本validation/workflow.log审计日志、svg_quality_report.json质量报告、导出后的 postflight 报告exports/只放最终 PPTX 交付物机器可读的质量与 postflight 报告属于validation/不放这里backup/时间戳/svg_output/默认导出时自动保留的手写 SVG 快照用于不重跑 LLM 重新导出Default 流程还会在项目根写design_spec.md/spec_lock.md规划产物并运行finalize_svg.py生成svg_final/预览目录可插入其他 deck 作 SVG 图片Quick 模式刻意不产生这些规划文件与svg_final/预览但svg_output/、exports/、backup/的默认行为一致。生成的 .pptx 具体落在哪、叫什么名使用默认导出路径不带-o时两个 Generate profile 的产物都在活动项目内活动项目/exports/项目名_时间戳.pptx配套同时产出validation/项目名_时间戳.report.json— 包 postflight、质量门关联、未解析资源审计、发布部件计数backup/时间戳/svg_output/— 手写 SVG 的备份副本。几个会改变文件名的情况都仍在同一项目的exports/下只是带区分后缀启用录音配音导出--recorded-narration时默认流程导出名为项目名_时间戳_narrated.pptx与同目录的无配音版本区分开使用--native-charts-and-tables导出原生图表/表格对象时文件为活动项目/exports/名称_时间戳_native_charts_tables.pptx见 FAQ唯一例外是显式指定输出路径-o/--output会改变 PPTX 落点并跳过backup/备份postflight 报告仍写在项目validation/下。验证首次生成成功看三个信号FAQ 给冒烟测试的成功标准是PPTX 出现在活动项目的exports/目录且文件能在演示应用中打开。更完整的成功判据来自 Generate 工作流导出命令退出码为 0且产出exports/项目名_时间戳.pptx产出validation/项目名_时间戳.report.json状态为passed或passed-with-warnings终端打印紧凑的[POSTFLIGHT]回执包含status、quality_gate、slide 数、warning 分类数和[PPTX]/[REPORT]路径——日常以这条回执为准不需要把完整报告 JSON 读进上下文。另外两个结构层面的检查命令项目文档示例python3 skills/ppt-master/scripts/project_manager.py info projects/my_presentation_20251116 python3 skills/ppt-master/scripts/project_manager.py validate projects/my_presentation_20251116info查看项目基本信息validate按templates/schemas/下的 schema 解析现有 Markdown 规划产物并报告缺失章节、非法枚举等问题。把示例中的项目名换成你实际生成的projects/目录名即可。常见误区与边界找不到文件先确认你看的是 Agent 报告的活动项目路径而不是仓库根目录的裸exports/——根目录下通常没有这个目录这是预期行为不是生成失败。exports/里有多个 PPTX多次导出会按时间戳并存_narrated、_native_charts_tables等后缀标识不同导出变体取最新时间戳或按后缀区分。想重导而不敢删备份默认导出保留的backup/时间戳/svg_output/就是为此准备的——同一份手写 SVG 可以不重跑 LLM 直接重新导出自定义-s/--source或显式-o导出则跳过该备份这是文档明确的行为差异。导出被拒正式发布导出要求存在与当前svg_output/指纹匹配的final质量报告validation/svg_quality_report.json缺失、过期或 blocking 时导出会以not-provided等门状态非零退出先对当前svg_output/跑一次 final 检查器再导出。完成以上验证——exports/下出现带时间戳的.pptx、[POSTFLIGHT]回执为通过状态、文件能在 PowerPoint 中打开——本次安装与首次生成就完成了。后续若要复用品牌、模板或继续调整页面Getting Started 的模板、Live Preview 与动画章节是对应的下一步入口。【免费下载链接】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），仅供参考