PPT Master 模板系统实战指南:四类模板的使用、从 PPTX 派生与边界规则
2026/9/7 1:24:52 网站建设 项目流程

PPT Master 模板系统实战指南:四类模板的使用、从 PPTX 派生与边界规则

【免费下载链接】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 的模板不是“换皮肤”的 PPTX 样式包,而是由Brand / Style / Layout / Deck四类可复用工作区(workspace)构成的契约体系:Brand 掌管身份识别、Style 掌管可移植的沟通方法与视觉默认值、Layout 掌管品牌中立的页面结构、Deck 掌管一套含身份与结构的重复性演示应用。读完本篇,你将能够:正确使用仓库内置模板库生成带原生 Master/Layout 的 PPTX、通过/create-template工作流把自己的 PPT 或品牌资产派生为可复用模板、理解模板安装的底层规则并验证产物中 Master/Layout 是否真正生效。

1. 60 秒选型:三条路线与四类工作区

先根据“手里有什么、想要什么”选择路线:

起点与目标路线可直接复制的请求
一个原始.pptx;保留其现有页面骨架、只替换内容Fill Native PPTXFill projects/source/template.pptx with projects/source/content.md.
一个可复用的 Brand/Style/Layout/Deck 工作区;生成一套新 deckGenerate PPTX → Stage-1 模板选择Make a deck from sources/report.pdf with template skills/ppt-master/templates/layouts/presentation_core/.
PPTX、SVG 集、品牌手册、网站、图片等混合参考;先建成可复用体系Create Template → Generate PPTXUse /create-template to create a reusable Deck workspace from projects/brand/our_deck.pptx.

关键禁忌:不要把原始.pptx当作 Generate PPTX 的模板路径。想沿用它的现有页面就直接 Fill;想要可复用体系就先跑 Create Template。

四类工作区按“必须复用什么”来区分:

类型复用的内容原生 PowerPoint 产物
Brand颜色、字体、Logo、语气、图标风格仅身份约束。生成的页面在单个干净的项目 Master 与 Blank Layout 之下保持 Slide-local
Style沟通方法、开放的页面角色词汇、证据/数据规则、视觉默认值、图片/图标方向、建议性审查重点扁平的 Slide-local 页面。Style 值为最终 Stage 2 提供种子,但不构成品牌身份或可复用 Layout
Layout品牌中立的页面语法、Master/Layout 标识、语义文本角色、slot 与页面清单(roster)带可复用原生 Master、具名 Layout 和 placeholder 的结构化 deck;身份、阅读模式排版与沟通应用另行解析
Deck一套重复出现的演示家族:描述性应用场景 + 整合的身份与结构 + 实际原型页面/原型应用方案由 AI 基于模板与当前内容推导

需要强调:Theme、Slide Master、Slide Layout、Placeholder 是原生 PowerPoint 对象,不是第五种工作区类型——Brand 与 Layout 规则会被“编译”进这些对象。在layout复用模式下,语义文本角色来自 Layout,而最终字体与字号标尺从身份和阅读模式解析;mirror模式则保留源文件的字面格式。因此最终的 Master 可以同时包含结构几何与品牌视觉,尽管它们的来源契约彼此独立。

2. 使用现有模板:Stage-1 选择机制

2.1 选择如何发生

Default Generate 把模板选择放在Stage 1,与不依赖模板的沟通契约并排。页面首先展示可切换的 Free design / Use templates 两个选项:

  • 普通请求初始化 Free design,详细选择器保持折叠;
  • 明确的模板意图或任何一个精确的工作区根路径会初始化 Use templates,并展开已注册的 Brand/Style/Layout/Deck 加本次提供的根路径候选;
  • 恰好提供一个根路径时该路径被预选;提供多个根路径时它们保持为未选中的候选;
  • 系统不会根据主题猜测任何模板。

Quick Generate 例外:Quick 永不打开该页面。请求中每类最多提供一个精确工作区根路径,经验证后直接安装使用;没有精确根路径即回退 free design。Quick 保持无锁扁平导出,因此 Layout/Deck 原型只是创作输入,而不是可复用的原生 Master/Layout 输出。

