PPTX/openspec/changes/archive/2026-03-03-inline-templates/tasks.md

1. 核心功能实现

• 1.1 在 core/template.py 中新增 from_data() 类方法，支持从字典创建模板实例
• 1.2 修改 core/presentation.py 的 __init__ 方法，解析并保存 templates 字段到 self.inline_templates
• 1.3 修改 core/presentation.py 的 get_template() 方法，实现同名模板检测并抛出 ERROR 错误
• 1.4 在 loaders/yaml_loader.py 中新增 validate_templates_yaml() 函数，验证 templates 字段结构
• 1.5 修改 loaders/yaml_loader.py 的 validate_presentation_yaml() 函数，调用 validate_templates_yaml() 进行验证

2. 验证逻辑实现

• 2.1 实现 validate_templates_yaml() 中的模板结构验证：检查 templates 是否为字典
• 2.2 实现 validate_templates_yaml() 中的模板元素验证：检查每个模板是否有必需的 elements 字段
• 2.3 实现 validate_templates_yaml() 中的变量定义验证：检查每个变量是否有必需的 name 字段
• 2.4 实现 validate_templates_yaml() 中的默认值验证：检测默认值中引用不存在的变量

3. 错误处理实现

• 3.1 在 core/presentation.py 的 get_template() 中添加同名模板检测逻辑，抛出 ERROR 错误
• 3.2 在 core/template.py 的 render() 方法中添加内联模板相互引用的检测逻辑
• 3.3 优化错误消息格式，包含模板名称和具体位置信息（已在上述实现中完成）
• 3.4 实现循环引用检测：防止内联模板自引用（已在任务 3.2 中实现）

4. 测试用例实现

• 4.1 在 tests/unit/test_template.py 中新增 from_data() 方法的单元测试
• 4.2 在 tests/unit/test_presentation.py 中新增内联模板查找的单元测试
• 4.3 在 tests/unit/test_loaders/test_yaml_loader.py 中新增 validate_templates_yaml() 的测试用例
• 4.4 在 tests/integration/test_presentation.py 中新增内联模板集成测试
• 4.5 新增内联模板基本使用场景测试：定义、引用、变量替换、条件渲染
• 4.6 新增同名模板报错测试：验证内联和外部模板同名时系统抛出 ERROR
• 4.7 新增内联模板错误处理测试：验证各种错误场景的错误消息和级别
• 4.8 新增向后兼容性测试：验证不使用 templates 字段时系统行为不变
• 4.2 在 tests/unit/test_presentation.py 中新增内联模板查找的单元测试
• 4.3 在 tests/unit/test_loaders/test_yaml_loader.py 中新增 validate_templates_yaml() 的测试用例
• 4.4 在 tests/integration/test_presentation.py 中新增内联模板集成测试
• 4.5 新增内联模板基本使用场景测试：定义、引用、变量替换、条件渲染
• 4.6 新增同名模板报错测试：验证内联和外部模板同名时系统抛出 ERROR
• 4.7 新增内联模板错误处理测试：验证各种错误场景的错误消息和级别
• 4.8 新增向后兼容性测试：验证不使用 templates 字段时系统行为不变

5. 文档更新

• 5.1 更新 README.md，添加内联模板的语法说明和使用示例
• 5.2 更新 README_DEV.md，说明内联模板的实现细节和设计决策
• 5.3 添加内联模板的最佳实践指南，说明何时使用内联模板 vs 外部模板

6. 验证和收尾

• 6.1 运行完整的测试套件，确保所有测试通过
• 6.2 使用 uv run pytest -v 验证新增测试用例
• 6.3 手动测试：创建包含内联模板的示例 YAML 文件，验证转换功能正常
• 6.4 手动测试：创建混合使用内联和外部模板的示例，验证优先级规则
• 6.5 使用 uv run pytest --cov=. --cov-report=html 检查测试覆盖率
• 6.6 使用 uv run yaml2pptx.py check 验证 YAML 验证功能正常