lanyuanxiaoyao/PPTX
1
0
Fork 0
Code Activity
Files
124ef0e5ce2206a25b4b0cecaa8fdfae3d949fbf
PPTX/openspec/changes/archive/2026-03-04-add-slide-notes/proposal.md
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

1.3 KiB
Raw Blame History

Why

幻灯片的 description 字段已经在系统中被解析和传递，但目前未被实际使用。PPT 备注页是演讲者的原生工具，非常适合存储这些演讲说明。通过将 description 写入 PPT 备注，可以让用户在演示时查看说明而不显示给观众，充分利用已有数据。

What Changes

  • 在 PPTX 生成时，将幻灯片的 description 字段写入备注页
  • 仅处理幻灯片级别的 description，不继承模板的 description
  • 如果幻灯片没有 description，则不设置备注
  • 修改现有 page-description spec 的需求，因为 description 现在会影响 PPTX 输出

Capabilities

New Capabilities

  • pptx-slide-notes: 幻灯片备注功能，支持将 description 内容写入 PPT 备注页

Modified Capabilities

  • page-description: 现有 spec 规定 "description字段不得影响渲染逻辑" 和 "description不写入PPTX文件"，需要更新为允许 description 写入备注页

Impact

  • renderers/pptx_renderer.py: 在 add_slide 方法中添加设置备注的逻辑
  • openspec/specs/page-description/spec.md: 更新需求，移除 "不得影响渲染逻辑" 的限制
  • openspec/specs/pptx-slide-notes/spec.md: 新建 spec 定义备注功能需求
  • README.md 和 README_DEV.md: 更新文档说明备注功能
View Git Blame Copy Permalink