ppt-master Presentation Core 布局规格深度解析20 套结构型 PowerPoint 版式的设计契约、槽位系统与结构化导出【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-masterPresentation Core 是 ppt-master 仓库内置的通用型 16:9 结构布局Layout体系以一份 design_spec.md 规格文件为契约配套 20 张完整 Slide 原型 SVG。本文以该规格文档为主体骨架结合仓库内的 SVG 实现、元数据接口与工作流文档逐字段拆解这份设计规格它定义了哪些版式、如何用占位符与槽位描述内容、chart/table 槽位如何保留SVG 兜底 原生替换的双轨能力以及该布局如何被选中、校验并编译为真正的 PowerPoint Master/Layout 结构。读完本文你将掌握一份 ppt-master Layout 规格的完整读法并能在自己的模板工作区复刻这套结构优先、外观后置的版式设计方法。一、布局Layout在 ppt-master 模板体系中的位置在 ppt-master 的模板分层中Layout 是纯结构的模板品种。根据 layouts/README.md 的定义Layout a structure-only reusable template bundlecanvas、Master/Layout 结构、页面类型、槽位几何、语义文本角色、对齐/换行/容量行为、以及 SVG 花名册roster——不携带品牌色、字体/字重身份、最终字号刻度、Logo、语气或图标风格。这意味着 Presentation Core 的 20 套版式只回答页面长什么样、哪里能放什么类型的内容而用什么颜色、什么字体、什么品牌元素全部留给下游的 Brand/Deck 皮肤或确认阶段决定。规格文件 design_spec.md 的 frontmatter 明确声明了这一点layout_id: presentation_core kind: layout category: general summary: A structure-only 16:9 system with 20 authored PowerPoint Layouts for general, editorial, image, process, and data presentations. keywords: [general, powerpoint, business, editorial, image,>svg xmlnshttp://www.w3.org/2000/svg width1280 height720 viewBox0 0 1280 720 >placeholders: 01_title_slide: [{{TITLE}}, {{SUBTITLE}}] 02_title_content: [{{PAGE_TITLE}}, {{CONTENT_AREA}}] 03_section_header: [{{CHAPTER_TITLE}}, {{CHAPTER_DESC}}] 04_two_content: [{{PAGE_TITLE}}, {{LEFT_CONTENT}}, {{RIGHT_CONTENT}}] 05_comparison: [{{PAGE_TITLE}}, {{LEFT_TITLE}}, {{LEFT_CONTENT}}, {{RIGHT_TITLE}}, {{RIGHT_CONTENT}}] 06_title_only: [{{PAGE_TITLE}}] 07_blank: [] 08_content_caption: [{{PAGE_TITLE}}, {{CONTENT_AREA}}, {{CAPTION}}] 09_picture_caption: [{{PAGE_TITLE}}, {{CAPTION}}] 10_hero_statement: [{{KEY_MESSAGE}}, {{SUBTITLE}}] 11_editorial_split: [{{PAGE_TITLE}}, {{BODY_TEXT}}] 12_three_card: [{{PAGE_TITLE}}, {{CARD_1}}, {{CARD_2}}, {{CARD_3}}] 13_kpi_dashboard: [{{PAGE_TITLE}}, {{KPI_1}}, {{KPI_2}}, {{KPI_3}}, {{KPI_4}}, {{CONTENT_AREA}}] 14_process_timeline: [{{PAGE_TITLE}}, {{STEP_1}}, {{STEP_2}}, {{STEP_3}}, {{STEP_4}}, {{KEY_MESSAGE}}] 15_data_story: [{{PAGE_TITLE}}, {{CONTENT_AREA}}, {{KEY_MESSAGE}}, {{SOURCE}}] 16_title_picture: [{{PAGE_TITLE}}] 17_two_picture_caption: [{{PAGE_TITLE}}, {{LEFT_CAPTION}}, {{RIGHT_CAPTION}}] 18_screenshot_focus: [{{PAGE_TITLE}}, {{ANNOTATION}}, {{SOURCE}}] 19_chart_insight: [{{PAGE_TITLE}}, {{KEY_MESSAGE}}, {{SOURCE}}] 20_table_summary: [{{PAGE_TITLE}}, {{KEY_MESSAGE}}, {{SOURCE}}]这套词表与 template-designer.md §4 的规范占位符约定一致{{TITLE}}/{{SUBTITLE}}/{{DATE}}/{{AUTHOR}}用于封面{{CHAPTER_TITLE}}/{{CHAPTER_DESC}}用于章节{{PAGE_TITLE}}/{{CONTENT_AREA}}/{{PAGE_NUM}}用于内容页{{KEY_MESSAGE}}是咨询型内容页的要点角色{{SOURCE}}是页脚数据来源。值得注意07_blank的映射是空数组[]——它显式断言零占位符页面这是有意设计的零槽位构图面规格 pptx-structure-interface.md §1 明确允许零槽位 零固定原子的布局05_comparison是槽位最多的布局之一左右各一套标题 正文对应成对标题 成对对比正文{{KPI_1}}~{{KPI_4}}与{{STEP_1}}~{{STEP_4}}使用带序号的下划线 token属于布局自己的扩展命名规范约定允许在风格确需时替换/扩展如{{KEY_MESSAGE}}。placeholders:映射还有工程用途当某页缺少其惯用占位符时svg_quality_checker.py 的--template-mode会告警显式的[]断言可静默该告警并记录契约。六、图片系统与数据系统带类型槽位的双轨设计规格的核心设计之一是带类型的槽位typed slotspicture、chart、table槽位承诺的只是这里可以放什么类型的内容而非这里已经放好了图片或原生对象。这一边界在 layouts/README.md 中写得很清楚一个带类型的picture/chart/table槽位不承诺已插入图片或原生对象——生成的 Slide 提供内容原生替换始终是显式的导出选择。6.1 picture 槽位单图、双图、带说明、截图以 09_picture_caption.svg 为例图片槽位是g idpicture-caption-picture-slot>g idchart-insight-chart-slot>python3 skills/ppt-master/scripts/apply_template.py project_path --root skills/ppt-master/templates/layouts/presentation_core安装后project_path/templates/成为唯一的消费边界规格以design_spec.layout.presentation_core.md形式落位 3.规划strategist-template.md 读取安装后的规格与每张完整 Slide 原型决定template_reuse_scope: layout、template_adherence: strict|adaptive写出应用计划与结构化锁行 4.锁定spec_lock.md的pptx_structure声明mode: structured登记唯一的pptx_masters/pptx_layouts花名册、每页的page_pptx_layouts分配与page_layouts原型来源 5.执行executor-structured.md 按每页page_layouts行解析对应原型 SVG如P13: 13_kpi_dashboard在槽位内填入当前项目内容、按锁定排版重新排布文本并把 Master/Layout 键写到输出页根节点导出器只编译这些已声明的结构绝不推断或补造结构 6.导出Master/Layout 定义编译为 PowerPoint 原生的 Master、Layout 与占位符对象chart/table槽位在请求原生导出时物化对应--native-charts-and-tables。关键约束值得强调复用某个 Layout 键的前提是固定原子与槽位 id/类型/有效索引/默认边界/绑定模式完全一致仅仅措辞、数据、图片或 Slide 本地几何不同绝不产生新 Layout需要改变原子或槽位契约时必须回退到 Strategist 声明新键Executor 从不直接变更契约见 executor-structured.md §1.2 与 pptx-structure-interface.md §1。九、验证与质量保障布局工作区在库范围library scope落地前后需要经过多道验证layouts/README.md 与 create-layout.md 给出了明确命令# 结构校验模板模式 规范创作检查 python3 skills/ppt-master/scripts/svg_quality_checker.py workspace_root/templates --template-mode --canonical-authoring # 预览 PPTX请求时或含多 Master 时必做 python3 skills/ppt-master/scripts/template_preview_pptx.py template_workspace # 库范围注册project 范围跳过 python3 skills/ppt-master/scripts/register_template.py presentation_core --kind layout --dry-run python3 skills/ppt-master/scripts/register_template.py presentation_core --kind layout校验覆盖依据 shared-standards-core.md 与 svg_quality_checker.py每个 SVG 根节点携带四个根身份属性master/layout 键与显示名Master/Layout 原子与槽位是根的直接子元素data-pptx-bounds为正值设计区最多两位小数占位符词表与 SVG 一致SVG 符合 fail-closed 的生成式创作闭包禁止 mask、style、class、动画、脚本等。--template-mode还会在页面缺少惯用占位符时告警--canonical-authoring则报告与紧凑创作形态的偏离仅为建议性告警不阻断导出。十、边界与最佳实践最后把这份规格放在模板体系的边界里总结几条实践准则Layout 不携带身份也不携带叙事。规格正文刻意从## IV开始没有 I–III 的 Overview/Color/Typography且不写 Template Overview、应用契约与身份段——颜色、字体、Logo、语气、图标处理都是下游决策category: scenario也只记录几何适配不授权任何场景内容策略create-layout.md §4。中性涂装不是身份。原型中的#F4F6F8面板、#D6DCE3发丝线、#CBD5E1强调色、Arial 字体只是揭示预期区域的预览值实际页面由 Brand/Deck 皮肤与确认阶段接管。typed slot 的承诺边界。picture/chart/table槽位承诺的是内容类型与几何区域不承诺已放置的图片或原生对象chart/table 的原生物化是显式导出选择且必须走--native-charts-and-tables路径。结构优先、克制复用。复用 Layout 键必须满足原子与槽位契约完全一致要改变契约就声明新键并回退到 Strategist 更新锁定绝不就地改键。花名册是双向契约。templates/*.svg与规格的 Page Roster、frontmatter 的page_count/page_types/placeholders必须双向一致这是校验器与注册流程共同执行的硬约束。作为参考仓库同目录还提供 presentation_core_43 布局4:3 投影/教室场景、report_core多 Master 报告版等结构型布局把 Presentation Core 的结构与 styles/ 中的视觉方向组合即可得到结构 外观完整的工作区。阅读 design_spec.md 本身就是理解 ppt-master 如何用一份 Markdown 规格驱动 20 套可复用 PowerPoint 版式的起点。【免费下载链接】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），仅供参考