PPT制作大师

概述

PPT 制作大师 (ppt-master)

把「做 PPT」从排版苦力升级为结构化产出：先想清楚讲什么、怎么讲、长什么样，再一键生成专业 .pptx。

何时使用

• 用户说「帮我做个 PPT / 做个汇报 / 路演材料 / 答辩 PPT / 培训 slides」。
• 用户提供主题、大纲或素材，要求产出可交付的 .pptx。
• 用户要对现有 PPT 做结构/视觉重构或批量生成。

全链路工作流（5 步，结论先行）

第 1 步 · 需求理解 → 创意简报

向用户确认或推断：受众（老板/客户/团队）、目的（对齐/说服/汇报/转化）、时长/页数、基调（正式/活泼/高端）、约束（品牌色、必含数据）。输出一份创意简报（3–5 行），作为后续所有决策依据。信息不足时，用合理默认补全并显式说明，不要反复追问打断节奏。

第 2 步 · 内容架构 → 叙事框架

加载 references/narrative_frameworks.md，按目的选框架：

• 战略/愿景 → 黄金圈；观点汇报 → PREP；复盘/案例 → STAR；
• 推介/售前 → 问题-方案-收益 或 AIDA；进展/路线 → 时间线；决策 → 金字塔。

产出逐页大纲：每页标注「页型 + 结论式标题 + 核心信息 + 视觉建议」。页型目录见 references/slide_catalog.md。

第 3 步 · 视觉设计 → 主题

加载 references/design_system.md 做决策。选 1 套主题（见下「主题」），遵循：主色唯一、字体 ≤2 种、留白统一、一页一信息。把主题名写入 spec.meta.theme（如 "corporate-blue"）。

第 4 步 · 生成 .pptx

将大纲写成 spec.json（结构见下「规格速览」），调用生成引擎：

    python scripts/build_pptx.py --spec spec.json --theme assets/themes/主题名.json --out deck.pptx
# 或让引擎按 meta.theme 自动加载：
python scripts/build_pptx.py --spec spec.json --out deck.pptx

• 运行环境：使用受管 venv 中的 python（已预装 python-pptx），路径 C:/Users/Blues/.workbuddy/binaries/python/envs/default/Scripts/python.exe；脚本会在缺失依赖时自动补装。
• 若用户给的是图片，把路径写入 image 字段；缺失会生成占位框并在质检报 P0。

快捷路径 · 模板 + 内容 自动合成（用户给模板和文本）

当用户已经有一份文本/大纲 + 一个视觉模板，可直接自动产出成品，无需手写 spec：

# 模板 = template.json（含 meta 品牌信息 + theme 主题引用）+ 内容 = Markdown
python scripts/build_pptx.py --template assets/templates/business-proposal.json 
       --content assets/sample_content.md --out deck.pptx --dump-spec deck_spec.json

# 模板 = 用户现有 .pptx 母版（自动抽取其主题色/字体并继承版式）
python scripts/build_pptx.py --template 用户品牌.pptx --content notes.md --out deck.pptx

• 模板两种形态：
  • template.json：{"meta":{...}, "theme":"corporate-blue" | 内联主题对象 | 另一个 .pptx, "structure": null}。最稳，推荐。
  • 品牌.pptx：直接拿用户现有演示做母版，引擎抽取其配色方案/字体并套用到新内容，版式与母版一致 → 最"像成品"。
• 内容三种入口（自动解析为页）：
  • .md：标题→页、列表→要点、| 表格 |→表格页、![alt](图)→图片页；首行 H1 作封面，空标题块作章节分隔。
  • .txt：按空行分块，首行作标题，列表作要点。
  • .json：已是 spec，直接渲染（可省去模板）。
• 文末 作者/日期/单位：xxx（中文冒号）会被自动抽取进封面元信息。
• --dump-spec 可同时导出合成后的 spec.json，便于交给 qa_pptx.py 做一致性质检。

第 5 步 · 质检

