ppt-master Report Core 布局设计规范深度解读双 Master 报告系统的结构性页面架构【免费下载链接】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 仓库中report_core布局的设计规范design_spec.md为骨架深入剖析这套专为阅读型报告材料设计的 16:9 结构性布局系统。你将理解它如何通过两个 Master、13 个 PowerPoint Layout、持久页面 chrome 与密度阶梯让评审、分析、带证据的汇报文档既具备可引用性、可导航性又保留完全的品牌自由度。文中同时结合仓库内 13 个 SVG 模板的源码细节给出可验证的几何坐标、占位符契约与导出路径说明。Report Core 是什么一套结构性词汇表而非视觉主题Report Core 是 ppt-master 布局库skills/ppt-master/templates/layouts/中的一类layout模板核心定位是为被阅读的程度与被演示的程度相当的分页式 16:9 材料提供结构词汇表——评审报告、分析文档、携带证据的汇报型 deck这类页面的共同诉求是每一页都可以被引用、可以被导航。它与品牌模板、Deck 的根本区别在layouts/README.md中定义得很明确Layout 纯结构可复用模板包只包含画布、Master/Layout 结构、页面类型、槽位几何、语义文本角色、对齐/换行/容量行为与 SVG 名册不含品牌色、字体字重身份、最终字阶、Logo、语气、图标风格——这些由 Brand/Deck 或确认阶段接管原型中出现的颜色、安全字体、临时字号都是preview values预览值是可替换的演示涂料而非身份或锁定刻度。也就是说Report Core 交付的是一套骨架语法#1E293B、#E2E8F0这些十六进制色值只是为了让层次与槽位几何显形可以被任何下游品牌决策整体替换。在布局索引layouts_index.json中report_core的注册条目为report_core: { summary: A structure-only 16:9 system with 13 authored PowerPoint Layouts across two Masters, carrying persistent page chrome and page-number placeholders., canvas_format: ppt169, page_count: 13, page_types: [ cover, section_divider, agenda, title_content, two_content, three_block, kpi_row, chart_insight, table_summary, process_timeline, matrix_2x2, appendix, closing ] }Frontmatter 元数据契约design_spec.md 的结构化信息头按照layouts/README.md的 design_spec.md 契约布局规范文件顶部是一段可移植的结构化元数据Report Core 的完整 frontmatter 如下--- layout_id: report_core kind: layout category: general summary: A structure-only 16:9 system with 13 authored PowerPoint Layouts across two Masters, carrying persistent page chrome and page-number placeholders. keywords: [report, business, dense, chrome, multi-master] canvas_format: ppt169 canvas_width: 1280 canvas_height: 720 canvas_viewbox: 0 0 1280 720 replication_mode: standard native_structure_mode: structured page_count: 13 page_types: - cover - section_divider - agenda - title_content - two_content - three_block - kpi_row - chart_insight - table_summary - process_timeline - matrix_2x2 - appendix - closing ---各字段在仓库契约中的含义字段值含义layout_idreport_core布局唯一标识用于索引与注册kindlayout模板类别为纯结构布局非 Brand 或 Deckcategorygeneral通用类别区别于 scenario / government / specialsummary一行结构用例承担选择上下文selection context供 Strategist 或检索层消费canvas_formatppt16916:9 PPT 画布见 canvas-formats.mdcanvas_width/height/viewbox1280x720/0 0 1280 720全系统统一坐标空间所有 SVG 与 PowerPoint 页共享同一数值画布replication_modestandard记录工作区的生产方式AI 派生新系统非 mirror 镜像native_structure_modestructuredPPTX 输出为结构化工作区计划决定页面编译结构或仅作视觉参考page_count/page_types13 / 13 种页面名册的注册事实placeholders13 页槽位映射每页的规范占位符名列表见下节关于画布ppt169在 canvas-formats.md 中定义为精确的1280x720viewBox0 0 1280 720同一画布体系内所有页面与 Layout 原型共享相同数值画布规范正文还定义了该画布在text阅读模式下的正文字号锚点为 20 px、建议带 18–21 px——这与 Report Core 密度阶梯的起点20 px完全吻合说明 Report Core 的正文基线直接沿用了平台的画布排版规范。占位符体系13 页的规范槽位映射frontmatter 中的placeholders映射是本布局最重要的可移植结构契约之一它声明了每一页的规范占位符名即下文 SVG 中的{{PLACEHOLDER}}变量与data-pptx-placeholder类型页面占位符01_cover{{TITLE}}、{{SUBTITLE}}、{{DATE}}02_section_divider{{CHAPTER_NUM}}、{{CHAPTER_TITLE}}、{{CHAPTER_DESC}}03_agenda{{PAGE_TITLE}}、{{ITEM_1}}~{{ITEM_5}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}04_title_content{{PAGE_TITLE}}、{{CONTENT_AREA}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}05_two_content{{PAGE_TITLE}}、{{LEFT_CONTENT}}、{{RIGHT_CONTENT}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}06_three_block{{PAGE_TITLE}}、{{BLOCK_1}}~{{BLOCK_3}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}07_kpi_row{{PAGE_TITLE}}、{{KPI_1}}~{{KPI_4}}、{{CONTENT_AREA}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}08_chart_insight{{PAGE_TITLE}}、{{KEY_MESSAGE}}、{{SOURCE}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}09_table_summary{{PAGE_TITLE}}、{{KEY_MESSAGE}}、{{SOURCE}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}10_process_timeline{{PAGE_TITLE}}、{{STEP_1}}~{{STEP_4}}、{{KEY_MESSAGE}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}11_matrix_2x2{{PAGE_TITLE}}、{{Y_AXIS}}、{{X_AXIS}}、{{QUADRANT_1}}~{{QUADRANT_4}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}12_appendix{{PAGE_TITLE}}、{{LEFT_CONTENT}}、{{RIGHT_CONTENT}}、{{FOOTER_NOTE}}、{{PAGE_NUM}}13_closing{{CLOSING_MESSAGE}}、{{CONTACT_LINE}}注意几个结构性规律所有内容页都带有{{FOOTER_NOTE}}与{{PAGE_NUM}}而 divider 页面封面、章节页、封底不带页脚与页码——这与持久 chrome 只属于内容 Master的签名设计一一对应chart_insight/table_summary通过{{KEY_MESSAGE}}解读结论{{SOURCE}}来源轨双槽位强化证据可溯源的阅读体验。占位符命名遵循仓库规范见template-designer.md的 canonical{{PLACEHOLDER}}约定本布局通过placeholders:映射声明覆盖。签名设计元素八大结构性决策design_spec.md第 IV 节定义了 Report Core 区别于其他布局的八大签名设计元素。以下结合 SVG 源码逐一展开。1. 双 Master、双背景平面Report Core 拥有两个 PowerPoint Master承载两个相互独立的背景平面report_core_content_master承载浅色阅读平面 持久 chrome供 10 个内容页使用report_core_divider_master承载反转平面深色且无 chrome仅供cover、section_divider、closing使用。从源码可验证01_cover.svg声明data-pptx-masterreport_core_divider_master背景为深色#1E293B而03_agenda.svg、04_title_content.svg等均声明data-pptx-masterreport_core_content_master背景为白色#FFFFFF。可复用的结构事实是名册拥有两个独立背景平面与两个 Theme part——具体原型色值仍是可替换的预览涂料。2. 持久页面 chromepersistent page chrome内容 Master 拥有两条静态原子线逐页复现页眉细线y64从x148到x21232页脚细线y664同样横跨x148到x21232。两层均标记data-pptx-layermaster与data-pptx-editablefalse确保它们是不可编辑的母版静态元素。分节divider页两者皆无——因此一个章节中断读起来是真正的打断而不是重新美化的内容页。这让章节边界在视觉上构成强制停顿强化报告的章节结构。3. 页码是结构性的这是 Report Core 与画文字页码模板的本质区别页码由真正的槽位slot驱动。每个内容 Layout 都声明slide-number槽位bounds1112 676 120 32footer槽位bounds48 676 900 32cover额外声明date槽位48 600 400 32。以03_agenda.svg为例页脚槽为data-pptx-placeholderfooter48 676 900 32页码槽为data-pptx-placeholderslide-number1112 676 120 32页码文本text-anchorend对齐到x1232、字号 12。这些槽位与 PowerPoint 的 Layout 页眉/页脚标志header/footer flags匹配使编译后的包携带真实页码能力而不是画上去的文本——在 PowerPoint 中编辑时页码会随分页实时更新。4. 收紧的框架tightened frame相比宽松的一般系统64 px 边距、36 px 标题Report Core 采用更紧凑的阅读型度量度量Report Core宽松系统对比页面边距48 px64 px标题带48 88 1184 5628 px36 px内容场每个内容页y176至y640—即标题带宽度 1184 px 高 56 px正文区域从 y176 一直延伸到 y640高 464 px上下各被 chrome 细线64 / 664与页脚676夹住。以04_title_content.svg验证标题槽48 88 1184 5628 px bold正文槽48 176 1184 46420 px。这套收紧的度量让单位面积承载更多信息适配报告材料的阅读密度。5. 规则先于容器rules before containers分组优先用细线hairline承载而非填充面板——这是报告排版的关键美学与信息层级决策agenda五条规则分隔五行议程项并配 Layout 自有的01–05序号索引源码见 03_agenda.svg 中agenda-rule-one~five与agenda-index-one~fiveappendix完全没有面板只用一条中轴列规则x640y 176–640分隔左右两栏填充面板只出现在真正需要独立材质平面的区域如 KPI 卡片、图表容器。这一原则保证视觉噪声最小、信息分区由空白与细线自然完成适合密集参考页。6. 密度阶梯density ladder一套系统同时容纳综合页与参考文献页而不改变框架靠的是明确的正文字号阶梯层级字号使用场景单区域页20 pxtitle_content等全宽正文区分栏面板19 pxtwo_content、three_block等分栏步骤/证据区域18 pxprocess_timeline步骤、KPI 证据区、矩阵象限附录15 pxappendix密集参考两栏chrome 文本12 px页脚、页码源码佐证title_content正文槽 20 px04_title_content.svgkpi_row证据区 18 px、matrix_2x2象限 18 px11_matrix_2x2.svgappendix两栏 15 px12_appendix.svg所有页脚/页码 12 px。20 px 起点与 canvas-formats.md 中ppt169的 text 阅读模式初始正文20 px一致。7. 分析型页面类型Report Core 原生内置四类分析型页面其几何专门为数据论证设计kpi_row四个指标横跨全宽 1184 px 场源码 07_kpi_row.svg 中四张卡片分别为 x48/350/652/954、宽 278 px间距 24 px下方接一个全宽证据面板48 320 1184 3208 px 圆角。规范明确强调这种画布宽度足以支撑四指标并行而不压缩matrix_2x2四个象限槽各 392×224 两个轴标签槽Y 轴左侧48 176 144 56、X 轴右下1016 584 216 56右端对齐用于论点定位positioning argumentschart_insight/table_summary声明类型化的chart/table槽其作者绘制的组authored groups保持为完整 SVG 回退fallback只有在导出路径被请求时可选替换元数据才能物化为 PowerPoint 原生数据对象见下节。8. 文本入口与对齐纪律通用正文与对象槽一律从左上角开始居中仅保留给 KPI 数值、短流程节点与时间线要点takeaway。从源码可见KPI 值text-anchormiddle且 24 px bold07_kpi_row.svg其余正文标题、正文、附录、页脚全部左上对齐。这条纪律保证了数据数值在视觉上顶格突出而叙述文本保持报告式的左对齐阅读节奏。页面名册13 个 PowerPoint Layout 逐一解析design_spec.md第 V 节给出完整名册下表为原始映射SVG → Master → Layout key → PowerPoint 选择器名 → 用途SVGMasterLayout keyPowerPoint picker 名用途01_cover.svgDividercoverCover反转平面上放置标题、副标题与日期槽02_section_divider.svgDividersection_dividerSection Divider章号、章标题、章描述位于一条规则之上03_agenda.svgContentagendaAgenda五条规则分隔的行 Layout 自有序号索引04_title_content.svgContenttitle_contentTitle and Content页标题覆盖一个全宽内容区05_two_content.svgContenttwo_contentTwo Content等宽左右内容面板06_three_block.svgContentthree_blockThree Block三个并行内容面板07_kpi_row.svgContentkpi_rowKPI Row全宽场上四个指标 一个证据区域08_chart_insight.svgContentchart_insightChart and Insight带 SVG 回退的图表槽、解读与来源轨09_table_summary.svgContenttable_summaryTable and Summary带 SVG 回退的表槽、总结与来源轨10_process_timeline.svgContentprocess_timelineProcess Timeline共享轴线上的四个有序步骤 要点轨11_matrix_2x2.svgContentmatrix_2x2Two-by-Two Matrix四个象限槽 两个轴标签槽12_appendix.svgContentappendixAppendix无容器的密集双栏参考页13_closing.svgDividerclosingClosing反转平面上的结语与联系方式行PowerPoint picker 名是用户在实际 PowerPoint 应用中选择版式时看到的名称data-pptx-layout/data-pptx-layout-name属性分别承载机器键与人类可读名。类型化槽位与原生数据物化的边界Report Core 在chart_insight/table_summary上体现了布局层对数据原生性的明确承诺边界。以 08_chart_insight.svg 为例图表槽bounds68 196 760 424内嵌g idchart-insight-chart-slot contenteditable="false">【免费下载链接】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），仅供参考