2.2 选择器怎么用

在 Stage-1 页面选择 Free design 或 Use templates。只有 Use templates 会展开五个紧凑下拉框:分别对应已注册的 Brand、Style、Layout、Deck 工作区,以及本次运行提供的精确根路径。每个下拉框单选且包含None;四类已注册项可以组合,而指定根路径通道最多贡献一个工作区。列表只来自四个类型索引,工作流从不扫描模板目录

想让模板模式打开并预选某条路径,把精确的 Brand/Style/Layout/Deck 工作区根路径发在聊天里即可,位置不限,路径无歧义就行:

“use this template:skills/ppt-master/templates/layouts/presentation_core/” ✅ “use last deck's template:projects/last_deck/” ✅ “make a product introduction with/Users/me/Desktop/our_brand_v3/” ✅

对当前所有模板类型,显式路径都指模板工作区根。与已注册索引条目匹配的精确根路径可以显示为library;未注册的根路径保持explicit标签。服务端会解析后者的真实 frontmatterkind——explicit只是来源(provenance),不是第五种类型,也不是优先级层级。Stage 1 验证所选候选根路径后,Brand/Layout/Deck 安装其包内templates/加任何真实存在的images/icons/,Style 只安装其 spec 并忽略无关的项目脚手架;任何情况下都不复制exports/。Layout/Deck 工作区额外校验结构化 SVG 契约,Brand/Style 校验其无清单(roster-free)spec。路径可以指向skills/ppt-master/templates/<kind>/<id>/下的内置库工作区、projects/<name>/下的项目工作区,或其他具有相同路由结构的工作区。Create Template 运行完成后,也可以在同一个会话里把其经验证的确切工作区根路径直接交给下一个 Stage-1 选择器。

模板选择与 Stage-1 共享同一屏幕和提交动作,但它是独立的 sidecar 决策:沟通建议只依据当前请求、源事实、会话约束与项目初始化来撰写,候选元数据、所选根路径、已安装内容与模板画布尺寸都不允许影响它。合并确认后,非 free 的选择执行公共 apply 阶段,把所选工作区安装到项目的templates/images/icons/;最终 Stage 2 再把已确认的沟通契约与安装状态比对——template_application只描述如何使用模板,从不决定用哪个模板。

兼容性预检:Generate Step 3 还接受design_spec.md直接位于提供根路径上的 legacy-flat Brand/Layout/Deck 工作区,前提是它满足当前类型契约。Layout/Deck 额外要求当前结构化 SVG;Style 没有 flat 形态。旧版原子 placeholder 包、未映射 Master/Layout 包及其他语义遗留包会被直接拒绝——需用create-template新建工作区,再从中生成新的结构化页面。旧包不会被原地升级。

2.3 什么不会自动选中模板

  • 聊天里出现模板裸名:“presentation_core” / “China Telecom template” 不会被隐式解析或预选。请在页面上选择已注册条目,或在聊天中返回其精确路径。
  • 风格描述:“McKinsey style” / “Google style” / “minimalist” / “Keynote style” 仍然是设计简报,永远不会激活任何工作区,除非用户显式选择或提供其精确根路径。

这是刻意设计:AI 从不做“这句话是否映射到某模板”的模糊判断。Default Generate 中 Stage-1 模式开关始终可用,只有从索引控件中选出的精确根路径才会激活工作区。

想在聊天中浏览,直接问 “what templates are available?”。聊天列表与 Stage-1 选择器读的是同一组四个索引,列表本身不选择任何东西——返回其中一条精确路径或在页面上做出选择。

2.4 可直接复制的示例

使用单个工作区:

Make a deck from projects/q3-report/sources/report.pdf. Template workspace: skills/ppt-master/templates/layouts/presentation_core/

组合身份与结构:

Make a product-launch deck from projects/launch/sources/brief.md. Brand workspace: skills/ppt-master/templates/brands/anthropic/ Layout workspace: skills/ppt-master/templates/layouts/presentation_core/

使用此前创建的项目级模板:

Make a deck from projects/annual-report/sources/report.md. Template workspace: projects/acme_template/

