bit-ppt-generator 0.3.0

package/content/example.yaml

@@ -0,0 +1,193 @@
+meta:
+  title: AI 科研助手探索结论与技术路线
+  subtitle: 从端到端 Agent 转向模型驱动 + 人类引导的 MCP 体系
+  author: AutoDL 团队
+  advisor: 北京理工大学
+  date: 2026.05
+
+slides:
+  - layout: title
+
+  - layout: agenda
+    title: 目录
+    items:
+      - 探索范围与项目分类
+      - 论文获取探索结果
+      - 代码执行与沙箱探索结果
+      - 数据集与图表生成探索结果
+      - 我们的技术路线
+
+  - layout: section
+    sectionNo: "01"
+    title: 探索范围与项目分类
+    subtitle: 从项目形态、自动化程度和交互方式建立对比框架
+
+  - layout: bullets
+    title: 核心发现与长列表拆页测试
+    lead: 调研发现，现有 AI 科研助手在自动化程度和人类控制权之间存在明显取舍。
+    fontSize: 15
+    bullets:
+      - 端到端 Agent 流程固定，适合演示，但学术伦理和可控性风险高。
+      - TUI / Web 工作台更符合人类引导理念，但需要用户切换到独立应用。
+      - 独立 MCP Server 具备跨客户端通用性，是值得优先投入的产品形态。
+      - 高校图书馆 session 复用可以绕开爬虫式全文获取的法律和体验问题。
+      - GPU 执行环境是面向机器学习复现实验的关键差异化能力。
+      - AI 生成 PPT 不应该直接生成代码，而应该生成稳定的结构化内容。
+      - 模板系统需要在生成阶段主动检测溢出，并在必要时自动拆页。
+      - 表格、长列表和参考文献是最容易破坏页面稳定性的三类内容。
+
+  - layout: claim
+    title: 单页核心结论
+    claim: AI 生成 PPT 的关键不是让模型学会排版，而是让模型只负责内容结构。
+    evidence:
+      - 模板负责字号、留白、页眉页脚和学校视觉规范。
+      - 生成器负责溢出检测、自动拆页和可编辑 PPTX 输出。
+      - AI 只需要选择合适 layout 并填入短内容。
+
+  - layout: twoColumn
+    title: 两栏观点页
+    left:
+      title: 传统做法
+      bullets:
+        - AI 直接写 PowerPoint 代码。
+        - 每次都需要重新解释版式要求。
+        - 长文本容易覆盖、溢出或风格漂移。
+    right:
+      title: 模板化做法
+      bullets:
+        - AI 只输出 YAML。
+        - 版式规则集中维护。
+        - 生成器自动处理拆页和缩放。
+
+  - layout: cards
+    title: 多观点卡片
+    cards:
+      - title: 内容结构
+        text: 用 YAML 限定字段，减少模型自由发挥导致的异常结构。
+      - title: 视觉规范
+        text: 北理工颜色、校徽、页眉和字号规则由模板统一控制。
+      - title: 可编辑输出
+        text: 文本框、表格和形状都是 PowerPoint 原生元素。
+      - title: 自动修复
+        text: 对长列表、宽表格和参考文献执行 preflight 检测。
+
+  - layout: table
+    title: 项目分类示例
+    columns: [类型, 项目, 交互方式, 自动化, 特点]
+    rows:
+      - [端到端自动化流水线, AI-Scientist / AgentLaboratory, CLI 命令启动, 全自动, 自动完成文献到论文流程]
+      - [TUI / Web 工作台, DeepScientist / Research-Claw, 终端 UI 或 Web, 半自动, 用户主导阶段推进]
+      - [对话式插件, claude-scholar / ScienceClaw, 对话驱动, 工具调用, 依赖 AI 客户端生态]
+      - [工业 R&D 框架, RD-Agent, Streamlit UI + CLI, 场景化, 偏工程应用]
+
+  - layout: comparison
+    title: 技术路线取舍
+    left:
+      label: 不优先做
+      title: 端到端 Agent
+      bullets:
+        - 流程封闭，用户难以介入
+        - 复现过程不可控
+        - 学术伦理风险更高
+    right:
+      label: 优先做
+      title: 独立 MCP Server
+      bullets:
+        - 跨 Claude、Cursor、Windsurf 等客户端
+        - 模型驱动，人类随时打断
+        - 更适合工具链和算力资源集成
+
+  - layout: timeline
+    title: 路线图
+    items:
+      - date: 阶段 1
+        title: 复刻模板
+        text: 固化北理工视觉规范。
+      - date: 阶段 2
+        title: 结构生成
+        text: 用 YAML 承接 AI 输出。
+      - date: 阶段 3
+        title: 溢出检测
+        text: 自动拆页与字号控制。
+      - date: 阶段 4
+        title: 内容修复
+        text: 回传模型压缩或重写。
+
+  - layout: process
+    title: AI 到 PPTX 的流程
+    steps:
+      - title: 规划
+        text: 选择章节和页面类型
+      - title: 写作
+        text: 生成符合 schema 的 YAML
+      - title: 检测
+        text: 估算文本和表格是否溢出
+      - title: 修复
+        text: 自动拆页或降字号
+      - title: 导出
+        text: 生成原生可编辑 PPTX
+
+  - layout: metrics
+    title: 关键指标页
+    metrics:
+      - value: 12+
+        label: 正文版式
+        note: 覆盖常见学术汇报页面
+      - value: 3
+        label: 拆页对象
+        note: bullets / table / references
+      - value: 0
+        label: LaTeX 依赖
+        note: 直接输出 PPTX
+      - value: 100%
+        label: 可编辑
+        note: 文本和形状均为原生对象
+
+  - layout: matrix
+    title: 方案判断矩阵
+    cells:
+      - title: 低成本 / 低控制
+        text: 简单 Markdown 幻灯片，适合快速预览，不适合稳定交付。
+      - title: 高成本 / 低控制
+        text: AI 直接操作 PPT，调试成本高且输出不稳定。
+      - title: 低成本 / 高控制
+        text: YAML 内容加代码模板，是当前推荐路线。
+      - title: 高成本 / 高控制
+        text: 完整设计系统和截图级校验，适合后续产品化阶段。
+
+  - layout: imageText
+    title: 北理工风格 PPT 模板生成器
+    image: assets/bit-campus-photo.png
+    text:
+      - 真实 PPTX 模板抽取视觉资产。
+      - YAML 负责内容结构，生成器负责版式稳定性。
+      - 输出原生 PPTX，文本、表格、形状都可继续编辑。
+
+  - layout: quote
+    title: 引用页
+    quote: 让模型生成结构化内容，让模板承担视觉和排版责任。
+    source: BIT PPT Template Generator
+
+  - layout: formula
+    title: 公式页
+    formula:
+      latex: "\\mathcal{L}(\\theta) = -\\sum_{i=1}^{n} y_i \\log p_{\\theta}(x_i)"
+    caption: 交叉熵损失函数示例
+    explanation:
+      - "$\\theta$ 表示模型参数，$p_{\\theta}(x_i)$ 表示样本预测概率。"
+      - 公式写入为 Office Math / OMML，简单行内公式也会和正文排在同一文本框中。
+
+  - layout: references
+    title: 参考文献与长文本拆页测试
+    items:
+      - Microsoft. Office Open XML File Formats specification and PowerPoint presentation structure.
+      - PptxGenJS project documentation. Generate editable PowerPoint presentations with JavaScript.
+      - 北京理工大学学术答辩 PPT 模板正式版，视觉风格与学校元素参考。
+      - AI content generation workflow: planner, slide writer, validator and repair loop.
+      - Markdown and structured data based slide generation, layout selection and overflow detection.
+      - Presentation design principles for academic defense decks, including typography, spacing and visual hierarchy.
+      - Automatic text wrapping approximation for mixed Chinese and English content in fixed-size slide boxes.
+
+  - layout: closing
+    title: 谢谢
+    subtitle: 敬请各位老师批评指正

