Files

lanyuanxiaoyao 5d60f3c2c2 feat: 实现模板元素混合模式功能

新增混合模式，允许幻灯片同时使用 template 和 elements，实现更灵活的布局组合。

核心变更：
- core/presentation.py: 修改 render_slide() 支持三种模式（纯模板/纯自定义/混合模式）
- 自定义元素可访问模板变量，实现主题色等值的统一控制
- 元素采用简单追加策略合并（模板元素在前，自定义元素在后）
- 完全向后兼容现有用法

测试覆盖：
- 新增 TestRenderSlideHybridMode 测试类，包含 8 个测试用例
- 验证向后兼容性（纯模板模式、纯自定义模式）
- 验证混合模式功能（变量共享、空元素列表、元素顺序等）
- 所有 79 个测试通过

文档更新：
- README.md: 新增"混合模式模板"章节，包含语法示例和使用场景
- README_DEV.md: 更新开发文档，说明元素合并策略和实现细节

规范更新：
- openspec/specs/template-system/spec.md:
  - 修改"系统必须支持自定义幻灯片"需求，支持混合模式
  - 新增 4 个需求：变量共享、元素合并策略、向后兼容、内联模板支持
  - 新增 13 个场景定义

归档：
- openspec/changes/archive/2026-03-04-template-element-composition/: 完整变更记录

2026-03-04 13:12:51 +08:00

1.8 KiB

Raw Blame History

Template Element Composition 变更提案

Why

当前模板系统是"全有或全无"的：幻灯片要么使用模板（template），要么完全自定义（elements），无法同时使用两者。这导致多个模板中需要重复定义相同的头部 logo、标题栏、底部页码等元素。当需要修改这些共享元素时，必须同步更新多个模板文件，维护成本高且容易遗漏。

例如在 complex_presentation.yaml 中，title-slide、content-slide 和 two-column-slide 都各自定义了右上角的 5G logo，位置完全相同但需要重复编写。

What Changes

支持幻灯片同时使用 template 和 elements 字段，实现模板与自定义元素的混合模式
自定义元素能够访问模板中定义的变量，实现主题色、布局参数的统一控制
元素合并采用简单追加策略：模板元素在前，自定义元素在后（z轴顺序）
完全向后兼容：不写 elements 时行为与之前完全一致

Capabilities

Modified Capabilities

template-system: 新增"模板与自定义元素混合使用"需求，修改现有"系统必须支持自定义幻灯片"需求，允许 template 和 elements 同时存在

Impact

受影响的代码

core/template.py - Template.render() 方法需要调整，可能新增 merge_elements() 方法
loaders/yaml_loader.py - 幻灯片解析逻辑需要处理混合模式
core/presentation.py (或其他处理幻灯片的模块) - 调用模板渲染的流程需要修改

受影响的文档

README.md - 新增"混合模式模板"使用说明和示例
README_DEV.md - 更新开发文档，说明元素合并策略

向后兼容性

完全兼容：只使用 template、只使用 elements、两者都不用的现有用法保持不变
新功能为增量增强，不破坏任何现有用法

1.8 KiB Raw Blame History Unescape Escape