基于聊天的精确根路径选择中,路径标签可省略,但精确根路径是必须的。页面允许每类一个已注册选择加一个指定根路径;若指定根路径解析出的 kind 与某个已注册选择相同,工作流会停在该类既有的双工作区冲突解决关口,而不是默默替用户选一个。

不需要指定模板使用模式。对 Layout/Deck,Strategist 会读取真实的 Master/Layout/原型清单与当前内容,自行决定哪些页面选用、重复、跳过、重排或重组;Brand 提供身份约束,Style 提供方向/方法默认值,两者在未获得结构工作区时页面仍自由编排。如果在意某个边界,在同一请求里用普通语言说明即可——例如“cover 和结尾页保持原样,中间页你自己选”或“只用它的视觉语言”——这句显式说明优先于 AI 判断。

2.5 模板目录:四个类型索引

模板按四类组织,每类有一个发现索引(以下四个索引已确认存在于仓库):

  • brands_index.json— 纯身份工作区:颜色/字体/Logo/语气/图标风格,无 SVG 页面清单。当前库含 accenture、alibaba、anthropic、aws、bain、bcg、deloitte、google、huawei、ibm、jpmorgan、mckinsey、microsoft、nvidia、pwc、tencent、xiaomi 及“中国电信”“中国电建”“中汽研”等 20 个品牌,每条带summaryprimary_color
  • styles_index.json— 方向/方法工作区:沟通方法、证据/数据表达、视觉默认值与建议性审查重点,无 SVG 页面清单。当前库含 academic-research、consulting-decision、investor-pitch、narrative-keynote 等 12 个条目
  • layouts_index.json— 纯结构工作区:画布/页面语法/页面类型/SVG 清单,身份在下游选择。当前库含 presentation_core(16:9、20 个 Layout)、presentation_core_43(4:3)、report_core(双 Master 报表)、editorial_bleed、moments_square、story_vertical(9:16)、xiaohongshu_post(3:4)共 7 个
  • decks_index.json— 含整合身份、结构与事实性原型描述的重复性演示应用。当前库含“中国电信”“中汽研”两个 deck

这四个索引是 Default Stage-1 模板控件与聊天发现的完整已注册库来源,目录永远不会被扫描。

2.6 Free design 与模板的区别,以及 Style 简报 ≠ Style 工作区

Free design 不是“没有结构”或“没有风格”——Strategist 仍会为这一套 deck 规划叙事、层级与视觉系统。其生成页面使用pptx_structure.mode: flat,所有可见对象保持 Slide-local;Brand-only 与 Style-only 工作区同样保持flat。经验法则:身份必须固定 → 用 Brand;可复用的方法/视觉方向需要跨项目迁移但没有页面原型 → 用 Style;品牌中立结构可复用而用途仍开放 → 用 Layout;带品牌结构的体系或重复性沟通应用要作为一个契约整体迁移 → 用 Deck;构图只应来自当前内容 → 用 free design。

Style 简报是解释性语言(“minimalist” / “Keynote-style” / “editorial”),由 Strategist 转译成一套 deck 的具体设计决策;Style 工作区则是真实的kind: style模板,携带预先写好的沟通方法与视觉默认值,且只有在用户选中其已注册条目、提供其精确工作区根、或经由当前 Create Template 交接后才被消费。

Style 工作区Style 简报
触发方式Stage-1 模板选择、精确目录路径,或当前 Create Template 交接消息中的自由描述;不选择任何工作区
提供内容可复用方法、角色/证据纪律、视觉默认值;无身份真相或页面原型Strategist 解释为模式、视觉风格、颜色、字体、图标与图像的意图
确认方式存储值进入最终 Stage 2 种子;Brand/Deck 身份与用户确认项仍权威无预置值;Strategist 提出具体候选,用户确认
最适合跨项目重复同一种设计/论证方法而不冻结页面只表达当前项目期望的感觉

Strategist 解释风格简报时会分离两个独立选择:Modepyramidnarrativeinstructionalshowcasebriefing或确认后的custom)控制 deck 如何沟通;Visual style(内置如swiss-minimaleditorialdark-techdata-journalismink-wash等,加custom)控制页面看起来怎样。任何模式可配任何视觉风格,“Keynote-style product launch”这类词可能同时影响两个轴,但永远不会成为模板查找 token。规范目录位于references/modes/references/visual-styles/