package/content/extended-layout-test.yaml

@@ -0,0 +1,120 @@
+meta:
+  title: Extended Layout Test
+  subtitle: Academic defense semantic layouts
+  author: BIT Template
+  advisor: Generator
+  date: 2026.05
+
+slides:
+  - layout: title
+
+  - layout: problemSolution
+    title: 问题-方案-收益
+    problem:
+      title: AI 直接生成 PPT 不稳定
+      bullets:
+        - 版式漂移明显
+        - 长文本容易溢出
+        - 公式 $p_\theta(x)$ 难以保持一致
+    solution:
+      title: 结构化内容 + 模板生成
+      bullets:
+        - AI 输出 YAML
+        - 模板控制视觉规则
+        - 公式写入 OMML
+    impact:
+      title: 稳定交付可编辑 PPT
+      bullets:
+        - 文本和形状可编辑
+        - 公式原生可编辑
+        - 支持 preflight 拆页
+
+  - layout: painOpportunity
+    title: 现状痛点与机会
+    status:
+      title: 现状
+      bullets:
+        - 大多数工具偏 Markdown 预览
+        - PPTX 可编辑性不足
+    pain:
+      title: 痛点
+      bullets:
+        - 学校模板难复刻
+        - 公式、表格和长文本容易出错
+    opportunity:
+      title: 机会
+      bullets:
+        - Agent 负责内容
+        - MCP 负责生成和校验
+
+  - layout: experimentDesign
+    title: 实验设计
+    dataset:
+      - 使用真实北理工 PPT 模板作为视觉参考
+      - 使用多种 AI 生成内容作为压力测试
+    variables:
+      - 版式类型
+      - 文本长度
+      - 公式复杂度 $\\mathcal{L}(\\theta)$
+    metrics:
+      - OMML 数量
+      - marker 残留数量
+      - preflight 拆页数量
+    baselines:
+      - SVG 公式方案
+      - 纯文本公式方案
+    procedure: [生成 YAML, preflight, 导出 PPTX, WPS 打开验证]
+
+  - layout: resultAnalysis
+    title: 结果分析
+    finding: OMML 方案解决了公式图片变形和行内公式割裂问题。
+    metrics:
+      - value: "0"
+        label: SVG 公式
+        note: 公式不再图片化
+      - value: "18"
+        label: OMath 对象
+        note: 来自 inline test
+      - value: "0"
+        label: Marker 残留
+        note: 后处理替换完成
+    analysis:
+      - 表格公式可以正常显示，暂定为可用能力。
+      - 公式容错可处理 $p_\\theta$ 和 $x_i$ 等常见写法。
+
+  - layout: riskMitigation
+    title: 风险与对策
+    items:
+      - risk: 复杂 LaTeX 语法转换失败
+        impact: 生成中断
+        mitigation: 返回公式定位和 repair prompt
+      - risk: 表格公式在不同 Office 中兼容性不同
+        impact: 局部显示异常
+        mitigation: 增加 WPS / PowerPoint 回归样例
+      - risk: 长表格内容过密
+        impact: 字号过小或拆页过多
+        mitigation: preflight 提前拆页并提示压缩内容
+
+  - layout: contribution
+    title: 主要贡献
+    items:
+      - title: 模板复刻
+        text: 抽取北理工视觉资产并形成可复用生成规则。
+      - title: 结构生成
+        text: 用 YAML schema 限定 AI 输出范围。
+      - title: 公式支持
+        text: 将 $\\mathcal{L}(\\theta)$ 写入为 Office Math。
+      - title: 溢出检测
+        text: 对 bullets、table、references 执行 preflight。
+
+  - layout: summary
+    title: 阶段小结
+    takeaway: 当前路线已经从“能生成 PPT”推进到“可稳定承接 AI 内容”。
+    points:
+      - 常用正文类型进一步语义化。
+      - 公式已从 SVG 图片升级为 OMML。
+      - 下一步可以封装为本地 MCP 工具。
+
+  - layout: closing
+    title: 完成
+    subtitle: Extended layout test

