# PPTX Slide Notes

## Purpose

PPTX 备注功能允许用户在生成 PPTX 文件时，将幻灯片的 description 字段内容写入备注页。备注页是 PPT 的原生演讲者工具，在演示时可以查看但不显示给观众，非常适合存储演讲说明和备注信息。

## Requirements

### Requirement: 幻灯片description必须写入PPT备注页

系统 SHALL 在生成 PPTX 时，将幻灯片的 `description` 字段内容写入该幻灯片的备注页。

#### Scenario: 幻灯片包含description

- **WHEN** 幻灯片定义了 `description: "这是幻灯片的演讲说明"`
- **THEN** PPTX 幻灯片的备注页包含该文本内容

#### Scenario: description包含多行文本

- **WHEN** 幻灯片的 description 使用 YAML 多行文本格式定义
- **THEN** 备注页保留完整的文本内容，包括换行符

#### Scenario: description为空字符串

- **WHEN** 幻灯片定义了 `description: ""`
- **THEN** 备注页设置为空字符串（不为 None）

### Requirement: 无description时不设置备注

系统 SHALL 在幻灯片没有 `description` 字段时不设置备注内容。

#### Scenario: 幻灯片不包含description

- **WHEN** 幻灯片定义未包含 `description` 字段
- **THEN** PPTX 幻灯片不设置备注，使用默认空备注页

### Requirement: 模板description不写入备注

系统 SHALL 仅处理幻灯片级别的 `description`，不使用模板的 `description`。

#### Scenario: 模板有description但幻灯片没有

- **WHEN** 模板定义了 `description: "模板说明"` 但幻灯片未定义 `description`
- **THEN** PPTX 幻灯片不设置备注，不继承模板的 description

#### Scenario: 模板和幻灯片都有description

- **WHEN** 模板定义了 `description` 且幻灯片也定义了 `description`
- **THEN** PPTX 幻灯片备注仅包含幻灯片的 description，忽略模板的 description

### Requirement: description必须支持中文字符

系统 SHALL 支持在 `description` 字段中使用中文字符，并正确写入 PPTX 备注。

#### Scenario: description包含中文

- **WHEN** 幻灯片的 description 包含中文字符，如 "这是演讲备注内容"
- **THEN** 系统正确处理，PPTX 备注页显示正确的中文内容