3. 派生新模板(本篇重点)

把一份或多份 PPTX/SVG 文件、图片/PDF、文档/网站、品牌资产,甚至一段书面需求,变成 PPT Master 模板。参考来源可以任意组合;也可以没有外部来源,仅凭确认过的 brief 从零设计。

3.1 入口:/create-template工作流

完整规格见 workflows/create-template.md。在 IDE 里只需要说:

Please use the /create-template workflow to generate a new template based on the reference materials below.

工作流随后会强制与你确认一份模板 brief,才做任何事情(此关口不可跳过)。入口名始终是Create Template,且恰好派发一个子工作流:Create Brand(仅身份)、Create Style(无原型的可移植方法/方向)、Create Layout(沟通应用仍开放的、品牌中立的结构)、Create Deck(带品牌的结构体系或重复性演示应用)。仅有一份完整的源 PPTX 并不决定类型——工作流会分类其中值得复用的稳定规则,选定的子工作流在 brief 内不再被重新考虑。

3.2 Step 1:准备参考包或 brief

可提供的渠道包括:直接对话文本、粘贴的需求、Markdown/TXT、DOCX/PDF/HTML/URL、网站、图片/截图、Logo/图标/字体资产、PPTX/SVG 文件,或任意组合。工作流分析每个适用渠道、保留来源出处(provenance),并在强制 brief 中把冲突浮出水面,而不是默默选一个来源。你亲自写下的精确值无论在聊天、粘贴文本还是你自己的 brief 文件里,都是“决策”而非“事实”;事实需要可独立追溯的外部权威或机器可观察的源元数据;视觉估算与模糊文本解释在被确认前都只算建议。

当现有 deck 的原生结构重要时,请交出原始.pptx文件。导入器直接读 OOXML,把实际存在且受支持的 Master、Layout、placeholder、主题、原生形状与可复用资产事实提取进分层分析参考。你用普通语言说明想要的结果即可——例如“原样保留”“抽出一套可复用 Master/Layout 体系”“保留视觉语言但重做结构”,然后由它选择兼容的内部实现。原始 PPTX 保持为不可变的分析证据,不会被打包进新模板。

也可以从品牌手册从零设计:提供 Logo、主色 HEX、字体、语气描述和几张情绪参考图——AI 会当场设计页面骨架。适合还只有 VI 手册、没有成品 PPT 的品牌。

证据边界:图片、截图、文本、文档、网站与零散资产可以驱动一份全新撰写的模板;但“宽覆盖的源对齐”需要 PPTX/SVG 页面证据,“字面原生保留”需要原始 PPTX 或完整的当前结构化 SVG 契约。补充来源可以澄清保留意图,但不能发明或改变原生拓扑。

3.3 Step 2:模板 brief(强制确认)

生成前,工作流写一份简洁的自然语言提案并等待你修正或接受。它不会让你选模板模式、保真枚举或页面/内容策略。brief 字段如下:

字段说明
输出范围library(默认)或project;两者使用相同的可移植工作区路由,只有 library 范围做全局注册
目标项目project范围必填;给出精确的已初始化项目路径
选定子工作流Create Brand / Create Style / Create Layout / Create Deck,由入口派发固定
模板 ID可移植模板标识;library 范围下也是目录/索引键。优先 ASCII slug 如acme_consulting;非 ASCII 名称可用但须文件系统安全
显示名供文档使用的人类可读名称
类型相关上下文Brand:身份用例与语气。Style:广泛适配场景 + 发现关键词。Layout:结构兼容场景 + 分类/关键词。Deck:重复性应用 + 分类/关键词。可直接修正正文
方法与视觉默认值仅 Create Style:沟通方法、开放页面角色词汇、证据/数据表达、视觉默认值、图片/图标方向、建议性审查重点;无受众/页面/结构契约
身份仅 Create Brand/Create Deck:调色板、字体、Logo、语气与图标身份
画布与结构仅 Create Layout/Create Deck:画布、页面语法、Master/Layout/slot 规划、密度行为、来源推导的结构规则
来源处理每个子工作流声明其在所属 segment 内提取什么;只有 Layout/Deck 描述原型广度、保留/重建策略与原生结构
来源事实与资产Brand/Layout/Deck 列出采纳或排除的资产;Layout/Deck 另报告可观察的 Master/Layout 事实与受支持的原生特性。Style 只保留文本出处