package/content/formula-test.yaml

@@ -0,0 +1,31 @@
+meta:
+  title: Formula Test
+  subtitle: MathJax SVG formula rendering
+  author: BIT Template
+  advisor: Generator
+  date: 2026.05
+
+slides:
+  - layout: title
+
+  - layout: formula
+    title: 交叉熵损失
+    formula:
+      latex: "\\mathcal{L}(\\theta) = -\\frac{1}{n}\\sum_{i=1}^{n}\\sum_{k=1}^{K} y_{ik}\\log p_{\\theta,k}(x_i)"
+    caption: 多分类交叉熵目标函数
+    explanation:
+      - "$n$ 表示样本数量，$K$ 表示类别数量。"
+      - "$y_{ik}$ 是 one-hot 标签，$p_{\\theta,k}(x_i)$ 是模型预测概率。"
+
+  - layout: formula
+    title: 注意力机制
+    formula:
+      latex: "\\operatorname{Attention}(Q,K,V)=\\operatorname{softmax}\\left(\\frac{QK^{\\top}}{\\sqrt{d_k}}\\right)V"
+    caption: Scaled dot-product attention
+    explanation:
+      - "$Q$、$K$、$V$ 分别表示 query、key 和 value。"
+      - "$d_k$ 用于缩放点积，避免 softmax 梯度过小。"
+
+  - layout: closing
+    title: 完成
+    subtitle: Formula rendering test

