guizang-ppt-lite

生成一份高级质感、商业表达优先、符合成熟演示文稿规则、单文件 HTML 的横向翻页网页 PPT。 生成的 PPT 放到当前项目的 ppt/ 文件夹下。

最高原则：先做演示设计，再写 HTML。 不得把内容随机塞入模板；每一页都必须先通过"页面角色、核心结论、视觉中心、信息层级、叙事节奏、可读性"的设计审查。

• 大师规则：详细生成规范见 references/ppt-master-rules.md（权威源）。
• 场景风格：4 种使用场景的详细规则见 references/scenario-styles.md（权威源）。
• 页面布局：10 种可选布局骨架见 references/layouts.md。
• 主题配色：5 套预设主题见 references/themes.md。

触发映射

场景风格不是皮肤，而是场景下的表达规则。4 种场景共用同一模板（assets/template.html）和同一套配色（references/themes.md），差异仅在内容规则、叙事结构和表达重心。详细规则见 references/scenario-styles.md。

强制工作流

Step 1 · 明确演示任务

先判断以下 5 项；信息不足且会影响质量时，最多问 3 个选择题。

Step 2 · 先产出演示蓝图

生成 HTML 前，先在内部完成演示蓝图：

受众判断 → 核心主张 → 叙事弧 → 页面清单 → 每页角色 → 每页核心结论 → 每页视觉中心 → 每页版式类型

不得跳过蓝图直接写页面。

各场景推荐叙事弧见 references/scenario-styles.md。

Step 3 · 使用大师规则设计每页

每页写代码前，必须逐页按 references/ppt-master-rules.md 确认：

• 页面角色（钩子/背景/问题/洞察/框架/证据/路径/行动/收束）
• 核心结论（标题能独立表达一个完整判断）
• 视觉中心（有且只有一个第一视觉焦点）
• 信息层级（主标题 > 关键数字/图形 > 支撑点 > 注释）
• 叙事位置（与前后页有因果/转折/递进关系）
• 认知负荷（一页最多 1 个主观点 + 3-5 个支撑点）
• 留白与重心（内容不贴边、不贴底、不平均摊满）
• 对齐与网格（元素共享清晰轴线）
• 可读性（投屏可读，不低对比，不小字堆叠）
• 配色安全（正文高对比；禁止灰字叠加半透明浅底）
• 完整显示（标题、正文、图注、行动项不得被裁切或遮挡）

Step 4 · 基于模板生成

1. 必须先 Read 读取 assets/template.html，确认 #deck 容器、.slide 结构、翻页 JS 逻辑。禁止未读模板就生成 HTML。
2. 所有 4 种场景共用 assets/template.html 这一个模板。
3. 必须使用模板内的 PPT Master Guards：.ppt-safe-frame、.ppt-balanced-frame、.ppt-action-frame、.ppt-focal、.surface-light、.surface-muted、.surface-ink、.surface-accent、.text-readable、.ppt-no-sink。
4. 必须复用模板的翻页机制：使用 #deck 容器（display: flex）+ CSS transform: translateX() + JS 精确切换。禁止自行发明翻页方案（scroll-snap、scrollIntoView 等）。
5. 基于模板生成目标 HTML；不得绕开模板重新写 CSS。
6. 替换 <title>。
7. 保持单文件 HTML；除非用户提供素材，否则不强行使用图片。
8. 主题色只从 references/themes.md 的 5 套预设中选择，不随意自造颜色。
9. 新增局部 CSS 必须通过"配色安全与完整显示规则"：正文对比度不低于模板正文；正文容器不得半透明；文字不得裁切或被导航遮挡。

反随机生成硬规则

禁止以下行为：

• 只根据页面数量平均分配内容。
• 看到"三个点"就机械使用三卡片。
• 每页都居中大标题。
• 把内容贴到底部或角落，导致视觉重心失衡。
• 为了填满页面增加无意义图形。
• 使用 opacity、过浅灰色、半透明背景承载正文。
• 在浅色/半透明卡片上使用 muted 灰色正文。
• 在没有真实图片素材时使用图片版式。
• 发明模板不存在的复杂类名。
• 绕开模板护栏重写 CSS。
• 使用 scroll-snap-type、scroll-snap-align、scroll-behavior: smooth 或 scrollIntoView() 实现翻页。必须用 #deck + transform: translateX()。
• 将中文、日文、韩文等 CJK 字符写成 Unicode 转义序列（如 \u8fc7\u53bb）。所有 CJK 文本必须写为原文字符。这是不可协商的硬约束。
• 禁止手写或简化模板的 <script type="module"> Motion One 动效引擎脚本。该脚本包含 window.__playSlide 注册和首屏 playSlide(0) 初始化调用（修复首次加载文字消失的 Bug），必须逐字复制自 assets/template.html。手写该脚本几乎必然遗漏初始化调用，导致首屏文字消失。

交付自检

错误处理