确认之后,工作流回显最终 brief 并发出标记[TEMPLATE_BRIEF_CONFIRMED];后续步骤只在该标记之后运行。这是硬关口——没有 brief,就没有生成。

在任一范围写入最终文件之前,还有一道硬预检:解析必需的templates/目标与可选资产目标、要求templates/根为空、拒绝images/icons/imported/中的位图或导入矢量文件名冲突;仅在请求了审查 PPTX 时检查exports/。项目范围额外要求目标项目已初始化。项目初始化创建的空脚手架被允许且原样保留;Create Template 不会仅为保留空路径而创建可选目录。任一检查失败都会在任何部分输出之前停下——工作流从不合并或覆盖。

为什么这么严格?模板是一份可复用的所有权契约,无论全局还是项目范围。先确认所拥有的 segment 与目标位置(Layout/Deck 还要确认几何),才能避免部分输出或错位输出。

3.4 Step 3:AI 推导实现

Create Style 直接写入其确认的方向/方法 spec,不进入 SVG 创作模式。对 Create Layout/Create Deck,你不选择任何创作模式——AI 把确认过的散文翻译成一个内部策略供确定性工具执行:

  • 请求要求提炼时,产出紧凑可复用体系;
  • 源本身包含有用变体时,做更广的源对齐覆盖;
  • 请求要求保留且源具有完整受支持的结构契约时,做字面物化(literal materialization)。

Layout/Deck frontmatter 仍记录replication_mode: standard|fidelity|mirror,但那是为实现兼容与审计而存的实现记录,不是面向用户的选择。Style frontmatter 刻意不含任何 replication/原生结构字段。

关于 sprite sheet(雪碧图):PPTX 导出资产常常是单张大图被多张 slide 引用,各自用嵌套<svg viewBox=...>包裹裁出不同区域。fidelitymirror模式下必须保留这种嵌套——压平成裸<image>会丢失裁剪、页面错位。工作流会自动校验这一点。

关于原生 PowerPoint 形状:无损导入 SVG 在临时分析工作区中保持不可变,作为原生 payload 的底座;模板创建使用轻量可编辑的authoring-svg/IR 及其 source-ref/hash 清单。Authored 模式只在精确命中已注册 preset 时使用项目规范 SVG 与紧凑 authored-preset 组。Mirror 从 IR 物化最终模板 SVG,仅对未变更的 Slide-local/slot 引用复用转换器支持的 payload;固定 Master/Layout 层保持直接原子,不支持或被编辑的对象保留当前 SVG 回退,最终模板中不出现任何 IR-only 引用。

对 PPTX 支撑的 Type A mirror,最后一步就是一条确定性命令(脚本 mirror_template_materialize.py 已确认存在于仓库):

python3 skills/ppt-master/scripts/mirror_template_materialize.py \ "<import_workspace>" "<empty_template_workspace>"

它会先校验 IR 清单、不可变的源哈希、完整原生图、可见性事实与导入矢量闭包,然后原子地发布按源顺序排列的 SVG 清单及其icons/imported//images/资产。它从不要求或使用可选的svg-flat/校验树作为模板源,也从不生成design_spec.md——那份 brief 由设计师对着已发布的清单亲自撰写。

Mirror 图边界:mirror 保留完整的受支持源 Master/Layout 图。它按源 slide 每张产出一个完整原型,并为这些 slide 未使用的每个源 Layout 产出一个仅定义的layout_<layout_key>.svg原型——后者通过独立的 Layout 清单在 PowerPoint 中注册,但不会成为已发布的页面,其父 Master 也随之保留。预检只在缺少必需的源事实或受支持的几何时停下,绝不会仅因某个 Layout 未被使用而停下。