package/content/image-layout-demo.yaml

@@ -0,0 +1,64 @@
+meta:
+  title: 图片智能排版示例
+  subtitle: 超宽图上置、普通图片侧置与图像网格
+  author: BIT PPT Generator
+  date: 2026
+
+slides:
+  - layout: title
+
+  - layout: imageText
+    title: 超宽图：可采用上图下字
+    image:
+      path: assets/bit-campus-line.png
+      placement: auto
+      fit: contain
+    caption: 只有明显超宽的图像才自动上置，避免挤压正文区域。
+    text:
+      - 超宽图放在上方，横向信息更完整。
+      - 下方只放少量要点，避免正文拥挤。
+      - 普通横图不会自动切到上下布局。
+
+  - layout: imageText
+    title: 普通横图：默认保留侧图侧字
+    image:
+      path: assets/bit-campus-photo.png
+      placement: auto
+      fit: contain
+    caption: 普通 3:2 横图仍采用侧图侧字，正文空间更充足。
+    text:
+      - PPT 本身是 16:9，不应把普通横图都上置。
+      - 侧栏图像配合右侧说明，信息密度更稳。
+      - 如需上置，可手动设置 placement: top。
+
+  - layout: imageGrid
+    title: 图像网格：多图结果展示
+    images:
+      - path: assets/bit-campus-photo.png
+        caption: 校园照片
+      - path: assets/bit-campus-line.png
+        caption: 线稿图
+      - path: assets/bit-emblem-gray.png
+        caption: 灰色徽记
+      - path: assets/bit-seal-small.png
+        caption: 印章
+
+  - layout: caseStudy
+    title: 案例页：图片对象语法
+    image:
+      path: assets/bit-campus-photo.png
+      fit: cover
+    caption: caseStudy 也支持图片对象写法。
+    context:
+      - 输入只需要给本地图片路径。
+      - check 阶段会验证路径是否存在。
+    method:
+      - 生成器读取图片比例。
+      - 根据布局选择 cover 或 contain。
+    result:
+      - 输出仍是可编辑 PPTX。
+      - 文本、图像、形状保持 Office 对象。
+
+  - layout: closing
+    title: 谢谢
+    subtitle: 图片布局示例结束

package/content/inline-formula-test.yaml

