1
0

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 变更
This commit is contained in:
2026-03-04 14:47:03 +08:00
parent f34405be36
commit 7ef29ea039
12 changed files with 454 additions and 15 deletions

View File

@@ -0,0 +1,25 @@
## 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`: 更新文档说明备注功能