PPTX 快速生成模板

它解决什么问题

用代码生成演示文稿时，翻车点往往不是"画不出来"，而是产物拿回去没法改。不少方案把整页幻灯片栅格化成一张图片，或用字符串手工拼接 JSON 规格，结果在 PowerPoint、WPS、Keynote 里要么不可编辑，要么字段冲突、缺图缺表却静默通过。这个技能把可编辑性当作硬约束：页面一律由原生文本框、形状、线条、图片、表格、图表、演讲者备注和图标构建，除非明确要求图片型演示文稿，不允许整页打平。

核心能力与工作流程

• 样式系统：内置 magazine（杂志式、纸张质感、大字号）、swiss（网格商务风、克制强调色）、cmb（招行风格，含 classic/pearl/graphite 主题）。三者共用同一套 canonical layout 名称与顶层字段，切换 style 只改视觉实现，不改 JSON 结构。
• 先选 style 再拿布局示例：先跑 --style-guide 读注册表；用户未指定时必须用交互工具让其选择，不能自行挑第一项或写死列表。选定后生成该 style 的全布局 JSON 示例 Markdown，含 47 种 canonical layout 的完整字段，不需要读模板 JS 源码。
• 直接写 deck.json：不再产出 deck.plan.json 或容量指南，而是结合用户内容与布局示例一次性写完整规格，再转成友好的 Markdown 大纲，最后生成 PPTX。
• 排版统一：中文与混排用 Microsoft YaHei，纯英文用 Times New Roman；封面/章节/结尾标题 36 pt，内容页标题 28 pt，要点 16 pt、正文 14 pt、密集小区域 12 pt；图表文本统一 YaHei 12 pt，由 scripts/pptxgen/engine.js 强制执行。
• DOCX 导入：专用入口 --write-extracted 会解析文本块、图片块、wp:extent 显示尺寸与 a:srcRect 裁剪参数；但 block 顺序只作阅读参考，严禁直接映射为 PPT 页面结构，须按语义重新规划后写 JSON。

适用边界与注意点

• 缺图、缺表、缺 chart data、必需集合缺失、字段冲突、标题过多正文不足属于阻断级错误；文本容量与审美是 warning，应修复后重生成，生成器不会静默截断或改写正文。
• image-* 布局必须提供 images 数组（1–6 张）且不接受 charts，图表请用 data-chart 或 data-dashboard。
• 需要分点时在 JSON 显式写 points/bullets/list，生成器不会自动把长段落切成项目符号。
• 演讲者备注用 speakerNotes（兼容 speaker_notes、presenterNotes），不要用 notes，部分布局会把它渲染成可见内容。
• 依赖 pptxgenjs、jszip、sharp、lucide；sharp 缺失时应安装而非退回直接插入 SVG，SVG 图标与标志会栅格化为 PNG 以提升 Office 与 LibreOffice 兼容性。
• 常规生成只读 SKILL.md、源材料、JSON 规格及引用素材；scripts/pptxgen/*.js 等源码仅在调试或改生成器时阅读。