@@ -0,0 +1,62 @@
+meta:
+  title: Inline Formula Test
+  subtitle: OMML in normal text boxes
+  author: BIT Template
+  advisor: Generator
+  date: 2026.05
+
+slides:
+  - layout: title
+
+  - layout: bullets
+    title: 要点页行内公式
+    lead: 本页验证 $\\theta$ 和 $p_{\\theta}(x)$ 是否能出现在普通正文。
+    bullets:
+      - 参数 $\\theta$ 通过梯度下降更新。
+      - 预测概率 $p_{\\theta}(x_i)$ 与标签 $y_i$ 共同决定损失。
+
+  - layout: claim
+    title: 结论页行内公式
+    claim: 当 $\\mathcal{L}(\\theta)$ 下降时，模型拟合能力通常增强。
+    evidence:
+      - 如果验证集误差 $E_{val}$ 上升，则可能发生过拟合。
+      - 正则项 $\\lambda\\|\\theta\\|_2^2$ 可以约束参数规模。
+
+  - layout: twoColumn
+    title: 两栏页行内公式
+    left:
+      title: 目标函数
+      bullets:
+        - 最小化 $\\mathcal{L}_{train}$。
+        - 监控 $\\mathcal{L}_{val}$。
+    right:
+      title: 评价指标
+      bullets:
+        - 准确率 $Acc$ 越高越好。
+        - 损失 $Loss$ 越低越好。
+
+  - layout: cards
+    title: 卡片页行内公式
+    cards:
+      - title: 梯度
+        text: 使用 $\\nabla_{\\theta} \\mathcal{L}$ 指导参数更新。
+      - title: 学习率
+        text: 学习率 $\\eta$ 控制每步更新幅度。
+      - title: 批大小
+        text: 批大小 $B$ 影响梯度估计方差。
+
+  - layout: quote
+    title: 引用页行内公式
+    quote: 优化的核心是找到使 $\\mathcal{L}(\\theta)$ 足够小的参数。
+    source: Inline formula test
+
+  - layout: imageText
+    title: 图文页行内公式
+    image: assets/bit-campus-photo.png
+    text:
+      - 在图文说明中也可以写 $x_i$ 和 $y_i$。
+      - 这种写法比公式图片更自然。
+
+  - layout: closing
+    title: 完成
+    subtitle: Inline formula test

package/content/invalid-deck-test.yaml

@@ -0,0 +1,25 @@
+meta:
+  title: Invalid deck fixture
+  subtitle: Used to verify validation and repair prompts
+  author: BIT PPT Template Generator
+  date: 2026.05
+
+slides:
+  - layout: chart
+    title: 错误图表
+    type: bar
+    categories: [A, B, C]
+    series:
+      - name: Bad
+        values: [1, 2]
+
+  - layout: flowchart
+    title: 错误流程图
+    nodes:
+      - id: a
+        text: 开始
+      - id: b
+        text: 结束
+    edges:
+      - from: a
+        to: missing

package/content/overflow-test.yaml

