PPT Master 实践 FAQ 全解源格式、原生导出、图表公式与模板复用的完整技术指南【免费下载链接】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本文基于仓库内官方 FAQdocs/faq.md逐题展开并结合skills/ppt-master/scripts/下的转换脚本、CLI 参数定义与工作流文档做源码级印证。读完本篇你将掌握 PPT Master 的输入格式边界、更新与轻量部署路径、图片获取策略、多行文本重排与 px→pt 导出机制、原生图表/公式/超链接/动画的开关方式以及复用已有 PPT 的三条路由决策方法。一、输入与生成路由1.1 支持哪些源格式几乎覆盖所有常见文档形态PDF、DOCX、PPTX、EPUB、HTML、LaTeX、RST、URL包括微信文章、Markdown甚至直接粘贴进对话的纯文本。AI Agent 会先将源材料自动转换为 Markdown再生成幻灯片。1.2 没有素材、只给主题也能生成可以。直接向 AI 说明主题或场景例如做一份关于宫崎骏的 PPT、介绍我们的新产品Generate PPTX 路由会执行其topic-research 阶段收集规划所需的事实基线与来源溯源provenance。细节边界如下若你提供了部分素材同一阶段通常只补齐结果所需的事实缺口除非你明确要求仅基于源材料的产出项目导入时不会批量抓取溯源中记录的已采纳网页 URL常规图片搜索失败后至多抓取一个相关页面及其配套图片供审阅且只有被选中的文件才会进入幻灯片的图片池。质量取决于公开网络上有什么。如果你已有专业材料论文、内部文档直接把这些文件交给 AI效果通常优于纯网络调研。1.3 除 16:9 和 4:3 外还支持哪些画布格式除标准16:9与4:3演示格式外PPT Master 开箱即支持社媒与营销画布格式典型用途小红书 (RED) 3:4图文分享、知识帖朋友圈 / IG 1:1方形海报、品牌展示Story / TikTok 9:16竖版故事、短视频封面微信公众号头图公众号封面图A4 打印打印海报、传单开项目时直接指定格式即可例如--format xhs。从 画布格式注册表 可以看到wechat3:4、9:16 竖版、a4等格式均登记在CANVAS_FORMATS中导出时 svg_to_pptx 的-f/--format参数会强制要求 SVG 画布与该注册格式匹配。输出仍然是一个包含原生形状的.pptx文件。1.4 兼容哪些 AI 工具任何具备 Agent 能力、能读文件、能执行 shell 命令的 AI 工具都可以运行 PPT Master——Claude CodeCLI / VS Code / JetBrains / Web、VS Code Copilot、Codex等。二、安装、更新与轻量部署2.1 旧版本如何更新到最新取决于安装方式安装方式更新方式Git clone在ppt-master目录下运行python3 skills/ppt-master/scripts/update_repo.py下载 ZIP下载最新 ZIP解压到新文件夹把旧目录的.env和projects/拷入新目录再运行pip install -r requirements.txtSkill 市场通过对应的 marketplace / skills 工具重新安装或更新长期使用推荐 Git cloneZIP 适合快速试用但它没有 Git 历史无法执行git pull。不确定自己属于哪种安装方式时在项目目录里直接让 AI 执行 更新脚本python3 skills/ppt-master/scripts/update_repo.py如果该目录不是 Git clone脚本会告诉你对应的 ZIP 安装该如何迁移。2.2 仓库超过 1 GB技能工具下载失败能只装 skill 吗能。完整仓库偏大Git 历史 捆绑的示例 deck 及其素材且体积已经固化在历史里——在不破坏众多现有 fork 的前提下无法裁剪。如果只要 skill 本体有两条轻量路径Marketplace CLInpx skills add hugohe3/ppt-master或 Claude Code 的/plugin install只拉取 skill 文件手动下载从项目 Releases 页获取ppt-master-skill-*.zip仅 skill 文件约 56 MB无需完整 clone。无论哪条路径都要在安装位置执行pip install -r requirements.txt让后处理脚本可用。由于两条路径都不带.git目录git describe无法报告版本所安装的版本记录在 skill 自身 SKILL.md frontmatter 的metadata.version字段中。三、图片策略AI 生成、网络搜图与手动换图3.1 能用 AI 生成的图片吗能。当 Agent 宿主提供原生图像工具时PPT Master 可以直接使用它无需另行配置图像生成 API key也可以通过内置的 image_gen.py 走已配置的 provider。在图片方式中选择 AI generation也可以明确要求 Agent 使用其自带图像工具。另外你可以把自己的图片放进项目的images/目录。3.2 没有图像生成 API key 还能拿到图吗能。若 Agent 宿主有原生图像生成能力选 AI generation 并让它用自己的图像工具即可——不需要 provider 的图像 API key。否则在 Strategist 的 Image Usage 步骤选择 Web-sourcedPPT Master 附带了一个零配置的 image_search.py在 Openverse 与 Wikimedia Commons 上搜索开放许可图片。零配置搜索的定位是兜底立即可用但质量参差不齐因为很多结果是普通用户上传。想要更好的当代图库照片在.env中设置PEXELS_API_KEY和/或PIXABAY_API_KEY两者都免费搜索会自动包含 Pexels / Pixabay人物、职场、生活方式、产品与插画类图片质量通常更好。一份 deck 内可以混用路径例如 AI 出主视觉插画、网络图出团队照。若某张入选图片需要署名Executor 会在受影响页面上加一行小的内联 credit。FAQ 特别强调了对网络搜图的清醒预期搜索只能找到一张相关、可下载、许可干净图不保证它好看或适合该页因为排序看到的是文本元数据而非画面本身。生成过程中多模态模型会读取缩略图做合理性检查对不合适的结果重新发起查询但最可靠的提质路径是手动挑图——你在任何地方找到更好的图把 URL 交给 AI它会通过image_search.py --from-url url下载并替换记录为手动来源版权需自行核实。替换可以在生成中途或实时预览时发生无需停止运行。一句话把网络搜索当占位兜底把手动挑图当抛光步骤。四、Image to PPTX把 AI 生成的 mockup 或截图重建成可编辑幻灯片提供一张或多张图片并要求把图中页面重建成可编辑 PPTXPPT Master 会路由到Image to PPTXimage-to-pptxprofile。该 profile 目前要求 Codex——其他 Agent 宿主尚未适配行为不受支持也不作承诺。它始终自动激活 Quick无需单独要求。流程与规则要点先把所有输入归一化为一个有序页面帧名册page-frame roster因此页数跟随被表示的页面数而非文件数普通可见文本重建为原生可编辑文本Logo、图标、徽章、装饰图形源素材足够时直接采用分辨率过低时 Codex 可以基于参考重建但身份、轮廓、比例、颜色与字标必须固定禁止神似替代图表、表格、数据图形绝不生成式重建它们必须是数值可验证的原生对象、精确源素材或标记为manual_required照片与插画场景重建为至少一个干净底层 主体/前景层多个不重叠、带 padding 边界框的对象可共用一张生成底版再通过网格切分或 SVG 边界框裁剪变成相互独立的 PowerPoint 图片对象AI 可以重建被分离图层遮挡的像素但不得重新设计可见构图整页截图皮肤 少量可编辑 token 叠加不算重建。五、原生可编辑性与导出机制5.1 生成的演示文稿可编辑吗可以。SVG 管线中唯一的 PPTX 转换器就是 PPT Master 自己的svg_output/→ DrawingML 转换它把带时间戳的原生 PowerPoint deck 存入exports/文本、图形、颜色都可以直接作为 PowerPoint 对象编辑。在默认输出路径下Default Generate 与 Quick Generate 都会把创作期svg_output/拷贝到backup/timestamp/svg_output/因此同一份创作 deck 可以不重跑 LLM地重新导出对 Quick 而言这是包的重建而不是可恢复的 AI 设计决策记录。finalize_svg.py 在默认 Generate 流程中仍是必做的 Step 7——尽管原生 PPTX 导出读的是svg_output/。它产出svg_final/中的自包含文件供视觉检查也供手动以 SVG 图片形式插入其他 deck。显式 quick-generate profile 跳过该预览产物但仍保留正常 postflight 报告与默认路径备份在其无锁最终质量检查之后。PowerPoint 手工的Convert to Shape不是受支持的往返路径需要可编辑形状时请使用生成的原生 PPTX。5.2 多行文本如何导出PowerPoint 会重排吗默认行为可合并的多行块导出为一个可编辑的 PowerPoint 文本框。创作期换行被保留PowerPoint 自动换行被禁用因此拉伸文本框不会改写你排好的行布局。普通生成框使用 PowerPoint 原生的Resize shape to fit text行为删除保留的换行时文本框会扩展而不是把文本甩到框外。导入的精确框与结构化多行占位符载体则保留固定尺寸行为。从源码看这一行为由 svg_to_pptx 的 CLI 中一个互斥参数组控制--reflow-text、--merge-paragraphs兼容别名、--no-merge三选一默认值为保留PRESERVE模式想让 PowerPoint 对合格正文自动重排可能改变行数python3 skills/ppt-master/scripts/svg_to_pptx.py project_path --reflow-text旧参数--merge-paragraphs是--reflow-text的兼容别名。只有当每一条视觉行都必须是独立 PowerPoint 文本框时才用--no-mergepython3 skills/ppt-master/scripts/svg_to_pptx.py project_path --no-merge该模式保留逐行独立对象定位但一段 12 行的文字会变成 12 个文本框。与 AI 对话时说自动文本重排或每条视觉行一个独立文本框即可选择对应导出模式。5.3 为什么字号是 px 不是 pt导出会变吗PPT Master端到端使用无单位 px——确认页、spec_lock.md与 SVG 全部是 px没有 pt 层。SVG 画布就是 1280×720 pxpx 是真实的布局/执行单位单一单位避免了确认为 20pt 但写进 SVG 时变成另一个数字的尺寸漂移。PowerPoint 显示 pt因此导出时自动把 px 转 ptpt px × 0.75保留一位小数。这一换算在转换器工具中是硬编码常量drawingml/utils.py 中FONT_PX_TO_HUNDREDTHS_PT 75 # 1px 0.75pt - 75 hundredths-of-a-point。例如24px正文变18pt42px标题变31.5pt。所以 PowerPoint 里出现的13.5pt、31.5pt这类非整数值是预期且刻意的不是 bug——字号就是 px 折算出来的值不再被强制对齐到整点或半点。正文基线是按阅读模式reading mode取定的固定值不是区间控制阅读距离与密度它与不设上限的沟通意图相互独立阅读模式正文 px≈ 导出 pttext近读报告 / leave-behind20px15ptbalanced默认路演 / 评审24px18ptpresentation投屏 / 发布会32px24pt标题、副标题、脚注等其余角色按正文比例推导并吸附到整洁的偶数 px。确认页上可以覆盖任意角色的 px 值。六、风格如何决策Mode × Visual Style两个相互独立的选择在确认点d处锁定Modedeck 如何论证pyramid/narrative/instructional/showcase/briefing——参考references/modes/目录Visual style看起来什么样swiss-minimal/editorial/soft-rounded/dark-tech… 外加custom——参考references/visual-styles/目录。任意 mode 可搭配任意视觉风格。七、成本与模型选择7.1 使用 PPT Master 贵吗PPT Master 本身免费且开源唯一成本是你自己的 AI 模型用量。行业内的 AI 工具普遍转向按用量计费——为实际消耗付费。PPT Master 天然适配这一模式没有额外的 PPT 订阅、没有专有积分、没有按席位收费的演示平台层。由于它运行在 coding agent 内按包月订阅的计划可以零额外单份成本地产出多份 deck按 token 直连 API 只是另一种价格结构——由你选择。无论如何PPT Master 不会在你的 AI 开销之上叠加任何自己的费用。7.2 哪个 AI 模型效果最好ClaudeOpus / Sonnet是推荐且测试最充分的模型。SVG 布局需要精确的绝对坐标计算字号 × 字符数 × 容器宽度Claude 在这类任务上的表现显著优于多数替代方案。GPT 系列旧版本更容易出现布局问题——文本溢出容器、元素错位、坐标算错较新版本如 GPT-5.5有明显改善实际可用出问题就告诉 AI 修哪一页。其他模型Gemini、GLM、MiniMax 等质量不一总体规律是前端/视觉能力越强的模型结果越好。7.3 PPT Master 只是个玩具这个说法公平吗不公平。PPT Master 是一条演示工作流不是模型也不是完整 Agent。它提供演示专用的推理、契约、项目状态、确定性转换与质量门所选模型仍然决定质量上限。用弱模型或短上下文模型评测这条工作流相当于挂着一档试跑跑车然后得出结论它很慢。满配组合大上下文窗口的 Claude理想约 1M tokens大窗口让 Executor 在同一会话里看到此前生成的每一页全程无需分次运行即可维持整套 deck 的视觉一致性。小窗口被迫进入分段执行split mode阶段之间会出现可见的风格漂移。gpt-image-2或同级AI 图像生成占位级的图库图是 deck 显得平庸的第一大原因换成贴合品牌的 AI 生成插画观感会立刻改观。如果你看到的结果平庸先检查自己的配置再下结论什么模型多大上下文开了图像生成吗PPT Master Claude Opus1M 上下文 gpt-image-2 图片与PPT Master 小型开源模型 未配置图像 API是完全不同的体验。八、原生对象图表、公式与超链接8.1 生成的 PPTX 中图表可编辑吗默认情况下图表渲染为自定义设计的 SVG 图形再转换为原生 PowerPoint 形状——作为形状完全可编辑移动、改色、改字、改样式。这是刻意选择而非 Excel 驱动的图表对象PowerPoint 默认图表观感通用且过时还会把 deck 锁死在僵硬模板里。SVG 图表给你可直接在 PowerPoint 中微调的出版级视觉并在 PowerPoint / Keynote / LibreOffice / WPS 间像素级一致地渲染。如果你的工作流确实需要 Excel 驱动的数据编辑或 PowerPoint 图表/表格专用控件用--native-charts-and-tables导出受支持的数据图表与纯文本网格表格会作为带数据支撑的 PowerPoint 原生 Chart / Table 对象输出保存为exports/name_timestamp_native_charts_tables.pptx保留 deck 自身配色而非 PowerPoint 默认主题。该开关定义于 svg_to_pptx CLI。默认的 SVG 回退路径同样导出为可编辑 DrawingML 形状但不带图表数据工作簿或表格/图表对象模型。原生对象在 PowerPoint / Keynote / LibreOffice / WPS 之间可能有细微视觉差异因此形状路线仍是视觉稳定性默认值。8.2 公式可编辑吗在 PowerPoint 中可以。PPT Master 把独立块级公式与同段落内联公式都导出为可编辑的 OMML而不是截图或图片资产块级公式用 formula group内联公式用普通文本 run 之间的叶子节点tspan>python3 skills/ppt-master/scripts/svg_to_pptx.py project -t push # 换一种过渡 python3 skills/ppt-master/scripts/svg_to_pptx.py project -t none # 关闭过渡 python3 skills/ppt-master/scripts/svg_to_pptx.py project -a auto # 启用逐元素入场效果由分组 id 映射 python3 skills/ppt-master/scripts/svg_to_pptx.py project --animation entrance_fade # 用单一规范效果启用 python3 skills/ppt-master/scripts/svg_to_pptx.py project --animation emphasis_spin # 原生强调效果 python3 skills/ppt-master/scripts/pptx_animations.py --list # 完整分类效果清单 python3 skills/ppt-master/scripts/svg_to_pptx.py project -a auto --animation-trigger on-click # 演讲者手动节奏揭示on-click面向现场演讲。通过--recorded-narration的旁白/视频导出会拒绝on-click因为 PPT Master 写入的是页面时序而非对象级点击时序旁白 deck 请使用after-previous或with-previous。常用命令、Start 模式指引与对象级定制见 Animations Transitions完整效果与校验行为以该执行参考为准效果清单可由 pptx_animations.py 列出。十、质量排障、生成时长与上下文管理10.1 文字溢出或元素错位怎么办先定位错位出现在哪一层如果源 SVG 本身就溢出或错位通常是创作/布局问题——模型必须正确计算坐标、字体度量与容器尺寸如果 SVG 预览正确而导出 PPTX 不同那可能是转换器或渲染器 bug应同时附上两份产物上报。可尝试的修复对比svg_output/中的该页与导出的 PPTX隔离创作问题与转换问题告诉 AI 具体哪页有问题并描述现象——它可以只重生成个别页如果 SVG 本身反复出错换更强的模型或直接让 AI 修正坐标记住生成的 PPTX 是高质量可编辑草稿不是密封的最终交付物——在 PowerPoint 中做轻微收尾调整是预期内的。10.2 生成一份演示文稿要多久典型 10–15 页的演示文稿在快速模型上大约10–20 分钟。生成是刻意串行的一次一页以维持跨页视觉一致性——并行生成被测试过会产生风格不一致。如果感觉慢先检查模型的 token 吞吐。瓶颈通常在模型输出速度而不是脚本。10.3 长 deck 会不会一次打爆上下文窗口默认推荐连续一次性生成。10–15 页的 deck 在 200K 窗口内很从容而且当 Executor 能在同一会话看到前序页面时跨页视觉一致性最好它会主动对齐风格、字号与节奏。当当前 AI 编辑器支持隔离的研究 worker 时topic-research会把原始抓取留在那里主对话只读取保存的研究补充与事实溯源文件。只有当信号偏重≥ 18 页、源材料厚重、或本地回退/异常大的导入补充之后主对话仍留有大量研究材料时AI 才会在 Strategist 阶段给出**可选的分段模式split mode**提示规划会话Strategist 确认 图片获取在当前对话收尾你开一个新聊天窗口输入resume execution projects/project_name进入执行会话SVG 生成 导出。新会话从磁盘重新加载design_spec/spec_lock/sources/images并继续。分段模式是一种折中——新会话要支付重新加载 Generate 权威文档与必需执行参考的固定成本但丢掉了规划会话的噪声并把腾出的预算用于重读sources/以获得更丰富的页面内容。信号正常时不需要提示不会出现你随时可以无视提示留在连续模式。10.4 整页导出前能预览或修单页吗能。你可以在任何时刻打断工作流——前几页生成后审阅并给反馈AI 可以根据你的评论重生成指定页面不必等到最后再修正。生成后修复也一样直接告诉 AI 第 3 页有布局问题——标题压住了图表它会修对应的 SVG。十一、跳过设计确认Quick Generate不想先确认设计规格、想直接生成显式要求 quick generationGenerate 路由会使用 quick-generate profile。它跳过的是Strategist 分析、design_spec.md/spec_lock.md产物、以及分阶段确认停顿——你显式说出的部分被遵循未指定的部分由当前 Agent 直接决定并继续不再回来征求批准。什么都不说Agent 就决定一切。它同时跳过finalize_svg.py因此 Quick 不产生svg_final/预览。它不跳过准备与设计能力。源转换、针对已识别事实缺口的调研、共享审美参考、deck 所需的一切资源在需要时仍然执行提供或提取的图片、AI/网络/切片图片、项目图标、原生形状、图表/表格以及必需的操作 manifest 或溯源记录。公式直接在受影响的 SVG 中写为 PowerPoint 原生标记而不是准备成图片资产。若必需素材未就绪流程仍会停下来向你索要而不是拿不相关材料顶替。准备完成后当前 Agent 按共享标准手写svg_output/跑无锁的 Quick 最终质量检查器修完所有阻断性错误后才导出最终 PPTX。普通导出器能力按需保留包括原生图表/表格替换、备注、动效、旁白与诊断备注、自定义对象动画与旁白默认关闭Agent 可在请求或 deck 需要时直接启用无需打开确认流程。默认路径导出会写正常 postflight 报告并把svg_output/快照到backup/显式输出路径保持普通的无备份行为。页数本身既不会激活也不会阻止 quick generation。由于整个规划阶段不再发生token 用量显著低于默认流程而逐页 SVG 创作是一次运行中的主导成本且不会缩水。Quick 保持同样的页级视觉与资源创作能力、同样的共享 SVG/资源阻断标准它不跑 Spec Lock 对齐检查其包保留转换器默认 Theme 脚手架而不是从 lock 推导 Theme 颜色、字体与 Master 标题/正文尺寸默认值。由于没有确认过的设计契约、首页校准或可恢复的决策历史它不承诺与 Default 相同的设计决策或墙钟时间。十二、复用已有 PPT路由决策与模板体系12.1 已有 PPT 想在其基础上做——选哪条路由把使用已有 PPT拆成两个问题保留内容还是不要、保留设计布局 视觉还是不要。四种组合对应三条生成路径加一个保持原样选项意图路由固定不变的部分保留内容 重做布局Generate PPTX beautify profile页数、页序、每页文案、图表/表格数据替换内容 保留设计Fill Native PPTX原生源幻灯片设计选定页可复用/重排只保留内容重做设计与分页Generate PPTX源事实故事结构与页数可变内容 设计都保留无需生成直接用原文件源 deck 的分页本身属于交付物时用beautify profile文本逐字保留页数与页序 1:1 保持只重做布局/层级/留白并继承原配色/字体。说法示例让这份 deck 更好看 / 重新排版这个保留文案。见 beautify profile。源 PPT 只是素材时用主管线用ppt_to_md抽成 Markdown从analysis/读取 PPTX intake 事实再让 Strategist 自由重构大纲合并/拆分/重排页面。说法示例用这份的内容做一份更好的 deck或把它变成一份 10 页的高管简报。beautify 与主管线之间的一行判别标准源的分页是需要保留的信息还是只是上一位作者可改进的结构保留 → beautify改进 → 主管线。具体判据是页数/页序只要它发生任何变化——拆、合、删、重排甚至一字不改但把一页拥挤页拆成两页以便阅读——那就是重分页属于主管线。Beautify 严格 1:1。若请求含糊例如让这份 PPT 更专业或优化这份 deckAI 应路由前问清一句保留原始页数/页序与每页文案还是把 PPT 当源材料重构为新故事另有一条正交路线现在不想产出 deck但想把设计沉淀为可复用模板——用create-template见 12.4。12.2 已有成品.pptx只复用设计、填入新内容可以——这是**模板填充template fill**路由独立于 SVG 生成管线。把你的.pptx与素材或主题交给 AI说用新内容填充这份 deck或填回这个模板。它把你的 deck 当作原生幻灯片库你可以只挑选契合新故事的页自由重排一页可服务多个输出页然后把新文本——以及原生表格单元格与图表数据——直接写回原始 OOXML。输出保持 100% 原生可编辑原设计、版式、图片、动画全部保留只导出选定页。它刻意不改版式、不加页、不换图——一份 deck 的页面结构编码了它的逻辑先总后分、对比、递进因此应挑选结构本来就契合内容的页面而不是硬塞。要全新结构或不同页数改用 create-template下一节。完整步骤见 template-fill workflow。12.3 内容落到了意外位置——如何查看 PPT Master 检测到了什么两条消费 PPTX 的路由在生成任何内容前都会写一份只读分析报告读它就能看到精确识别了哪些形状。Fill Native PPTX使用python3 skills/ppt-master/scripts/pptx_intake.py deck.pptx -o analysis_dirstem.slide_library.json列出每页所有可填充槽位含几何、段落数、文本度量以及独立的tables与charts节。带样式的普通文本框也算槽位——形状不必是真正的 placeholder 才可填充。Create Template使用python3 skills/ppt-master/scripts/pptx_template_import.py deck.pptx --manifest-only -o workspacemanifest.json 按页报告版式与母版路径、占位符type、idx、semanticRole、shapeName、图片资产、文本计数与页面类型native_structure.json补充源结构评估。--manifest-only跳过 SVG 导出因此只看不做时运行成本很低。注意 Create Template 产出的是可复用模板工作区不是填好的 deck后续页面由 Generate 新创作因此源文件的正文文案与演讲者备注刻意不带到新页上。如果你预期可用的形状在这些报告中缺失那就把它写进 issue。12.4 如何创建自定义模板想把喜欢的 PPT 变成 PPT Master 的可复用模板分三步Step 1 — 准备参考材料推荐输入是原始.pptx。PPT Master 会提取主题身份、声明的 Master/Layout 拓扑、占位符元数据、原生形状证据以及实际存在且受支持的复用资产。standard与fidelity以源为视觉参考创作新的 SVG 名册加新的 Master/Layout/槽位系统——既不保留也不蒸馏源拓扑mirror则把已验证的源事实直接物化进新工作区不做语义综合或缺口填补。固定的 Master/Layout 分组包装器会被机械展开为直接原子因为结构层不能是g。大型导入 SVG 可能携带原生形状元数据、隐藏载体与预览指纹该无损表示作为 payload 支撑保持在临时分析工作区中不可变。模板创作使用带文档本地源引用与紧凑 path/hash manifest 的轻量可编辑 IR。standard/fidelity创作项目规范 SVG并仅对精确注册的 preset 匹配使用紧凑创作 preset 组。Mirror 从 IR 物化最终模板仅对未变化的 Slide 本地/槽位引用复用转换器支持的 payload对不支持或被编辑过的对象保留 SVG 回退。没有源 PPTX 时关键页类型的截图也能工作——封面、目录、章节、内容、结尾——但几何、字体与继承必须靠视觉推断。这条路径提取的是可复用模板系统若期望产物是每个被表示页帧一张分层可编辑幻灯片请改用 Image to PPTXimage-to-pptx。Step 2 — 让 AI 创建模板用任意具备 Agent 能力的 AI 工具Claude Code、Codex 等要求它使用 PPT Master 的/create-template工作流create-template把参考材料转成模板。给得越具体越好模板名称与目标用途如政府报告、高端咨询期望语气与配色如现代克制、深蓝为主类别偏好brand/general/scenario/government/special画布格式非默认 16:9 时输出范围带索引的library默认或一个已初始化的project两者使用相同的工作区路由并省略空的可选资产目录。不必一次给全细节——AI Agent 会对缺失项输出范围、模板 ID、主题模式等追问。Step 3 — 等待结果AI Agent 负责其余步骤分析参考、编写按类别的规格、仅为 Layout/Deck 构建结构化布局定义、校验工作区。Brand/Style 永不创建预览 PPTXLayout/Deck 按需生成exports/id_template_preview.pptx多 Master 时必需。两种范围都要求templates/Brand/Layout/Deck 可用包内images/与icons/Style 只含templates/design_spec.md。Library 范围写入skills/ppt-master/templates/kind/id/并注册project 范围写入projects/name/并跳过注册。空可选目录被省略。兼容的 legacy-flat Brand/Layout/Deck 工作区仅在满足当前 kind 契约时保持可读Layout/Deck 还要求当前结构化 SVGs。Style 没有 legacy-flat 形态semantic-legacy 包必须通过create-template替换而非就地升级。提示风格与用途说得越具体生成的模板越贴合你的预期。结语延伸阅读入口本文按 FAQ 的问题边界重组了 PPT Master 的常见技术疑问并用仓库源码印证了关键结论文本重排的互斥 CLI 组cli.py、px→pt 的 0.75 换算常量utils.py、--native-charts-and-tables开关定义cli.py以及各脚本与工作流文档的真实落点。进一步深入时建议按主题跳转能力与边界的逐特性记录见 PowerPoint ↔ SVG 映射指南动画细节见 Animations Transitions完整技能契约见 SKILL.md仓库协作约定见 AGENTS.md真实生成效果可直接翻阅 examples 目录。【免费下载链接】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），仅供参考