PPT Master 实例精读一份 Brutalist 报纸风 design_spec.md 如何驱动 10 页原生 PPT 的生成【免费下载链接】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 的默认生成管线中design_spec.mdDesign Specification Content Outline是 AI 在动手写每一页 SVG 之前的“总装配图”它把项目元信息、画布规格、配色、字体体系、图表选型、图片清单、逐页内容大纲和技术约束一次性锁定成一份可被解析器校验的结构化文档。本文基于仓库中收录的examples/ppt169_brutalist_ai_newspaper_2026案例提交0608a870“feat(examples): ship Brutalist AI Newspaper 2026 capability-showcase deck” 引入作为路线图 P0-2 的能力展示样片完整拆解这份约 300 行的设计规格是如何为 10 页“AI 行业 2026 年报”确定 Brutalist 报纸视觉、8 类图表、5 张 AI 生图以及一套严格的 SVG 兼容规则的——读完后你可以理解 PPT Master 从“主题”到“可编辑 PPTX”之间的关键中间产物长什么样并学会按同样的骨架为自己的项目编写 design_spec。1. design_spec.md 是什么一份可被机器解析的设计契约PPT Master 的项目工作区目录约定中见 projects/README.md每个项目通常包含project_name[_registered_format]_YYYYMMDD/ ├── design_spec.md # 设计规格 内容大纲本文主角 ├── sources/ # 原始资料文档 / URL 归档 / 转换后的 Markdown ├── notes/ # 逐页讲稿 ├── svg_output/ # 生成的 SVG 页 ├── svg_final/ # 后处理后的自包含预览 └── exports/ # 最终原生 DrawingML PPTXdesign_spec 不是给人看的普通说明文档。仓库中的 JSON Schema design_spec.schema.json 定义了对它的解析契约解析器为heading-sections-v1以罗马数字编号的 H2 标题切分章节section_order固定为 10 个章节project_information→canvas_specification→visual_theme→typography_system→layout_principles→icon_usage→visualization_reference可选→image_resource_list→content_outline→speaker_notes其中 9 个章节为必填仅visualization_reference可选每节正文至少 1 字符标题正则极其严格例如 Speaker Notes 章节必须精确匹配^X\. Speaker Notes (?:Requirements|Plan|Strategy)$还带有条件约束conditions当image_resource_list表格中出现通过ai方式获取的行时会额外要求ai-image-strategy相关子标题必须存在。这个 Schema 解释了为什么案例文档的章节编号、标题措辞一个字母都不差——写错标题解析器就认为该章节缺失。换言之design_spec 是“写给 Strategist/Executor 管线读的 Markdown 配置”人类可读性与机器可校验性同时成立。2. 项目信息I与画布规格II先钉死坐标案例文档的前两节把最基础的事实锁死项值项目名ppt169_ai_industry_2026画布格式PPT 16:91280×720页数10设计风格B) General Consulting Brutalist editorial newspaper目标受众AI 行业从业者 / 投资人 / 研究者用途年报式行业回顾——论坛 / brown-bag / 投资者季报开场画布一节给出的是精确像素账本属性值尺寸1280×720viewBox0 0 1280 720页边距左右 48px、上下 40px报章式窄边距内容区1184×640这里有两个值得注意的工程细节。第一项目目录名中的ppt169前缀对应project_manager.py init --format ppt169登记的画布格式而文档中给出的 48/40 边距是项目级决定——报纸风的“窄边距”风格直接写进了规格后续所有页面都必须遵守。第二viewBox 与svg_output/中每页 SVG 的viewBox严格一致这是后续 SVG→PPTX 转换器按 1280×720 画布建立 EMU 坐标映射的前提这也是文档第十一节把 “viewBox:0 0 1280 720” 再次列为技术约束的原因——画布规格在文档里出现了两次分别服务于人设计决策和机器一致性校验。3. 视觉主题III近单色报纸配色 editorial/mono-ink 图像策略视觉主题一节是本案例“Brutalist”味道的核心它完整给出了一张角色化色板角色HEX用途Background#FFFFFF主背景纸白Secondary bg#F4F1EA边栏 / pull-quote 纸黄Primary#111111主形状 / rule line / 主文字Accent#C8102E红色强调——masthead 一条红线、关键数据点、The Number锚点全文占比 5%Secondary accent#3A3A3A次文字 / annotation / footerBody / Secondary / Tertiary text#111111/#3A3A3A/#6B6B6B三级文字梯度Border/divider#000000报章框线、栏分隔、cell borderSuccess / Warning#1A6E3A/#A02014正负数据点极少用这张色板与仓库内置的 Brutalist 视觉风格参考 visual-styles/brutalist.md 的规范严格对齐该风格要求“近单色——墨黑结构 纸白底用一个局部 spot accent 作标点masthead 红线、关键数字、印章”、“颜色是标点而非填充accent 靠稀缺性赢得注意力”。design_spec 把它落成了可执行的规则红色#C8102E全文出现占比必须小于 5%只允许出现在 masthead 红线、关键数据点和 The Number 锚点上。同一节还定义了 AI 图像策略两行配置Image Rendering: editorialImage Palette: mono-ink这两个取值都不是自由发挥的——前者必须来自 image-renderings/_index.md 登记的 20 种渲染风格含 editorial后者来自 image-palettes/_index.md 登记的 14 种色板含 mono-ink。brutalist 风格参考中列出的配对渲染是screen-print或editorial——“halftone 单色图像嵌在新闻纸美学里”本案例选了 editorial并附加了自定义描述halftone 颗粒、纸纹质感、黑墨平涂且允许在墨黑主体之外让单点红#C8102E出现一次红印章 / 红圈 / 红 underline。这个“策略 自定义描述”的组合正是后面图像清单里每条 AI 生图 prompt 的统一前缀风格。4. 字体体系IVdisplay 黑体 × serif 衬线 × monospace 的三族强对比字体一节遵循“角色—中英字体—回退尾部”的表格范式角色中文字体西文字体回退尾部Titlemasthead / 头条SimHeiImpact, Arial Blacksans-serifSubtitle / Section labelSimHeiArial Blacksans-serifBody报章 columnSimSunTimes New RomanserifEmphasisSimSunGeorgiaserifCode / 数据—Consolas, Courier Newmonospace并给出每个角色的完整 font stack例如 Title 为Impact, Arial Black, SimHei, sans-serif、Body 为Times New Roman, SimSun, serif。这套选择对应 brutalist 风格参考中的字体性格要求“poster-black 重显示黑体做头条 × 衬线体做栏文 × monospace 做数据三者碰撞出这个风格需要的张力”。字号体系则用一张“基线 倍数”表钉死基线Body 14px——比常规 dense 排版的 18px 更密是 Brutalist 报章的典型阅读节奏层级表相对 body 的倍数封面 masthead 5–6×72–90pxBlack 字重Section opener / 头条 3–4×42–56px页标题 2–2.5×28–36pxBoldHero number报章大数字3.5–5×50–72pxSubtitle 1.4–1.6×20–22pxSemiBoldBody 1×14pxAnnotation 0.75–0.85×11–12px页脚 / 页码 0.6–0.75×9–10px。这种“基线固定 倍数区间”的表达方式是 PPT Master 字体规格的通用写法它不规定每一处必须多大而是给出合法区间让逐页 SVG 在保证层级对比的前提下有排版自由度同时又可被校验。5. 布局原则V不规则多栏 rule line 网格拒绝 card布局一节把 Brutalist 报纸的空间语法写得非常具体页面纵向切分Header 区 64px顶部 4px 红线 60px 报章标题栏Content 区 568px报章主体多栏不规则栏宽Footer 区 28pximprint / 页码 / 日期布局模式库本风格的主用形态Asymmetric multi-column2/3/4 栏不等宽——不规则栏宽是核心特征Top-band multi-column——大图压顶 下方多栏Sidebar column——整页左侧或右侧固定边栏放图或 pull-quoteHero number body——单个巨型数字 解释栏Rule-line grid——用粗细 rule line 分割版面不用 box cardCenter-radiating——用于 P06 的 KPI overlay。间距规格元素允许范围本项目取值画布安全边距40–60px左/右 48px上/下 40px内容块间距16–24px20px栏间距rule line gutter14–20px16px非 card 容器的补充规则行高 1.35–1.45× 字号报章紧凑节奏正文栏宽 220–340px3–4 栏典型rule line 线宽四档——0.5px hairline / 1px standard / 2–3px section divider / 4px masthead red bar。注意这些“范围 当前值”的双列结构范围来自通用排版惯例当前值是本项目的锁定选择。design_spec 作为 spec 的语义在这里体现——后续 SVG 阶段若出现 18px 栏间距在范围内但未锁定属于合规若出现 30px越界则是违规。6. 图标策略VI显式地“不用”第 VI 节只有一句话不使用 icon library——“Brutalist 报章靠 typography rule line halftone 图说话icon 反而稀释力度。”这在 PPT Master 里是有工程含义的仓库自带数万枚图标templates/icons/README.md 收录了 tabler、phosphor、simple-icons 等图标库默认流程中 Strategist 会按内容从词汇表里检索图标写入规格。而 design_spec 的 icon_usage 章节一旦写明“不使用”后续图像/图标检索环节就不会为项目产生 icon 条目——在 spec 里显式声明“无”与“忘了写”是完全不同的两件事前者是风格决策后者是遗漏。7. 图表选型VII71 个模板、8 页图表、以及一份“落选记录”这是本案例信息密度最高的部分。文档声明 “Catalog read: 71 templates”——即从图表模板目录的索引charts_index.json中召回全部模板后为 8 个需要可视化的页面各选出一个模板并逐字引用该模板索引里的选型描述Summary-quote, verbatim作为选型依据| 页 | 模板 | 仓库中的模板文件 | 用途 | | -- | ---- | ---- | ---- | | P02 | kpi_cards | KPI 概览卡 | 头版 4 个核心 KPI$2.02T 支出 / 3.8B 用户 / $20.7B Q1 收入 / 1000 政策 | | P03 | horizontal_bar_chart | horizontal_bar_chart.svg | LLM 收入份额 Q1 2026 排名长标签12 项 | | P04 | dumbbell_chart | dumbbell_chart.svg | ARPU 差距5 大 lab 的 MAU vs 月 ARPU 两态 | | P05 | line_chart | line_chart.svg | 训练成本时间轨迹 GPT-4 → Llama 3.1 → Gemini Ultra → 2026 frontier → 2027 projected | | P06 | bar_chart | column_chart.svg | 推理功率对比 W/queryClaude 4 Opus / GPT-4 / Gemini 2.5 / DeepSeek V3 / Llama 3.1 | | P07 | dumbbell_chart | dumbbell_chart.svg | Benchmark 饱和SWE-bench / HLE / PhD-QA / Math 多项 2024→2025 跳变 | | P08 | comparison_table | comparison_matrix.svg | EU / US / China 三套监管在生效日期、罚则、范围、重点上的差异 | | P09 | timeline | timeline.svg | 2025-01 → 2026-04 六个里程碑事件 |每条选型都引用了模板自带的“Pick for … / Skip …”判据。例如 horizontal_bar_chart 的引用是 “Pick for ranking 5-12 items, especially with long labels. Skip if 8 short-label items (use bar_chart)”与 P03 的“12 个厂商、带百分比”的场景精确吻合timeline 的引用 “Pick for 3-8 milestone events on a horizontal time axis (no duration)” 与 P09 的“6 个离散里程碑”吻合。更难得的是Runners-up considered落选清单——文档把 5 个“考虑过但被否决”的候选连同否决理由全部写了下来grouped_bar_chart落选 P04双态 MAU/ARPU 两端相差 4 个数量级dumbbell 拉开尺度更易读grouped bar 在差距悬殊时会失衡vertical_pillars落选 P08监管对照是“多行多列”结构化矩阵pillars 适合 1×N 并列单元process_flow落选 P092025–2026 事件是离散里程碑而非线性流程bullet_chart落选 P02bullet 需要 target actual 双值而本页 4 个 KPI 是无目标值的独立数字area_chart落选 P05训练成本是 model-by-model 的轨迹而非累计量。从源码结构看这套“目录 → 逐字判据 → 选择 落选理由”的模式对应 PPT Master 的图表召回流程scripts 目录下有 chart_recall.py 与 visualization_recall.py以及 docs 中 chart-recall 说明。把落选理由写进 spec 的价值在于执行阶段如果 LLM 想“换一张更顺手的图”spec 里现成的否决依据会直接驳回这种漂移对人类审阅者而言这也是选型质量的自证。8. 图像清单VIIIAI 生图如何被规格化第 VIII 节把 5 张 AI 生成图像写成了一张工程化的资源表每行包含文件名、尺寸、宽高比、用途、布局模式编号、获取方式ai、状态、完整 prompt、text_policy与page_role。摘录如下文件名尺寸用途与布局模式p01_cover_hero.png1280×720封面 hero 主图#1 full-bleed background 浮动标题 #29 two-stop scrimp03_revenue_leader.png480×720收入排行侧边图#18 全高 sidebar 列 #70 细色框p05_training_cost.png1280×320训练成本横幅#14 中部横向 banner #70 细色框p06_inference_thermal.png1280×720推理功率 hero#40 背景图 浮动 KPI 卡 #30 半透明矩形遮罩p08_regulation_table.png1280×280监管对照顶部 banner#5 top-band 图 下方多栏文字几个值得学习的做法1尺寸即布局。每张图的宽高比1.78 / 0.67 / 4.00 / 1.78 / 4.57精确匹配其版面角色——竖图给 sidebar、4:1 横幅给 banner。AI 生图一次生成到目标比例避免生成后再裁切造成的构图损失。2布局模式编号引用。“#1 full-bleed background”“#70 thin colored matte frame”这类编号引用的是 PPT Master 的图像布局模式库image-layout-patterns.md而不是每页现编描述。编号化让“同一布局语言”跨页复用也让校验可以核对编号是否存在。3prompt 与风格策略联动。每条 prompt 都继承第 III 节锁定的 editorial/mono-ink 基因——反复出现 “halftone grain / paper grain / high-contrast” 等词且每条都预留了“calm area reserved for overlay”为标题、KPI 卡等文字层留出不含细节的安静区域。例如封面 prompt“vast information surge depicted as parallel cascading data ribbons descending from the upper darkness into bright reflective floor; silhouette of a lone figure standing at the foot looking up; high-contrast halftone, paper grain… calm right-side area reserved for masthead title overlay”。4条件约束联动。正因为表中存在acquire_via ai的行Schema 里的ai-image-strategy条件被触发要求第 III 节必须携带渲染/色板策略——这解释了为什么 “Image Rendering: editorial / Image Palette: mono-ink” 出现在视觉主题一节而不是图像一节。text_policy列全部为none图内不放文字文字一律由 SVG 原生层承载保证 PPTX 可编辑page_role区分hero_page封面与local内容页局部。9. 内容大纲IX10 页年报的完整脚本第 IX 节把 10 页 Slides 写成“逐页脚本”每页包含 Layout布局描述、Title、可选 Subtitle / Visualization / Data points / Source。整份大纲的叙事结构是一部迷你“报纸”P01 封面Mastheadfull-bleed hero 顶部 4px 红线 右下单元区的大字 masthead标题THE AI INDUSTRY 2026红色 taglineTHE YEAR THE LEAGUE TABLE CHANGED.信息行注明来源Stanford HAI / Counterpoint / OneTrust / Deluair / IEEE Spectrum。P02 Issue at a Glance1×4 KPI 卡kpi_cards 下方三栏 “Three Observations”收入集中度正在脱离用户数排名frontier 训练成本越过 $200M 门槛并在 2027 年底走向 $1–3B同等能力下推理成本每年下降约 10×。P03 Story I: Revenue League Q1 2026左 1/3 sidebar 图 右 2/3 horizontal_bar_chart数据点完整列出 12 家份额Anthropic 31.4% / OpenAI 29.0% / Google 12.1% / Microsoft 7.2% / Tencent 4.8% / Baidu 3.6% / Alibaba 2.9% / Meta 1.4% / Grok 1.4% / Perplexity 1.0% / DeepSeek 0.2% / Zhipu 0.1%红色 pull-quoteFIRST NON-OPENAI LAB IN #1 SINCE THE MODERN LLM ERA BEGAN.附来源行。P04 The ARPU Divide全幅 dumbbellMAU 左点 · ARPU 右点Meta ~1,000M/$0.10、OpenAI 900M/$2.20、Google —/$1.10、Anthropic 134M/$16.20、Microsoft —/$5.00caption 给出倍差结论Anthropic 单用户收入是 OpenAI 的 7.4×、Google 的 14.7×、Meta 的 162×。P05 Frontier Training Cost中段 1280×320 GPU 走廊 banner line_chartGPT-4 $78M → Llama 3.1 $170M → Gemini Ultra $191M → 2026 frontier $200–500M → 2027 projected $1–3B 右侧 annotation1e26 – 1e27 FLOPs并指出约束已从芯片供应转为电力与电网互联。P06 Inference — Watts per Queryfull-bleed 芯片 die 图 4 张浮动 KPI 卡Claude 4 Opus 5 W / DeepSeek V3 23 W / 碳排差距 10× / 推理成本 ~10×/年来源 Stanford HAI AI Index 2026。P07 Capability — Benchmarks Saturateddumbbell 2024→2025SWE-bench Verified ~60%→~100% 人类基线、Humanitys Last Exam 30pp、PhD 级科学问答与多模态推理由低于基线到达到/超过、竞赛数学达到基线editorial 金句THE BENCH-DESIGN COMMUNITY IS NOW PERMANENTLY BEHIND THE MODEL-RELEASE CYCLE.。P08 Three Rulebooks, One Race顶部 banner 图 comparison_table3 列EU / US / China× 5 行Posture / Core instrument / Full force / Max penalty / Frontier focus收尾句Convergence on principle, divergence on implementation.。P09 2025–2026 Timeline6 个里程碑——2025-01 美国 EO 14179 签署2025-08 EU AI Act 全面生效2025-09 中国合成内容规则生效2025-Q4 DeepSeek-R1 发布2026-Q1 Anthropic 在 LLM 收入上超越 OpenAI2026-04 Stanford HAI AI Index 2026 发布SWE-bench Verified 饱和的第一年。P10 What Changed, What Didnt二栏纯文字收束页——左栏红头 “CHANGED” 四条收入领袖≠用户数领袖、训练成本越过半亿美元线、每查询功耗成为 4.6× 判别器、benchmark 半衰期从年降到月右栏黑头 “DID NOT CHANGE” 四条frontier 梯队仍是约 5 家、中国 lab 在 EU 市场收入仍为 $0、开放权重仍未转化为直接收入、电力与电网互联仍是最难投入底部 imprint footer。注意大纲中的数据来源纪律每个关键数字都挂在具名机构下Counterpoint 的支出/份额、OneTrust 的政策数、Stanford HAI 的推理功率。这不是装饰——PPT Master 的 source 归档sources/目录会保存原始资料spec 中“Source: …”行就是归档与数字的追溯锚点也是避免 LLM 在生成阶段“编造数字”的第一道闸门。10. 讲稿要求X与 SVG 同名的 notes 约定第 X 节只有一条硬性规则加风格约定文件命名与 SVG 一一对应01_cover.svg→notes/01_cover.md对应工作区约定的notes/目录总时长 ~12–15 分钟10 页约 80 秒/页的节奏语气 formal、reportorial匹配 Brutalist 报纸基调目的 inform年报式行业简报。PPT Master 支持把 notes 转成 TTS 旁白仓库含 notes_to_audio.py 与多个 TTS 后端而 notes 与 SVG 的命名对齐正是音频对齐narration_sync.py能够按页匹配的前提——spec 在这里提前锁定了命名契约避免执行完 10 页 SVG 后才发现讲稿对不上页。11. 技术约束XISVG 与 PPT 兼容性的负面清单第 XI 节是整份文档的“验收条款”分两组列出SVG 生成必须遵守viewBox 固定0 0 1280 720背景用rect#FFFFFF纸白文本换行用tspan禁用foreignObject透明度用fill-opacity/stroke-opacity禁用rgba()禁用mask、style、class、foreignObject、textPath、animate*、script文本用原始 Unicode 排印符号em dash—、en dash–、→、NBSP、©禁用 HTML 命名实体marker-start/marker-end条件允许——仅限defs内的三角/菱形/圆形箭头且orientautoclipPath仅可用于image本案例用于 hero / sidebar / banner 照片。PPT 兼容规则禁用g opacity...透明度必须逐子元素设置图片透明效果用覆盖层rect fillbg opacity0.x/实现对应 P06 的 “#30 半透明矩形遮罩”仅内联样式禁用外部 CSS /font-face字体必须使用 typography stack 中登记的 PPT-safe 字体——转换器只会写入第一个 Latin 字体与第一个 CJK 字体stack 顺序即最终嵌入顺序。这些约束并非任意严苛它们保证每一页 SVG 在经 PPT Master 的 SVG→PPTX 转换链路svg_to_pptx.py 及其 drawingml 转换子包后仍落成原生可编辑的 DrawingML 形状与文本而不是“一张图片糊在幻灯片上”。例如禁用style/class是因为逐页 SVG 被独立转换外部样式表不会随行禁用g opacity是因为 DrawingML 的形状透明度需要落在具体图形对象上“转换器只写第一个 Latin 第一个 CJK 字体”则解释了为什么字体 stack 的书写顺序在 spec 里被当作事实规格来对待。仓库中的质量检查器svg_quality/checker.py、svg_quality_checker.py会对生成页做类似约束的自动化校验spec 第十一节相当于把验收标准前移到了生成之前。12. 复盘这份 design_spec 的可迁移骨架把 300 行的案例抽出来看它示范了一个可复用的 spec 骨架任何主题都可以照此填充I 项目信息一页表锁定名称、画布、页数、风格、受众、用途II 画布viewBox 边距 内容区尺寸全部给具体像素III 视觉主题角色化色板含 accent 使用配额、AI 图像渲染/色板策略取值必须来自参考库索引IV 字体角色字体表 基线字号 倍数层级表V 布局纵切分 布局模式库 “范围/当前值”双列间距表VI 图标用或不用显式声明VII 图表从模板索引召回 → 逐字引用判据 → 选型 落选理由VIII 图像文件名、目标尺寸、布局模式编号、完整 prompt、text_policy、page_roleIX 大纲逐页 Layout/Title/数据点/来源数字全部具名溯源X 讲稿notes 与 SVG 同名的命名契约 时长与语气XI 技术约束SVG 负面清单 PPT 兼容规则作为验收条款。对照仓库中机器侧的 Schemadesign_spec.schema.json与风格参考visual-styles/brutalist.md、图表目录charts/README.md、布局模式库image-layout-patterns.md可以看出这份 Brutalist 报纸案例的每个数字、每个字体名、每条 prompt 都不是自由发挥而是被“Schema 必填章节 风格参考 模板索引 约束清单”四面夹住的结果。这正是 PPT Master 生成质量稳定性的来源把审美决策前置到一份可校验的 Markdown 里而不是留给逐页生成时的即兴发挥。【免费下载链接】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），仅供参考