mirror 创作的工作区如何被消费:源到工作区的replication_mode: mirror是一种能力,不是项目选择。Strategist 检查实际原型、当前内容与任何显式指令后,决定选择/重复/跳过/重排哪些页面,以及字面、结构或仅视觉复用哪种合适。字面复用复制完整原型、只编辑允许的可见文本值,同时保留装饰、sprite 裁剪、几何与归一化结构声明——这从不要求沿用源页面数量或顺序。

3.5 Step 4:校验、审查导出、注册与发现

生成后,两个范围都以svg_quality_checker.py作为硬关口:Brand 校验其仅身份 spec,Style 校验其仅方法/方向 spec,Layout/Deck 校验 SVG 清单与结构化契约。Brand/Style 从不创建预览 PPTX;Layout/Deck 可按请求创建exports/<id>_template_preview.pptx,多 Master 时必须创建。Authored 模板使用简洁的 preview-only placeholder 样例,让长规范标记保持可读而不改动源 SVG。唯一的范围相关动作是库注册:

范围工作区根预览发现行为
library(默认)skills/ppt-master/templates/<kind>/<id>/Create Brand/Create Style:不适用;Create Layout/Create Deck:单 Master 可选、多 Master 必须校验后注册进对应的brands_index.jsonstyles_index.jsonlayouts_index.jsondecks_index.json
projectprojects/<name>/相同的类型相关审查行为跳过全局索引注册

库注册使模板在 Default Stage-1 模板控件中可选、在聊天中可发现(两者读同一索引)。项目范围或精确交接则提供工作区根,例如use this template: projects/<name>/:这初始化模板模式,恰好一个提供根路径被预选,多个保持未选候选,未注册根路径保持explicit标签。项目工作区也可迁移或异地复用,因为核心形状完全相同;只有当它进入库且应出现在库目录中时才执行注册。

当 Deck/Layout 模板被选中时,Strategist 自动撰写页面/原型方案:可以使用整个清单或子集、重复或重排原型、按需重组内容。strict/adaptive保持为内部导出器取值,不作为确认选项出现。

3.6 验证 Master/Layout 是否真的生效

对使用了 Layout 或 Deck 工作区的生成 deck,请在 Microsoft PowerPoint 中验证发布产物:

检查期望结果
View → Slide Master声明的 Master 与具名 Layout 均存在
Home → New Slide可复用 Layout 名出现在目标 Master 下的 layout 选择器中
选中一页生成 slide 查看Layout该页绑定到其声明的 Layout,而不是泛化的推断 layout
点击一个可复用内容区域模板 slot 表现为带声明类型与框体的原生 placeholder
从任一输出 Layout 新增一页Master/Layout 视觉与 placeholder 几何直接出现,无需复制成品内容页

Brand/Style 的用法刻意不同:两者都保持内容 Slide-local,不要期望存在可复用的模板 Layout 清单(干净的包脚手架除外)。exports/<id>_template_preview.pptx是 Create Template 按请求或必须时创建的审查证据,不是模板输入——生成永远消费工作区根。

Microsoft PowerPoint 是 Master/Layout 行为的验收目标。Keynote、WPS 与 LibreOffice 能打开 PPTX,但可能归一化模板结构,或更慢地加载大型 mirror 清单中未使用的 Layout。

3.7 派生出的模板工作区长什么样

library 与 project 范围共用同一核心结构,把skills/ppt-master/templates/<kind>/<id>/projects/<name>/任一替换<template_workspace>

<template_workspace>/ ├── templates/ │ ├── design_spec.md │ ├── 01_cover.svg │ ├── 02_toc.svg # 可选;没有它则是 02_chapter, 03_content, 04_ending │ ├── 03_chapter.svg │ ├── 04_content.svg # 多变体时用 04a/04b 兄弟文件 │ └── 05_ending.svg ├── images/ # 可选 │ └── *.png / *.jpg # SVG 引用使用 ../images/<name> ├── icons/ # 可选 │ └── imported/ │ └── *.svg # 导入矢量的唯一规范副本 └── exports/ # 可选;按需审查输出 └── <id>_template_preview.pptx

