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
parent 5b367f7ef3
commit 5d60f3c2c2
10 changed files with 1042 additions and 21 deletions
--- a/openspec/changes/archive/2026-03-04-template-element-composition/.openspec.yaml
+++ b/openspec/changes/archive/2026-03-04-template-element-composition/.openspec.yaml
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-03-04
--- a/openspec/changes/archive/2026-03-04-template-element-composition/design.md
+++ b/openspec/changes/archive/2026-03-04-template-element-composition/design.md
@@ -0,0 +1,247 @@
+# Template Element Composition - 技术设计
+
+## Context
+
+### 当前状态
+
+现有模板系统采用"全有或全无"模式：
+- `Presentation.render_slide()` 方法使用 if-else 结构
+- 有 `template` 字段：渲染模板，使用模板元素
+- 无 `template` 字段：使用自定义元素
+
+```python
+# core/presentation.py 当前实现
+def render_slide(self, slide_data):
+    if "template" in slide_data:
+        elements = template.render(vars_values)
+    else:
+        elements = slide_data.get("elements", [])
+```
+
+### 约束条件
+
+1. **向后兼容性**：现有用法必须保持不变
+2. **变量共享**：自定义元素需要访问模板变量
+3. **渲染顺序**：模板元素在前，自定义元素在后（z轴顺序）
+
+### 涉及模块
+
+- `core/template.py` - Template 类
+- `core/presentation.py` - Presentation.render_slide() 方法
+- `loaders/yaml_loader.py` - YAML 验证（可能需要调整）
+
+## Goals / Non-Goals
+
+**Goals:**
+- 支持幻灯片同时使用 `template` 和 `elements` 字段
+- 自定义元素能够访问模板变量
+- 元素采用简单追加策略合并
+- 完全向后兼容现有用法
+
+**Non-Goals:**
+- 不支持元素的位置感知合并（如按 key 合并或区域合并）
+- 不支持元素覆盖/替换（使用 slot 机制）
+- 不添加元素重叠检测或警告
+- 不改变模板的条件渲染逻辑
+
+## Decisions
+
+### 决策1：修改位置选择 - Presentation.render_slide()
+
+**选择**：在 `Presentation.render_slide()` 中实现混合模式逻辑
+
+**理由**：
+- `render_slide()` 已经负责处理幻灯片渲染的完整流程
+- 模板渲染和元素解析都在这里进行，是天然的合并点
+- 避免在 Template 类中增加对"幻灯片级元素"的认知，保持职责单一
+
+**替代方案**：
+- 在 `Template.render()` 中添加 `extra_elements` 参数
+  - 缺点：让 Template 类感知"外部元素"，违反单一职责原则
+  - 缺点：增加 render() 方法的复杂度
+
+### 决策2：变量解析策略 - 复用 Template.resolve_element()
+
+**选择**：自定义元素复用模板的 `resolve_element()` 方法进行变量解析
+
+**理由**：
+- `resolve_element()` 已经实现了深度递归的变量解析逻辑
+- 支持嵌套对象、数组中的变量替换
+- 自动处理类型转换（字符串转数字）
+
+**实现方式**：
+```python
+# 获取模板后，使用其实例方法解析自定义元素
+if "template" in slide_data:
+    template = self.get_template(template_name)
+    vars_values = slide_data.get("vars", {})
+    template_elements = template.render(vars_values)
+
+    # 解析自定义元素（使用模板的变量上下文）
+    if "elements" in slide_data:
+        custom_elements = slide_data["elements"]
+        resolved_custom = [template.resolve_element(e, vars_values) for e in custom_elements]
+```
+
+**替代方案**：
+- 创建独立的变量解析函数
+  - 缺点：代码重复，维护两套解析逻辑
+
+### 决策3：元素合并策略 - 简单追加
+
+**选择**：使用列表追加（`template_elements + custom_elements`）
+
+**理由**：
+- 简单直观，符合用户预期
+- 保持渲染顺序 = z 轴顺序
+- 无需引入复杂的合并规则
+
+**行为**：
+```python
+final_elements = template_elements + custom_elements
+```
+
+**替代方案**：
+- 按 ID/key 合并（类似 slot 机制）
+  - 缺点：需要引入元素 ID 概念，复杂度高
+  - 缺点：打破向后兼容性
+
+### 决策4：空 elements 处理
+
+**选择**：`elements: []` 等同于不指定 `elements`
+
+**理由**：
+- 保持 YAML 语法的自然语义
+- 避免引入特殊行为差异
+
+**实现**：
+```python
+if slide_data.get("elements"):  # 空列表为 False
+    # 处理自定义元素
+```
+
+### 决策5：YAML 验证不变
+
+**选择**：不修改 `yaml_loader.py` 的验证逻辑
+
+**理由**：
+- 现有验证已允许 `template` 和 `elements` 同时存在（验证的是各自的结构）
+- 混合模式是渲染时的行为，不是 YAML 结构的变化
+- 避免不必要的验证逻辑修改
+
+## Risks / Trade-offs
+
+### 风险1：元素位置重叠导致意外的视觉覆盖
+
+**场景**：用户在不知道模板布局的情况下，放置自定义元素与模板元素重叠
+
+**缓解措施**：
+- 在预览模式中用户可以实时看到效果
+- 文档中明确说明 z 轴顺序规则
+- 未来可选：添加几何验证警告（非必需）
+
+### 风险2：变量作用域混淆
+
+**场景**：自定义元素引用了模板中未定义的变量
+
+**缓解措施**：
+- 现有的 `resolve_value()` 已能捕获未定义变量并抛出错误
+- 错误信息清晰指出缺少的变量名
+
+### 风险3：条件渲染元素与自定义元素的交互不明确
+
+**场景**：模板中某个元素因 `visible: false` 被过滤，用户期望自定义元素"知道"这个区域
+
+**缓解措施**：
+- 这是设计预期，不是 bug
+- 文档中说明条件渲染在合并前完成
+- 用户需要了解模板的布局结构
+
+## 实现概要
+
+### 核心修改：Presentation.render_slide()
+
+```python
+def render_slide(self, slide_data):
+    """
+    渲染单个幻灯片（支持混合模式）
+
+    新增：支持同时使用 template 和 elements
+    """
+    has_template = "template" in slide_data
+    has_custom_elements = slide_data.get("elements")
+
+    elements_from_template = []
+    vars_values = {}
+
+    # 步骤1：渲染模板（如果有）
+    if has_template:
+        template_name = slide_data["template"]
+        template = self.get_template(template_name)
+        vars_values = slide_data.get("vars", {})
+        elements_from_template = template.render(vars_values)
+
+    # 步骤2：处理自定义元素（如果有）
+    elements_from_custom = []
+    if has_custom_elements:
+        custom_elements = slide_data["elements"]
+        if has_template:
+            # 混合模式：使用模板变量解析自定义元素
+            template = self.get_template(slide_data["template"])
+            elements_from_custom = [
+                template.resolve_element(elem, vars_values)
+                for elem in custom_elements
+            ]
+        else:
+            # 纯自定义模式（原有行为）
+            elements_from_custom = custom_elements
+
+    # 步骤3：合并元素
+    final_elements = elements_from_template + elements_from_custom
+
+    # 步骤4：转换为元素对象（原有逻辑）
+    element_objects = [create_element(elem) for elem in final_elements]
+
+    return {
+        "background": slide_data.get("background"),
+        "elements": element_objects,
+    }
+```
+
+### 测试策略
+
+1. **单元测试** (`tests/unit/test_presentation.py`)
+   - 测试纯模板模式（向后兼容）
+   - 测试纯自定义模式（向后兼容）
+   - 测试混合模式（新功能）
+   - 测试变量共享
+   - 测试空 elements 列表
+
+2. **集成测试** (`tests/integration/`)
+   - 端到端测试：YAML → PPTX
+   - 验证 z 轴顺序
+   - 验证条件渲染与元素合并的交互
+
+3. **E2E 测试** (`tests/e2e/`)
+   - 完整的 convert 命令测试
+   - 完整的 preview 命令测试
+
+## 迁移计划
+
+### 部署步骤
+
+1. 实现 `Presentation.render_slide()` 的混合模式逻辑
+2. 添加单元测试
+3. 添加集成测试和 E2E 测试
+4. 更新 README.md（新增混合模式使用说明）
+5. 更新 README_DEV.md（更新开发文档）
+
+### 回滚策略
+
+- 代码修改集中在单个方法 (`render_slide()`)
+- 如需回滚，恢复方法到原始实现即可
+- 向后兼容，现有用法不受影响
+
+## Open Questions
+
+无。所有设计决策已在探索阶段明确。
--- a/openspec/changes/archive/2026-03-04-template-element-composition/proposal.md
+++ b/openspec/changes/archive/2026-03-04-template-element-composition/proposal.md
@@ -0,0 +1,34 @@
+# 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、两者都不用的现有用法保持不变
+- 新功能为增量增强，不破坏任何现有用法
--- a/openspec/changes/archive/2026-03-04-template-element-composition/specs/template-system/spec.md
+++ b/openspec/changes/archive/2026-03-04-template-element-composition/specs/template-system/spec.md
@@ -0,0 +1,112 @@
+# Template System - Delta Spec
+
+本文档是 template-system 能力的 delta spec，定义模板元素组合功能的变更。
+
+## MODIFIED Requirements
+
+### Requirement: 系统必须支持自定义幻灯片
+
+系统 SHALL 支持不使用模板的自定义幻灯片，以及同时使用模板和自定义元素的混合模式幻灯片。
+
+#### Scenario: 渲染自定义幻灯片
+
+- **WHEN** 幻灯片未指定 `template` 字段，直接包含 `elements` 列表
+- **THEN** 系统跳过模板渲染，直接处理元素列表
+
+#### Scenario: 自定义幻灯片中直接指定样式
+
+- **WHEN** 自定义幻灯片的元素直接指定 `color: "#4a90e2"`
+- **THEN** 系统正确应用该颜色值
+
+#### Scenario: 自定义幻灯片和模板混合使用
+
+- **WHEN** 演示文稿中部分幻灯片使用模板，部分为自定义
+- **THEN** 系统正确处理两种类型的幻灯片
+
+#### Scenario: 混合模式幻灯片同时使用模板和自定义元素
+
+- **WHEN** 幻灯片同时指定了 `template` 字段和 `elements` 列表
+- **THEN** 系统先渲染模板获取模板元素列表，再追加自定义元素列表，生成最终的元素列表
+
+#### Scenario: 混合模式中模板元素在前
+
+- **WHEN** 幻灯片使用混合模式，模板元素和自定义元素位置重叠
+- **THEN** 自定义元素在 z 轴上覆盖模板元素（后渲染在上层）
+
+## ADDED Requirements
+
+### Requirement: 模板与自定义元素必须支持变量共享
+
+系统 SHALL 允许自定义元素访问模板中定义的变量，实现主题色、布局参数等值的统一控制。
+
+#### Scenario: 自定义元素使用模板变量
+
+- **WHEN** 幻灯片使用 `template: content-slide`，提供 `vars: {theme_color: "#3949ab"}`，且自定义元素中定义 `fill: "{theme_color}"`
+- **THEN** 系统将自定义元素中的 `{theme_color}` 替换为 `"#3949ab"`
+
+#### Scenario: 自定义元素使用模板默认变量
+
+- **WHEN** 模板定义了 `default: "#3949ab"` 的 `theme_color` 变量，幻灯片未提供该变量值，且自定义元素引用 `{theme_color}`
+- **THEN** 系统使用模板的默认值 `"#3949ab"` 进行替换
+
+#### Scenario: 自定义元素引用未定义变量时报错
+
+- **WHEN** 自定义元素引用了 `{undefined_var}`，且该变量未在模板 vars 中定义，也未由幻灯片提供
+- **THEN** 系统抛出错误，指出未定义的变量
+
+### Requirement: 元素合并必须采用追加策略
+
+系统 SHALL 使用简单追加策略合并模板元素和自定义元素，保持渲染顺序和 z 轴层级。
+
+#### Scenario: 模板元素和自定义元素合并顺序
+
+- **WHEN** 模板渲染后产生 2 个元素，幻灯片自定义元素列表包含 3 个元素
+- **THEN** 最终元素列表包含 5 个元素，顺序为：模板元素1、模板元素2、自定义元素1、自定义元素2、自定义元素3
+
+#### Scenario: 空自定义元素列表
+
+- **WHEN** 幻灯片指定 `template` 和 `elements: []`（空数组）
+- **THEN** 最终元素列表仅包含模板元素，等同于不指定 `elements` 字段
+
+#### Scenario: 模板条件渲染后的元素合并
+
+- **WHEN** 模板包含 3 个元素，其中 1 个因 `visible` 条件为假被过滤，幻灯片包含 2 个自定义元素
+- **THEN** 最终元素列表包含 4 个元素：模板的 2 个可见元素，加上幻灯片的 2 个自定义元素
+
+### Requirement: 混合模式必须保持向后兼容
+
+系统 SHALL 在不使用混合模式时，保持与现有版本完全一致的行为。
+
+#### Scenario: 仅使用模板时不指定 elements
+
+- **WHEN** 幻灯片仅指定 `template` 字段，不包含 `elements` 字段
+- **THEN** 系统表现与现有版本完全一致，仅渲染模板元素
+
+#### Scenario: 仅使用自定义元素时不指定 template
+
+- **WHEN** 幻灯片仅指定 `elements` 字段，不包含 `template` 字段
+- **THEN** 系统表现与现有版本完全一致，仅渲染自定义元素
+
+#### Scenario: 既不使用模板也不使用自定义元素
+
+- **WHEN** 幻灯片既不指定 `template` 也不指定 `elements`
+- **THEN** 系统生成空幻灯片（仅包含背景设置）
+
+### Requirement: 混合模式必须支持内联模板
+
+系统 SHALL 在混合模式中支持内联模板与外部模板，功能保持一致。
+
+#### Scenario: 内联模板与自定义元素混合使用
+
+- **WHEN** 幻灯片引用内联模板（在 YAML 文件的 `templates` 字段中定义），同时包含 `elements` 列表
+- **THEN** 系统正确渲染内联模板元素，并追加自定义元素
+
+#### Scenario: 外部模板与自定义元素混合使用
+
+- **WHEN** 幻灯片引用外部模板（从 `--template-dir` 目录加载），同时包含 `elements` 列表
+- **THEN** 系统正确加载外部模板，渲染模板元素，并追加自定义元素
+
+#### Scenario: 内联和外部模板在同一演示文稿中混合使用
+
+- **WHEN** 演示文稿同时定义了内联模板和使用外部模板，且部分幻灯片使用混合模式
+- **THEN** 系统正确处理所有组合情况
--- a/openspec/changes/archive/2026-03-04-template-element-composition/tasks.md
+++ b/openspec/changes/archive/2026-03-04-template-element-composition/tasks.md
@@ -0,0 +1,49 @@
+# Template Element Composition - 实现任务清单
+
+## 1. 核心实现
+
+- [x] 1.1 修改 `Presentation.render_slide()` 方法支持混合模式
+- [x] 1.2 实现模板元素和自定义元素的合并逻辑（简单追加策略）
+- [x] 1.3 实现自定义元素对模板变量的访问（复用 `Template.resolve_element()`）
+- [x] 1.4 处理空 `elements` 列表的情况（等同于不指定 elements）
+
+## 2. 单元测试
+
+- [x] 2.1 添加测试：纯模板模式（向后兼容验证）
+- [x] 2.2 添加测试：纯自定义元素模式（向后兼容验证）
+- [x] 2.3 添加测试：混合模式基本功能
+- [x] 2.4 添加测试：自定义元素访问模板变量
+- [x] 2.5 添加测试：空 elements 列表
+- [x] 2.6 添加测试：模板条件渲染后与自定义元素合并
+- [x] 2.7 添加测试：变量未定义时的错误处理
+- [x] 2.8 添加测试：内联模板与自定义元素混合使用
+- [x] 2.9 添加测试：外部模板与自定义元素混合使用
+
+## 3. 集成测试
+
+- [ ] 3.1 添加集成测试：完整的 YAML → PPTX 转换流程（混合模式）
+- [ ] 3.2 添加集成测试：验证 z 轴顺序（自定义元素覆盖模板元素）
+- [ ] 3.3 添加集成测试：背景设置与混合模式的交互
+
+## 4. E2E 测试
+
+- [ ] 4.1 添加 E2E 测试：convert 命令处理混合模式 YAML
+- [ ] 4.2 添加 E2E 测试：preview 命令显示混合模式幻灯片
+- [x] 4.3 创建测试用的混合模式 YAML 示例文件
+
+## 5. 文档更新
+
+- [x] 5.1 更新 README.md：新增"混合模式模板"使用说明
+- [x] 5.2 更新 README.md：添加混合模式语法示例
+- [x] 5.3 更新 README.md：说明 z 轴顺序规则
+- [x] 5.4 更新 README_DEV.md：说明元素合并策略
+- [x] 5.5 更新 README_DEV.md：添加混合模式相关的开发说明
+
+## 6. 验证与清理
+
+- [x] 6.1 运行所有单元测试并通过（`uv run pytest tests/unit/`）
+- [ ] 6.2 运行所有集成测试并通过（`uv run pytest tests/integration/`）
+- [ ] 6.3 运行所有 E2E 测试并通过（`uv run pytest tests/e2e/`）
+- [ ] 6.4 运行完整测试套件并通过（`uv run pytest`）
+- [x] 6.5 手动测试：使用现有 complex_presentation.yaml 验证向后兼容性
+- [x] 6.6 手动测试：创建新的混合模式 YAML 并通过 convert 命令生成 PPTX
--- a/openspec/specs/template-system/spec.md
+++ b/openspec/specs/template-system/spec.md
@@ -139,7 +139,7 @@ Template system 提供可复用的幻灯片布局和样式定义。模板包含

 ### Requirement: 系统必须支持自定义幻灯片

