PPTX/openspec/changes/archive/2026-03-04-add-slide-notes/specs/page-description/spec.md at 3c13e5b64cbb3675d3f2d4d0bfcd38f1e790fe68

Files

lanyuanxiaoyao 7ef29ea039 feat: 实现幻灯片备注功能，将description写入PPT备注页

- 添加 PptxGenerator._set_notes() 方法设置备注
- 在 add_slide() 中调用 _set_notes() 处理 description
- 仅幻灯片级别的 description 写入备注，不继承模板
- 添加备注功能测试用例（8个测试）
- 更新 README.md 和 README_DEV.md 文档
- 新建 pptx-slide-notes spec
- 更新 page-description spec 允许写入备注
- 归档 add-slide-notes 变更

2026-03-04 14:47:03 +08:00

967 B

Raw Blame History

MODIFIED Requirements

Requirement: description字段不得影响渲染逻辑

系统 SHALL 在渲染幻灯片时忽略 description 字段对视觉元素的影响，但会将幻灯片级别的 description 写入 PPTX 备注页。

Scenario: 渲染包含description的模板

WHEN 系统渲染包含 description 字段的模板
THEN description不参与元素渲染，不影响幻灯片视觉输出

Scenario: 渲染包含description的幻灯片

WHEN 系统渲染包含 description 字段的幻灯片
THEN description写入PPTX文件的备注页，不影响幻灯片视觉输出

REMOVED Requirements

Requirement: description不写入PPTX文件

Reason: 幻灯片备注功能需要将 description 写入 PPTX 备注页，这是对 description 字段的合理利用。

Migration: 无需迁移，这是新增功能，不影响现有行为。没有 description 的幻灯片行为与之前完全一致。

967 B Raw Blame History Unescape Escape