# spec 路径
python scripts/qa_pptx.py --spec spec.json --pptx deck.pptx --theme assets/themes/主题名.json
# 模板+内容路径：用 --content 校验「内容是否都被生成」
python scripts/qa_pptx.py --content notes.md --pptx deck.pptx --theme assets/themes/主题名.json

按 P0 阻断 / P1 建议 / P2 提示 分级结论：

• P0（必须修）：页数不符、图片/图表页占位未替换、含占位文本。修复后重生成。
• P1（建议修）：使用了非主题字体等一致性偏差。
• P2：信息性提示。

无 P0 方可交付；交付前用 present_files 把 .pptx 呈现给用户预览。

规格 (spec.json) 速览

{
  "meta": {"title": "...", "subtitle": "...", "author": "...", "date": "...", "theme": "corporate-blue"},
  "slides": [
    {"type": "cover", "title": "...", "subtitle": "...", "tag": "...", "author": "...", "date": "..."},
    {"type": "section", "index": "01", "title": "...", "subtitle": "..."},
    {"type": "content", "title": "...", "subtitle": "...", "items": [{"text":"...","level":0},{"text":"...","level":1}]},
    {"type": "two-column", "title":"...", "left":{"heading":"...","items":[{"text":"...","desc":"..."}]}, "right":{...}},
    {"type": "image", "title":"...", "image":"路径", "caption":"..."},
    {"type": "quote", "text":"...", "author":"..."},
    {"type": "stats", "title":"...", "items":[{"value":"+38%","label":"用户增长"}]},
    {"type": "timeline", "title":"...", "steps":[{"phase":"Q1","title":"...","desc":"..."}]},
    {"type": "chart", "title":"...", "chart":"column|bar|line|pie", "categories":["A","B"], "series":[{"name":"S1","values":[1,2]}], "axis_x":"...", "axis_y":"..."},
    {"type": "table", "title":"...", "subtitle":"...", "headers":["列1","列2"], "rows":[["a","b"],["c","d"]]},
    {"type": "thank-you", "title":"...", "subtitle":"...", "contact":"..."}
  ]
}

扩展字段：每页可加 notes（演讲者备注，写入 pptx 备注栏）；meta 可加 logo（品牌图路径，自动置于封面与页眉右上）；chart 可加 axis_x/axis_y 轴标题与 pct（数值带 %）。完整字段见 references/slide_catalog.md。assets/example_spec.json 是一份可直接运行的样例。

主题 (theme.json)

内置 5 套，位于 assets/themes/：

• corporate-blue 企业蓝（稳重商务，默认）
• tech-purple 科技紫（前沿创新）
• warm-orange 暖橙活力（营销路演）
• minimal-ink 极简墨黑（高端克制）
• fresh-green 清新绿（成长可持续）

自定义：复制任一主题改色即可，字段含义见 references/design_system.md 第 2 节。

交付质量基线（发布前自检）

• [ ] 页数 = 大纲页数，无占位/缺失。
• [ ] 标题均为「结论式」，每页只讲一件事。
• [ ] 全篇主色、字体、边距统一。
• [ ] 含达标数据的页用 stats/chart 而非文字堆砌。
• [ ] QA 无 P0；如有 P1 已评估。

常见失败与规避

• 中文乱码：引擎已自动设置东亚字体属性；自定义字体须是环境已装的中文字体。
• 图片缺失变占位：务必给真实路径；网络图先下载到本地。
• 图表不显示：categories 与每个 series.values 长度须一致。
• 满屏高亮没重点：按 60-30-10 控制配色，仅 1 处用 accent。
• 一页塞太多：主点 ≤6，超出拆页。

参考文档（按需加载）

• references/design_system.md — 配色/字体/栅格/中文禁忌
• references/narrative_frameworks.md — 7 种叙事框架与选型
• references/slide_catalog.md — 10 种页型字段与组合建议
• references/content_ingestion.md — 模板 + 内容 自动合成规则详解
• assets/example_spec.json — 可直接运行的完整样例（spec 路径）
• assets/templates/business-proposal.json — 模板样例（模板 + 内容路径）
• assets/sample_content.md — 示例内容（Markdown 解析样例）
• assets/themes/*.json — 主题定义