-系统 SHALL 支持不使用模板，直接定义元素的自定义幻灯片。
+系统 SHALL 支持不使用模板的自定义幻灯片，以及同时使用模板和自定义元素的混合模式幻灯片。

 #### Scenario: 渲染自定义幻灯片

@@ -156,6 +156,16 @@ Template system 提供可复用的幻灯片布局和样式定义。模板包含
 - **WHEN** 演示文稿中部分幻灯片使用模板，部分为自定义
 - **THEN** 系统正确处理两种类型的幻灯片

+#### Scenario: 混合模式幻灯片同时使用模板和自定义元素
+
+- **WHEN** 幻灯片同时指定了 `template` 字段和 `elements` 列表
+- **THEN** 系统先渲染模板获取模板元素列表，再追加自定义元素列表，生成最终的元素列表
+
+#### Scenario: 混合模式中模板元素在前
+
+- **WHEN** 幻灯片使用混合模式，模板元素和自定义元素位置重叠
+- **THEN** 自定义元素在 z 轴上覆盖模板元素（后渲染在上层）
+
 ### Requirement: 模板变量解析必须深度递归

 系统 SHALL 递归解析模板元素的所有嵌套字段中的变量引用。
@@ -241,3 +251,79 @@ Template system 提供可复用的幻灯片布局和样式定义。模板包含

 - **WHEN** 自定义幻灯片（不使用模板）定义了 `enabled: false`
 - **THEN** 系统跳过该幻灯片，不渲染元素列表