@@ -0,0 +1,77 @@
+meta:
+  title: Overflow Test
+  subtitle: Preflight split detection
+  author: BIT Template
+  advisor: Generator
+  date: 2026.05
+
+slides:
+  - layout: title
+
+  - layout: bullets
+    title: 超长要点列表
+    lead: 这一页故意放入较多较长要点，用于验证生成器是否会在写入 PPTX 前自动拆页。
+    fontSize: 16
+    bullets:
+      - 这是一个很长的测试要点，用于模拟 AI 在没有约束时生成的段落式 bullet，它应当被估算为多行文本。
+      - 第二个测试要点同样偏长，包含中文、English words、数字 12345 和标点符号，用于测试混排宽度估计。
+      - 第三个测试要点继续占据空间，确保累计高度逐渐接近正文区域的安全阈值。
+      - 第四个测试要点继续制造溢出风险，生成器应该在达到阈值前把后续内容拆到下一页。
+      - 第五个测试要点用于确认 continuation slide 的标题会自动标记页码。
+      - 第六个测试要点用于确认拆页后仍然保留原始 layout 和视觉风格。
+      - 第七个测试要点用于确认长文本不会在同一页里互相覆盖。
+      - 第八个测试要点用于确认正文高度估算在保守阈值下生效。
+      - 第九个测试要点用于确认最后一页能够容纳剩余内容。
+      - 第十个测试要点用于确认输出 PPTX 仍然可以正常打开和编辑。
+
+  - layout: table
+    title: 超长表格
+    columns: [维度, 方案 A, 方案 B, 结论]
+    rows:
+      - [成本, 初期成本较低但后期维护成本较高, 初期建设成本中等但规则集中维护, 推荐方案 B]
+      - [稳定性, 依赖模型直接生成版式因此波动较大, 模板接管版式因此稳定性更高, 推荐方案 B]
+      - [可编辑性, 可能出现截图式页面或不可控元素, 原生 PPT 文本框和表格可编辑, 推荐方案 B]
+      - [扩展性, 新增页面类型需要重新提示模型, 新增 layout 即可复用, 推荐方案 B]
+      - [溢出处理, 依赖模型自觉控制长度, 生成器可在写入前检测和拆页, 推荐方案 B]
+      - [视觉一致性, 容易出现风格漂移, 统一使用北理工模板规则, 推荐方案 B]
+      - [协作方式, 设计和内容耦合在一次生成里, 内容和版式分离便于迭代, 推荐方案 B]
+      - [交付风险, 长文本容易遮挡和覆盖, preflight 可提前暴露风险, 推荐方案 B]
+      - [后续产品化, 难以验证每页是否合格, 可增加截图级回归检查, 推荐方案 B]
+      - [人工修改, 用户需要逐页检查是否有文字重叠和表格越界, 自动报告可以指出需要压缩或拆分的页面, 推荐方案 B]
+      - [模板复用, 每个新主题都重新生成样式会产生不一致, 固定 layout 后只替换内容即可保持一致, 推荐方案 B]
+      - [质量控制, 没有结构化中间表示时很难做程序检查, YAML schema 可以支持字段校验和布局规则校验, 推荐方案 B]
+      - [团队协作, 内容作者和模板作者职责混在一起, 内容作者只写 YAML 模板作者维护生成器, 推荐方案 B]
+
+  - layout: references
+    title: 超长参考文献
+    items:
+      - "Reference 1: a deliberately long bibliography item that should wrap into multiple lines in a fixed width box."
+      - "Reference 2: another deliberately long bibliography item with Chinese characters、English words and numbers 2026."
+      - "Reference 3: Office Open XML presentation structure and editable PowerPoint generation."
+      - "Reference 4: PptxGenJS documentation for creating text boxes, tables, images and shapes."
+      - "Reference 5: Layout preflight estimation for line wrapping and overflow prevention."
+      - "Reference 6: Academic presentation typography, spacing, visual hierarchy and defense deck design."
+      - "Reference 7: Structured YAML content generation for AI-assisted presentation authoring."
+      - "Reference 8: Conservative text measurement for mixed Chinese and English content."
+      - "Reference 9: Automatic page splitting for long bullet lists, references and table rows."
+      - "Reference 10: Future work on screenshot-based regression testing and repair prompts."
+      - "Reference 11: Long reference item for testing automatic continuation slides when bibliography content exceeds the safe writing area."
+      - "Reference 12: Another long reference item with enough words to wrap over multiple lines and trigger the conservative height estimator."
+      - "Reference 13: Structured presentation generation should expose preflight reports before writing final PowerPoint files."
+      - "Reference 14: Repair prompts can use overflow reports to ask the language model to shorten, split or reclassify content."
+      - "Reference 15: Academic templates should keep branding stable while allowing content to vary across research topics."
+      - "Reference 16: Native PPTX generation keeps text, tables and shapes editable after automatic layout processing."
+      - "Reference 17: Additional bibliography entry included solely to exceed the available reference page height."
+      - "Reference 18: Additional bibliography entry included solely to exceed the available reference page height."
+      - "Reference 19: Additional bibliography entry included solely to exceed the available reference page height."
+      - "Reference 20: Additional bibliography entry included solely to exceed the available reference page height."
+      - "Reference 21: Additional bibliography entry included solely to exceed the available reference page height."
+      - "Reference 22: Additional bibliography entry included solely to exceed the available reference page height."
+      - "Reference 23: Additional bibliography entry included solely to exceed the available reference page height."
+      - "Reference 24: Additional bibliography entry included solely to exceed the available reference page height."
+      - "Reference 25: Additional bibliography entry included solely to exceed the available reference page height."
+      - "Reference 26: Additional bibliography entry included solely to exceed the available reference page height."
+
+  - layout: closing
+    title: 完成
+    subtitle: Overflow preflight test

package/content/placeholder-image-demo.yaml