Brand 与 Style 止步于templates/design_spec.md(加真实存在的 Brand 资产);它们不创建上面展示的 SVG 或exports/行。

standardfidelity的 SVG 使用统一的创作 placeholder 词汇({{TITLE}}{{CHAPTER_TITLE}}{{PAGE_TITLE}}{{CONTENT_AREA}}等)。每个原生 slot 是带语义类型与正数边界的顶层<g>;普通 slot 恰好含一个载体;固定 Master/Layout 视觉是根上直接原子,从不包裹<g>层。Layout 也可以有意暴露零个 slot。mirror工作区用同一棵树,但templates/下放源顺序的001_cover.svg002_toc.svg、… 文件,可保留字面示例文本而非{{...}}标记,而导入的原生 slot 仍携带语义元数据。

导入矢量 placeholder 使用data-icon="imported/<name>";校验、预览导出与最终导出都解析同一工作区根资产icons/imported/<name>.svg——第二份templates/icons/副本既不需要也不允许。

对照仓库真实样例可以确认上述结构:presentation_core 的 design_spec.md 展示了完整 Layout frontmatter(canvas_format: ppt169canvas_viewbox: "0 0 1280 720"replication_mode: fidelity、20 个页面类型)以及placeholders映射——每个 Layout key 对应其{{...}}slot 列表;中国电信 deck 的 design_spec.md 则展示了 Deck 的Template Overview应用场景表、颜色/字体身份段与双 Master 家族说明;anthropic brand spec 是“Identity-only preset, no SVG page roster”的实证;consulting-decision style spec 展示了沟通方法、论证流与页面消息纪律等纯方法段落。

3.8 库注册 vs 项目放置

  • Library 范围(默认)把工作区写入skills/ppt-master/templates/<kind>/<id>/并做全局注册。
  • Project 范围把同一可移植工作区写入projects/<name>/并跳过注册。

不是一个私有或缩水的项目专用格式:提供精确工作区根会把它加入 Step-3 候选输入、把 Stage 1 默认切到模板模式,并且仅当它是唯一提供根路径时预选。Brand/Layout/Deck 迁移时携带templates/加任何真实存在的包内images/icons/;Style 只迁移templates/design_spec.md,无关项目脚手架被忽略。工作区若移入库中,执行其类型相关的注册,让发现反映新位置。

4. 模板边界:五条必须避免的误解

  • 可复用模板是一个显式工作区,不是打包的源 PPTX。Brand 与 Style 工作区无页面清单;Layout 与 Deck 工作区额外携带结构化 SVG 契约。Authored 模式创建该契约,mirror 把经过校验的源所有权事实映射进契约。导出只编译已声明的结构。
  • 模板不是一个无差别的“风格皮肤”。Brand、Style、Layout、Deck 刻意分离身份、方向/方法、结构与四种 segment,使每段都能按显式所有权规则复用或组合。
  • 模板不替你替内容做决定。Strategist 仍逐页决定使用哪个 layout、是否扩展变体。模板提供候选,不是预定结果。
  • fidelity模式不是像素级复制。即使literal保真度,AI 仍会剥离噪声与不必要的重复——几何保留,冗余消失。
  • mirror的目标是字面受支持的外观与源拓扑,而非字节一致的 OOXML。它继承源导入的限制,只允许固定层组展开等机械归一化;不支持的原生对象保留可用 SVG 回退或被报告,mirror 从不合成替代所有权。

5. 延伸阅读

  • workflows/create-template.md — 完整工作流规格(面向 AI)
  • workflows/generate-pptx.md — Default Generate 流程及其 Step-3 模板候选准备
  • skills/ppt-master/templates/README.md — 四类模板与发现索引的总览
  • references/template-designer.md — Template_Designer 角色定义与 SVG 技术约束
  • templates-architecture.md — 架构对齐文档:四类数据模型、design_spec.md字段集、多路径安装与 segment 所有权规则
  • FAQ — 如何创建自定义模板的简短问答
  • 中文对照:docs/zh/templates-guide.md

【免费下载链接】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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询