+
+### Requirement: 模板与自定义元素必须支持变量共享
+
+系统 SHALL 允许自定义元素访问模板中定义的变量，实现主题色、布局参数等值的统一控制。
+
+#### Scenario: 自定义元素使用模板变量
+
+- **WHEN** 幻灯片使用 `template: content-slide`，提供 `vars: {theme_color: "#3949ab"}`，且自定义元素中定义 `fill: "{theme_color}"`
+- **THEN** 系统将自定义元素中的 `{theme_color}` 替换为 `"#3949ab"`
+
+#### Scenario: 自定义元素使用模板默认变量
+
+- **WHEN** 模板定义了 `default: "#3949ab"` 的 `theme_color` 变量，幻灯片未提供该变量值，且自定义元素引用 `{theme_color}`
+- **THEN** 系统使用模板的默认值 `"#3949ab"` 进行替换
+
+#### Scenario: 自定义元素引用未定义变量时报错
+
+- **WHEN** 自定义元素引用了 `{undefined_var}`，且该变量未在模板 vars 中定义，也未由幻灯片提供
+- **THEN** 系统抛出错误，指出未定义的变量
+
+### Requirement: 元素合并必须采用追加策略
+
+系统 SHALL 使用简单追加策略合并模板元素和自定义元素，保持渲染顺序和 z 轴层级。
+
+#### Scenario: 模板元素和自定义元素合并顺序
+
+- **WHEN** 模板渲染后产生 2 个元素，幻灯片自定义元素列表包含 3 个元素
+- **THEN** 最终元素列表包含 5 个元素，顺序为：模板元素1、模板元素2、自定义元素1、自定义元素2、自定义元素3
+
+#### Scenario: 空自定义元素列表
+
+- **WHEN** 幻灯片指定 `template` 和 `elements: []`（空数组）
+- **THEN** 最终元素列表仅包含模板元素，等同于不指定 `elements` 字段
+
+#### Scenario: 模板条件渲染后的元素合并
+
+- **WHEN** 模板包含 3 个元素，其中 1 个因 `visible` 条件为假被过滤，幻灯片包含 2 个自定义元素
+- **THEN** 最终元素列表包含 4 个元素：模板的 2 个可见元素，加上幻灯片的 2 个自定义元素
+
+### Requirement: 混合模式必须保持向后兼容
+
+系统 SHALL 在不使用混合模式时，保持与现有版本完全一致的行为。
+
+#### Scenario: 仅使用模板时不指定 elements
+
+- **WHEN** 幻灯片仅指定 `template` 字段，不包含 `elements` 字段
+- **THEN** 系统表现与现有版本完全一致，仅渲染模板元素
+
+#### Scenario: 仅使用自定义元素时不指定 template
+
+- **WHEN** 幻灯片仅指定 `elements` 字段，不包含 `template` 字段
+- **THEN** 系统表现与现有版本完全一致，仅渲染自定义元素
+
+#### Scenario: 既不使用模板也不使用自定义元素
+
+- **WHEN** 幻灯片既不指定 `template` 也不指定 `elements`
+- **THEN** 系统生成空幻灯片（仅包含背景设置）
+
+### Requirement: 混合模式必须支持内联模板
+
+系统 SHALL 在混合模式中支持内联模板与外部模板，功能保持一致。
+
+#### Scenario: 内联模板与自定义元素混合使用
+
+- **WHEN** 幻灯片引用内联模板（在 YAML 文件的 `templates` 字段中定义），同时包含 `elements` 列表
+- **THEN** 系统正确渲染内联模板元素，并追加自定义元素
+
+#### Scenario: 外部模板与自定义元素混合使用
+
+- **WHEN** 幻灯片引用外部模板（从 `--template-dir` 目录加载），同时包含 `elements` 列表
+- **THEN** 系统正确加载外部模板，渲染模板元素，并追加自定义元素
+
+#### Scenario: 内联和外部模板在同一演示文稿中混合使用
+
+- **WHEN** 演示文稿同时定义了内联模板和使用外部模板，且部分幻灯片使用混合模式
+- **THEN** 系统正确处理所有组合情况