@@ -0,0 +1,59 @@
+meta:
+  title: 图片占位模式示例
+  subtitle: Placeholder image mode
+  author: BIT PPT Template Generator
+  date: 2026.05
+
+slides:
+  - layout: title
+
+  - layout: imageText
+    title: 暂无图片时的候选页
+    image:
+      mode: placeholder
+      prompt: 展示 YAML 输入、结构校验、PPTX 生成、OMML 后处理和人工替换图片的流程图。
+    text:
+      - 用户暂时没有图片时，也可以先生成完整 PPT 草稿。
+      - 比例未知时，预检会自动生成横图方案和侧图方案。
+      - 后续用户在 WPS 或 PowerPoint 中替换占位框即可。
+
+  - layout: imageText
+    title: 明确横图比例的占位页
+    image:
+      mode: placeholder
+      aspectRatio: "16:9"
+      placement: top
+      prompt: 一张用于论文答辩的系统架构横图，包含输入、生成、校验、输出四个模块。
+    text:
+      - 明确比例后只生成一页。
+      - 占位框内保留图片描述和建议比例。
+
+  - layout: caseStudy
+    title: 案例图占位
+    image:
+      mode: placeholder
+      aspectRatio: "4:3"
+      prompt: 一个展示生成前后 PPT 页面差异的对比截图。
+    caption: 后续可替换为真实系统截图。
+    context:
+      - 用户不方便上传截图。
+    method:
+      - 先用图片描述占位。
+    result:
+      - PPT 结构完整，图片后补。
+
+  - layout: imageGrid
+    title: 多图占位
+    images:
+      - mode: placeholder
+        aspectRatio: "1:1"
+        prompt: 输入样本截图
+        caption: 输入
+      - mode: placeholder
+        aspectRatio: "1:1"
+        prompt: 中间结果截图
+        caption: 中间结果
+      - mode: placeholder
+        aspectRatio: "1:1"
+        prompt: 输出 PPT 页面截图
+        caption: 输出

package/content/speaker-notes-demo.yaml

@@ -0,0 +1,30 @@
+meta:
+  title: 演讲者备注示例
+  subtitle: speakerNotes demo
+  author: BIT PPT Template Generator
+  date: 2026.05
+
+slides:
+  - layout: title
+    speakerNotes: |
+      开场先说明这是一份备注功能演示。
+      备注内容不会显示在幻灯片画布上，只会进入 PowerPoint/WPS 的备注区。
+
+  - layout: bullets
+    title: 备注功能验证
+    lead: 每页可以携带独立演讲稿。
+    bullets:
+      - 页面正文仍然是可编辑文本框。
+      - 备注通过 speakerNotes 写入真实 notesSlide。
+      - 备注中的公式暂时按普通文本保留，例如 $L(\theta)$。
+    speakerNotes:
+      - 这一页重点展示 speakerNotes 的字符串数组写法。
+      - 打开 PPT 后，在备注区应该能看到这两段演讲稿。
+      - 公式示例 $L(\theta)$ 目前保留为普通文本，后续再做备注 OMML。
+
+  - layout: closing
+    title: 谢谢
+    subtitle: 备注演示结束
+    speakerNotes: |
+      最后一页也有独立备注。
+      可以用于提醒答辩收尾、致谢和引导提问。

package/content/table-formula-test.yaml

@@ -0,0 +1,21 @@
+meta:
+  title: Table Formula Test
+  subtitle: OMML inside table cells
+  author: BIT Template
+  advisor: Generator
+  date: 2026.05
+
+slides:
+  - layout: title
+
+  - layout: table
+    title: 表格单元格公式测试
+    columns: [符号, 含义, 示例公式]
+    rows:
+      - ["$\\theta$", 模型参数, "$p_\\theta(x_i)$"]
+      - ["$x_i$", 第 i 个样本, "$\\mathcal{L}_i = -y_i \\log p_\\theta(x_i)$"]
+      - ["$\\eta$", 学习率, "$\\theta_{t+1}=\\theta_t-\\eta\\nabla_\\theta\\mathcal{L}$"]
+
+  - layout: closing
+    title: 完成
+    subtitle: Table formula test