feat: 实现字体主题系统和东亚字体支持

实现完整的字体主题系统，支持可复用字体配置、预设类别和扩展属性。同时修复中文字体渲染问题，确保 Source Han Sans 等东亚字体正确显示。核心功能： - 字体主题配置：metadata.fonts 和 fonts_default - 三种引用方式：整体引用、继承覆盖、独立定义 - 预设字体类别：sans、serif、mono、cjk-sans、cjk-serif - 扩展字体属性：family、underline、strikethrough、line_spacing、 space_before、space_after、baseline、caps - 表格字体字段：font 和 header_font 替代旧的 style.font_size - 引用循环检测和属性继承链 - 模板字体继承支持东亚字体修复： - 添加 _set_font_with_eastasian() 方法 - 同时设置拉丁字体、东亚字体和复杂脚本字体 - 修复中文字符使用默认字体的问题测试： - 58 个单元测试覆盖所有字体系统功能 - 3 个集成测试验证端到端场景 - 移除旧语法相关测试文档： - 更新 README.md 添加字体主题系统使用说明 - 更新 README_DEV.md 添加技术文档 - 创建 4 个示例 YAML 文件 - 同步 delta specs 到主 specs 归档： - 归档 font-theme-system 变更到 openspec/changes/archive/ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-03-05 10:38:59 +08:00
parent 7ef29ea039
commit bd12fce14b
22 changed files with 3142 additions and 103 deletions
--- a/openspec/changes/archive/2026-03-05-font-theme-system/.openspec.yaml
+++ b/openspec/changes/archive/2026-03-05-font-theme-system/.openspec.yaml
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-03-04
--- a/openspec/changes/archive/2026-03-05-font-theme-system/design.md
+++ b/openspec/changes/archive/2026-03-05-font-theme-system/design.md
@@ -0,0 +1,369 @@
+# 字体主题系统设计文档
+
+## Context
+
+当前系统在 `core/elements.py` 中定义 `TextElement.font` 为字典类型，支持 size、bold、italic、color、align 五个属性。渲染器 `renderers/pptx_renderer.py` 的 `_render_text()` 方法直接访问这些字典字段并应用到 python-pptx 对象。
+
+表格元素 `TableElement` 通过 `style.font_size` 和 `style.header_color` 两个属性控制字体，与文本元素的 font 字典设计不一致。
+
+系统不存在字体主题抽象，所有字体配置都在元素级别定义，导致重复配置和缺乏统一的样式管理。
+
+### 约束条件
+
+- 继续使用 python-pptx 库，不能引入新的 PowerPoint 生成依赖
+- 字体检测不能污染主机环境配置，不能安装系统字体
+- 主要面向中文用户，必须优先处理 CJK 字体支持
+- 不考虑向后兼容性，使用新的字体配置语法
+- temp 目录仅用于临时文件和测试中间文件，正式示例文件放在 tests/fixtures/ 下
+
+## Goals / Non-Goals
+
+**Goals:**
+- 引入 fonts 和 fonts_default 元数据字段，支持定义可复用的字体配置
+- 实现三种字体引用方式：整体引用、继承覆盖、独立定义
+- 提供五种预设字体类别（sans、serif、mono、cjk-sans、cjk-serif），直接映射到推荐字体名称
+- 扩展字体属性集合，新增 family、underline、strikethrough、line_spacing、space_before、space_after、baseline、caps
+- 统一表格元素的字体配置方式，新增 font 和 header_font 字段，移除旧语法 style.font_size 和 style.header_color
+
+**Non-Goals:**
+- 不实现富文本混合样式（同一段落多种字体）
+- 不支持字体嵌入到 PPTX 文件（依赖系统字体）
+- 不实现多语言字体回退链（如英文用 Arial、中文用微软雅黑的自动切换）
+- 不验证字体是否存在（依赖 PowerPoint 自动回退）
+- 不考虑向后兼容性（直接使用新语法）
+
+## Decisions
+
+### 1. 数据结构设计
+
+**决策：使用 FontConfig 数据类替代原始字典**
+
+为保持与现有 TextElement 设计一致，创建 `FontConfig` 数据类封装字体配置：
+
+```python
+@dataclass
+class FontConfig:
+    parent: Optional[str] = None
+    family: Optional[str] = None
+    size: Optional[int] = None
+    bold: Optional[bool] = None
+    italic: Optional[bool] = None
+    underline: Optional[bool] = None
+    strikethrough: Optional[bool] = None
+    color: Optional[str] = None
+    align: Optional[str] = None
+    line_spacing: Optional[float] = None
+    space_before: Optional[int] = None
+    space_after: Optional[int] = None
+    baseline: Optional[str] = None
+    caps: Optional[str] = None
+```
+
+**理由：**
+- 数据类提供类型提示和验证入口
+- 与现有 TextElement、ImageElement 设计保持一致
+- 便于序列化和反序列化
+
+**替代方案：**
+- 继续使用字典：失去类型安全，验证逻辑分散
+- 继承 dict 的自定义类：复杂度增加，收益有限
+
+### 2. 元素 font 字段类型
+
+**决策：font 字段支持 FontConfig | str 两种类型**
+
+```python
+@dataclass
+class TextElement:
+    font: FontConfig | str | dict = field(default_factory=dict)
+```
+
+**理由：**
+- 字符串形式 `font: "@title"` 支持简洁的整体引用
+- 字典形式兼容现有 YAML 语法
+- FontConfig 对象作为内部表示
+
+**处理流程：**
+1. YAML 加载时保持原始类型（str 或 dict）
+2. 元素创建前解析为 FontConfig 对象
+3. 渲染时使用 FontConfig 对象
+
+### 3. 预设字体类别映射
+
+**决策：直接映射到推荐字体名称，不进行字体验证**
+
+```python
+# 预设字体类别映射（跨平台推荐）
+PRESET_FONT_MAPPING = {
+    "sans": "Arial",              # 西文无衬线，跨平台通用
+    "serif": "Times New Roman",   # 西文衬线，跨平台通用
+    "mono": "Courier New",        # 等宽字体，跨平台通用
+    "cjk-sans": "Microsoft YaHei",  # 中文无衬线（Windows 推荐）
+    "cjk-serif": "SimSun",         # 中文衬线（Windows 推荐）
+}
+```
+
+**理由：**
+- **零依赖**：不需要任何额外的字体检测库
+- **python-pptx 行为**：测试表明 `font.name` 可以接受任意字符串，不会报错
+- **PowerPoint 回退**：字体不存在时，由 PowerPoint 应用程序在打开文件时自动回退到系统默认字体
+- **简化实现**：避免复杂的平台检测和字体扫描逻辑
+
+**为什么不验证字体：**
+- python-pptx 不会验证字体是否存在
+- 验证需要额外依赖或复杂的平台特定代码
+- 字体不存在不会阻止转换，仅影响最终显示效果
+- 用户可以在 PowerPoint 中看到字体回退情况
+
+### 4. 字体引用解析顺序
+
+**决策：三阶段解析链（不验证字体）**
+
+```
+1. parent 解析（如果存在）
+   → 复制 fonts[parent] 的所有属性
+   → 用当前定义的属性覆盖
+
+2. family 解析
+   → "@xxx" 格式：仅验证是有效的引用格式
+   → "sans/..." 格式：映射到预设字体类别
+   → "FontName" 格式：直接使用字体名称（不验证）
+
+3. 未指定属性继承
+   → 继承 fonts_default 指向的配置
+   → 继承完成后仍为 None 的属性使用系统默认值
+```
+
+**理由：**
+- 明确的优先级避免歧义
+- parent 优先处理，确保覆盖逻辑正确
+- 不验证字体存在，依赖 PowerPoint 自动回退
+
+### 5. 表格字体配置
+
+**决策：使用 font 和 header_font 字段，提供完整字体配置**
+
+```python
+@dataclass
+class TableElement:
+    # 表格整体字体（应用于数据单元格）
+    font: FontConfig | str | None = None
+
+    # 表头字体（可选，未定义时继承 font）
+    header_font: FontConfig | str | None = None
+
+    # 表格样式（非字体相关，如背景色、边框等）
+    style: dict = field(default_factory=dict)
+```
+
+**字体解析优先级：**
+
+**数据单元格：**
+1. font（如果定义）
+2. fonts_default（如果 font 未定义）
+3. 系统 默认
+
+**表头单元格：**
+1. header_font（如果定义）
+2. font（如果 header_font 未定义）
+3. fonts_default（如果都未定义）
+4. 系统 默认
+
+**继承和覆盖：**
+- `header_font` 可以通过 `parent: "@font"` 继承表格字体，然后覆盖特定属性
+- `font` 和 `header_font` 都支持引用方式：整体引用 `font: "@body"` 或继承覆盖 `font: {parent: "@body", size: 14}`
+
+**示例：**
+
+```yaml
+# 示例1: 表格整体字体
+- type: table
+  font:
+    family: "Microsoft YaHei"
+    size: 14
+    color: "#333333"
+  # 表头和数据单元格都使用相同样式
+
+# 示例2: 表头使用不同样式
+- type: table
+  font:
+    family: "Microsoft YaHei"
+    size: 14
+  header_font:
+    parent: "@font"      # 继承表格字体
+    bold: true          # 覆盖：表头加粗
+    color: "#ffffff"    # 覆盖：表头白色
+  style:
+    header_bg: "#4a90e2"
+
+# 示例3: 引用字体主题
+- type: table
+  font: "@table-body"
+  header_font: "@table-header"
+
+# 示例4: 仅定义表头字体
+- type: table
+  header_font:
+    bold: true
+    color: "#ffffff"
+  # 数据单元格继承 fonts_default
+```
+
+**理由：**
+- 统一的字体配置方式，与文本元素保持一致
+- `header_font` 明确表示表头样式，语义清晰
+- 支持继承覆盖，避免重复配置
+- 移除 `style.font_size` 和 `style.header_color`，简化字段用途
+
+### 6. 字体解析器模块化
+
+**决策：创建独立的 FontResolver 类**
+
+```python
+class FontResolver:
+    def __init__(self, fonts: dict, fonts_default: Optional[str]):
+        self.fonts = fonts
+        self.default = fonts_default
+
+    def resolve(self, font_config: FontConfig | str | dict) -> ResolvedFont:
+        # 解析引用、继承、验证
+        pass
+
+    def resolve_family(self, family: str) -> str:
+        # 处理预设类别和字体名称
+        pass
+
+    def validate_font(self, family: str) -> bool:
+        # 检查字体可用性
+        pass
+```
+
+**理由：**
+- 集中字体解析逻辑，便于测试和维护
+- 解耦渲染器和字体验证逻辑
+- 便于单元测试各种引用场景
+
+### 7. 模板字体继承
+
+**决策：模板元素未定义 font 时继承 fonts_default**
+
+模板渲染流程中：
+1. 解析模板变量和条件渲染
+2. 对每个元素检查 font 字段
+3. 如果 font 未定义，将 fonts_default 的配置注入到元素 font 字段
+4. 传递给渲染器处理
+
+**理由：**
+- 保持模板简洁，不需要为每个元素定义 font
+- 允许通过 fonts_default 统一控制模板样式
+- 模板仍可以覆盖特定元素的字体
+
+## Risks / Trade-offs
+
+### Risk 1: 字体不存在时显示效果不符合预期
+
+**风险：** 用户指定了系统不存在的字体，PowerPoint 回退后显示效果与预期不符
+
+**缓解措施：**
+- 在文档中说明预设字体类别的推荐字体
+- 建议用户使用预设字体类别以提高跨平台兼容性
+- 可选：在转换日志中列出所有使用的字体名称供用户检查
+
+### Risk 2: 引用循环导致无限递归
+
+**风险：** fonts 配置中存在循环引用，如 `fonts.a.parent: "@b"` 且 `fonts.b.parent: "@a"`
+
+**决策：检测到引用循环直接抛出 ERROR**
+
+在解析过程中维护已访问的引用链，检测到重复引用时立即抛出 ERROR 并提示循环引用路径。例如：
+
+```
+ERROR: 检测到字体引用循环: fonts.title -> fonts.subtitle -> fonts.title
+```
+
+**缓解措施：**
+- 使用集合记录当前解析链中的引用名称
+- 限制最大引用深度（如 10 层），超出时也抛出 ERROR
+- 在错误信息中显示完整的引用路径，便于用户定位问题
+
+### Risk 3: 预设字体类别在不同平台表现不一致
+
+**风险：** 预设字体类别映射到特定字体名称，不同平台的可用字体不同
+
+**缓解措施：**
+- 选择跨平台通用性最高的字体（如 Arial、Times New Roman）
+- 在文档中说明各预设类别的推荐字体
+- 用户可以通过 fonts 定义自己的字体配置来覆盖预设行为
+
+### Risk 4: 旧 YAML 文件需要迁移
+
+**风险：** 使用旧语法的 YAML 文件需要更新才能使用新功能
+
+**缓解措施：**
+- 提供清晰的迁移文档和示例
+- 新语法更加直观和强大，值得迁移成本
+- 可以提供迁移脚本或工具辅助转换
+
+### Trade-off 1: 简洁性 vs 表达能力
+
+**权衡：** 三种引用方式增加学习成本，但提供更强大的复用能力
+
+**决策：** 优先表达能力，提供清晰的文档和示例
+
+### Trade-off 2: 字体验证 vs 简洁性
+
+**权衡：** 验证字体是否存在（增加复杂度）vs 直接设置字体名（依赖 PowerPoint 回退）
+
+**决策：** 不验证字体，直接设置字体名称。理由：
+- python-pptx 不验证字体，可以接受任意字符串
+- 字体不存在时 PowerPoint 会自动回退到系统默认字体
+- 避免引入额外依赖或复杂的平台检测代码
+- 用户可以在 PowerPoint 中查看最终效果
+
+## Migration Plan
+
+### 阶段 1: 数据结构更新
+1. 在 `core/elements.py` 中新增 `FontConfig` 数据类
+2. 更新 `TextElement` 和 `TableElement`，font 字段支持 FontConfig | str | dict
+3. 支持 dict 作为输入格式（在元素创建前转换为 FontConfig 对象）
+
+### 阶段 2: 解析器实现
+1. 创建 `utils/font_resolver.py`，实现 FontResolver 类
+2. 实现预设字体类别映射（sans → Arial 等）
+3. 实现字体引用解析逻辑（整体引用、继承覆盖、独立定义）
+4. 实现引用循环检测和错误提示
+
+### 阶段 3: 加载器集成
+1. 在 `loaders/yaml_loader.py` 中解析 metadata.fonts 和 metadata.fonts_default
+2. 将元素 font 字段从原始类型转换为 FontConfig 对象
+3. 将 metadata.fonts 字典转换为 FontConfig 对象字典
+
+### 阶段 4: 渲染器更新
+1. 更新 `renderers/pptx_renderer.py` 的 `_render_text()` 方法：
+   - 使用 FontResolver 解析 font 配置
+   - 应用扩展字体属性（underline、strikethrough、line_spacing 等）
+2. 更新 `_render_table()` 方法：
+   - 支持 font 和 header_font 字段
+   - 移除 style.font_size 和 style.header_color 的处理逻辑
+3. 实现段落属性（line_spacing、space_before、space_after）
+
+### 阶段 5: 模板集成
+1. 更新 `core/template.py`，模板渲染时注入 fonts_default
+2. 确保内联模板和外部模板都支持字体继承
+
+### 阶段 6: 测试和文档
+1. 新增单元测试覆盖字体解析、引用、继承逻辑
+2. 新增集成测试覆盖各种 YAML 语法
+3. 更新 README.md 和 README_DEV.md，说明预设字体类别
+4. 添加示例 YAML 文件展示字体主题系统用法
+
+## Open Questions
+
+1. **fonts_default 未定义时的行为：** 是否完全等同于当前行为，还是提供最小默认字体？
+   - 倾向：完全等同当前行为，font 未设置时使用 python-pptx 的默认字体
+
+2. **表格单元格级字体：** 是否需要支持不同行/列使用不同字体？
+   - 决策：不在当前范围，仅支持表头和数据单元格两种字体
+
+3. **预设字体类别扩展：** 是否允许用户自定义预设类别映射？
+   - 决策：不在当前范围，预设类别保持系统内置。用户可以通过 fonts 定义自己的字体配置
--- a/openspec/changes/archive/2026-03-05-font-theme-system/proposal.md
+++ b/openspec/changes/archive/2026-03-05-font-theme-system/proposal.md
@@ -0,0 +1,49 @@
+# 字体主题系统
+
+## Why
+
+当前系统仅支持基础的字体属性（size、bold、italic、color、align），用户无法指定字体族、使用预设字体类别、定义可复用的字体主题，也无法使用高级排版属性（如行距、下划线、上标/下标等）。这导致创建统一风格的演示文稿需要在每个元素上重复设置相同的字体属性，且无法利用系统预设的跨平台字体映射。
+
+## What Changes
+
+- **新增 metadata 字段**：`fonts` 定义可复用的字体配置，`fonts_default` 指定默认字体（可选，必须引用 fonts 中的某个配置；未设置时相当于当前不设置 font 属性的行为）
+- **新增预设字体类别**：sans、serif、mono、cjk-sans、cjk-serif 五种系统内置类别，自动映射到平台可用字体
+- **扩展字体属性**：新增 family（字体族）、underline、strikethrough、line_spacing、space_before、space_after、baseline、caps 等属性
+- **新增字体引用方式**：
+  - 整体引用：`font: "@title"` 完全使用 fonts.title 的配置
+  - 继承覆盖：`font: {parent: "@title", size: 60}` 继承后覆盖指定属性
+  - 独立定义：`font: {family: "SimSun", size: 24}` 完全自定义
+- **表格字体支持升级**：新增 font 和 header_font 字段，支持完整的字体配置，移除旧语法 style.font_size 和 style.header_color
+- **字体验证机制**：不存在的字体名称输出 WARNING 并回退到 fonts_default 或系统默认
+- **模板默认字体**：模板中未定义 font 的元素继承 metadata.fonts_default
+
+## Capabilities
+
+### New Capabilities
+- `font-theme`: 字体主题系统，支持 fonts 和 fonts_default 字段定义、三种引用方式（整体引用、继承覆盖、独立定义）、继承链解析
+- `font-preset`: 预设字体类别，提供 sans、serif、mono、cjk-sans、cjk-serif 五种系统内置字体类别，自动映射到平台可用字体
+- `font-extended`: 扩展字体属性，在现有 size/bold/italic/color/align 基础上新增 family、underline、strikethrough、line_spacing、space_before、space_after、baseline、caps 等属性
+
+### Modified Capabilities
+- `element-rendering`: 表格元素的字体渲染方式变更，新增 font 和 header_font 字段支持完整字体配置，移除旧语法 style.font_size 和 style.header_color
+
+## Impact
+
+**受影响的代码模块**：
+- `core/elements.py`：TextElement.font 字典扩展、TableElement 新增 font 和 header_font 字段、新增 FontConfig 数据类
+- `loaders/yaml_loader.py`：解析 metadata.fonts 和 metadata.fonts_default 字段
+- `core/template.py`：模板渲染时继承 fonts_default
+- `renderers/pptx_renderer.py`：_render_text() 方法支持扩展字体属性、_render_table() 方法支持新的字体字段
+- `validators/`：新增字体验证逻辑（预设类别映射、字体可用性检查）
+
+**API 变更**：
+- YAML metadata 新增 `fonts` 字段（可选）
+- YAML metadata 新增 `fonts_default` 字段（可选，未设置时使用系统默认字体）
+- 元素 font 字段支持字符串形式（整体引用）
+- 元素 font 字典新增 parent、family、underline、strikethrough、line_spacing、space_before、space_after、baseline、caps 属性
+- 表格元素新增 font 和 header_font 字段
+
+**依赖项**：
+- 继续使用 python-pptx，新增 font.name（字体名称）、font.underline（下划线）、paragraph.line_spacing（行距）、paragraph.space_before/space_after（段落间距）等属性
+- 需要实现跨平台字体映射表（Windows/macOS/Linux）
+- 需要实现字体可用性检测机制
--- a/openspec/changes/archive/2026-03-05-font-theme-system/specs/element-rendering/spec.md
+++ b/openspec/changes/archive/2026-03-05-font-theme-system/specs/element-rendering/spec.md
@@ -0,0 +1,67 @@
+# Element Rendering (Delta)
+
+## Purpose
+
+本增量规范更新表格元素的字体渲染方式，新增 font 和 header_font 字段支持完整字体配置，移除旧语法 style.font_size 和 style.header_color。
+
+## MODIFIED Requirements
+
+### Requirement: 系统必须支持表格元素渲染
+
+系统 SHALL 将 YAML 中定义的表格元素渲染为 PPTX 表格对象。表格元素支持 font 和 header_font 字段用于字体配置，style 字段仅用于非字体样式（如背景色）。
+
+#### Scenario: 渲染基本表格
+
+- **WHEN** 元素定义为 `{type: table, position: [1, 2], data: [["A", "B"], ["C", "D"]], col_widths: [2, 2]}`
+- **THEN** 系统在 (1, 2) 位置创建 2×2 表格，列宽各为 2 英寸
+
+#### Scenario: 表格定义整体字体
+
+- **WHEN** 表格定义 `font: {family: "Arial", size: 14, color: "#333333"}`
+- **THEN** 系统将数据单元格和表头都应用该字体样式
+
+#### Scenario: 表格定义表头字体
+
+- **WHEN** 表格定义 `header_font: {bold: true, color: "#ffffff"}`
+- **THEN** 系统将表头应用该字体样式，数据单元格继承 font 或使用默认字体
+
+#### Scenario: 表头字体继承表格字体
+
+- **WHEN** 表格定义 `font: {size: 14}` 且 `header_font: {parent: "@font", bold: true}`
+- **THEN** 表头继承 size: 14，覆盖 bold: true
+
+#### Scenario: 表格仅定义 header_font
+
+- **WHEN** 表格仅定义 `header_font: {bold: true}`
+- **THEN** 表头应用 bold: true，数据单元格使用 fonts_default 或系统默认字体
+
+#### Scenario: 表格定义背景样式
+
+- **WHEN** 表格定义 `style: {header_bg: "#4a90e2"}`
+- **THEN** 系统将表头背景色设置为 #4a90e2
+
+#### Scenario: 表格同时定义字体和背景样式
+
+- **WHEN** 表格定义 `font: {size: 14}` 和 `style: {header_bg: "#4a90e2"}`
+- **THEN** 系统同时应用字体样式和背景色
+
+#### Scenario: 表格数据为空时报错
+
+- **WHEN** 表格的 `data` 字段为空数组
+- **THEN** 系统抛出错误，提示表格数据不能为空
+
+#### Scenario: 表格列宽不匹配时报错
+
+- **WHEN** `col_widths` 数组长度与表格列数不一致
+- **THEN** 系统抛出错误，要求列宽数量与列数匹配
+
+## REMOVED Requirements
+
+### Requirement: 系统必须支持表格样式中的字体属性
+
+**Reason**: 被 font 和 header_font 字段取代，提供更完整和统一的字体配置方式
+
+**Migration**: 使用新的 font 和 header_font 字段替代 style.font_size 和 style.header_color
+
+- **FROM:** `style: {font_size: 14, header_color: "#ffffff"}`
+- **TO:** `font: {size: 14}, header_font: {color: "#ffffff"}`
--- a/openspec/changes/archive/2026-03-05-font-theme-system/specs/font-extended/spec.md
+++ b/openspec/changes/archive/2026-03-05-font-theme-system/specs/font-extended/spec.md
@@ -0,0 +1,207 @@
+# Font Extended
+
+## Purpose
+
+扩展字体属性在现有 size、bold、italic、color、align 基础上，新增 family、underline、strikethrough、line_spacing、space_before、space_after、baseline、caps 等属性，提供更完整的字体样式控制能力。
+
+## ADDED Requirements
+
+### Requirement: 元素 font 必须支持 family 属性
+
+font 字段 SHALL 支持 family 属性，用于指定字体族名称。
+
+#### Scenario: 设置字体族
+
+- **WHEN** 元素定义 font: {family: "Arial"}
+- **THEN** 系统将字体族设置为 Arial
+
+#### Scenario: family 字段为 None
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 family）
+- **THEN** 系统使用继承或默认的字体族
+
+### Requirement: 元素 font 必须支持 underline 属性
+
+font 字段 SHALL 支持 underline 属性，控制文本是否带下划线。
+
+#### Scenario: 启用下划线
+
+- **WHEN** 元素定义 font: {underline: true}
+- **THEN** 系统为文本添加下划线
+
+#### Scenario: 禁用下划线
+
+- **WHEN** 元素定义 font: {underline: false}
+- **THEN** 系统不为文本添加下划线
+
+#### Scenario: underline 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 underline）
+- **THEN** 系统使用继承或默认的下划线设置
+
+### Requirement: 元素 font 必须支持 strikethrough 属性
+
+font 字段 SHALL 支持 strikethrough 属性，控制文本是否带删除线。
+
+#### Scenario: 启用删除线
+
+- **WHEN** 元素定义 font: {strikethrough: true}
+- **THEN** 系统为文本添加删除线
+
+#### Scenario: 禁用删除线
+
+- **WHEN** 元素定义 font: {strikethrough: false}
+- **THEN** 系统不为文本添加删除线
+
+#### Scenario: strikethrough 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 strikethrough）
+- **THEN** 系统使用继承或默认的删除线设置
+
+### Requirement: 元素 font 必须支持 line_spacing 属性
+
+font 字段 SHALL 支持 line_spacing 属性，控制行距倍数。
+
+#### Scenario: 设置行距倍数
+
+- **WHEN** 元素定义 font: {line_spacing: 1.5}
+- **THEN** 系统将行距设置为 1.5 倍
+
+#### Scenario: line_spacing 为 1.0
+
+- **WHEN** 元素定义 font: {line_spacing: 1.0}
+- **THEN** 系统使用单倍行距
+
+#### Scenario: line_spacing 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 line_spacing）
+- **THEN** 系统使用继承或默认的行距设置
+
+### Requirement: 元素 font 必须支持 space_before 属性
+
+font 字段 SHALL 支持 space_before 属性，控制段前间距（单位：磅）。
+
+#### Scenario: 设置段前间距
+
+- **WHEN** 元素定义 font: {space_before: 12}
+- **THEN** 系统将段前间距设置为 12 磅
+
+#### Scenario: space_before 为 0
+
+- **WHEN** 元素定义 font: {space_before: 0}
+- **THEN** 系统不添加段前间距
+
+#### Scenario: space_before 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 space_before）
+- **THEN** 系统使用继承或默认的段前间距
+
+### Requirement: 元素 font 必须支持 space_after 属性
+
+font 字段 SHALL 支持 space_after 属性，控制段后间距（单位：磅）。
+
+#### Scenario: 设置段后间距
+
+- **WHEN** 元素定义 font: {space_after: 12}
+- **THEN** 系统将段后间距设置为 12 磅
+
+#### Scenario: space_after 为 0
+
+- **WHEN** 元素定义 font: {space_after: 0}
+- **THEN** 系统不添加段后间距
+
+#### Scenario: space_after 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 space_after）
+- **THEN** 系统使用继承或默认的段后间距
+
+### Requirement: 元素 font 必须支持 baseline 属性
+
+font 字段 SHALL 支持 baseline 属性，控制文本基线位置（normal、superscript、subscript）。
+
+#### Scenario: 设置为上标
+
+- **WHEN** 元素定义 font: {baseline: "superscript"}
+- **THEN** 系统将文本设置为上标
+
+#### Scenario: 设置为下标
+
+- **WHEN** 元素定义 font: {baseline: "subscript"}
+- **THEN** 系统将文本设置为下标
+
+#### Scenario: 设置为正常基线
+
+- **WHEN** 元素定义 font: {baseline: "normal"}
+- **THEN** 系统使用正常基线位置
+
+#### Scenario: baseline 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 baseline）
+- **THEN** 系统使用正常基线位置
+
+#### Scenario: baseline 值无效
+
+- **WHEN** 元素定义 font: {baseline: "invalid"}
+- **THEN** 系统抛出 ERROR，提示 baseline 必须是 normal、superscript 或 subscript
+
+### Requirement: 元素 font 必须支持 caps 属性
+
+font 字段 SHALL 支持 caps 属性，控制文本大小写转换（normal、allcaps、smallcaps）。
+
+#### Scenario: 设置为全大写
+
+- **WHEN** 元素定义 font: {caps: "allcaps"}
+- **THEN** 系统将文本转换为大写
+
+#### Scenario: 设置为小型大写
+
+- **WHEN** 元素定义 font: {caps: "smallcaps"}
+- **THEN** 系统将文本转换为小型大写字母
+
+#### Scenario: 设置为正常大小写
+
+- **WHEN** 元素定义 font: {caps: "normal"}
+- **THEN** 系统保持文本原始大小写
+
+#### Scenario: caps 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 caps）
+- **THEN** 系统保持文本原始大小写
+
+#### Scenario: caps 值无效
+
+- **WHEN** 元素定义 font: {caps: "invalid"}
+- **THEN** 系统抛出 ERROR，提示 caps 必须是 normal、allcaps 或 smallcaps
+
+### Requirement: 多行文本必须将所有属性应用到每个段落
+
+当文本内容包含换行符时，系统 SHALL 将所有字体属性（包括扩展属性）应用到文本框中的每个段落。
+
+#### Scenario: 多行文本应用扩展属性
+
+- **WHEN** 文本内容包含换行符且定义 font: {size: 12, underline: true, line_spacing: 1.5}
+- **THEN** 系统将所有属性（size、underline、line_spacing）应用到所有段落
+
+#### Scenario: 多行文本每个段落样式一致
+
+- **WHEN** 文本包含多个换行符且定义了 font 属性
+- **THEN** 每个段落的字体样式都应一致
+
+### Requirement: 扩展属性必须支持继承机制
+
+扩展属性 SHALL 遵循与基础属性相同的继承机制：parent → 当前定义 → fonts_default → 系统默认。
+
+#### Scenario: 扩展属性从 parent 继承
+
+- **WHEN** parent 定义 underline: true，当前定义未指定 underline
+- **THEN** 元素使用 underline: true（从 parent 继承）
+
+#### Scenario: 扩展属性从 fonts_default 继承
+
+- **WHEN** fonts_default 定义 line_spacing: 1.5，元素未指定 line_spacing
+- **THEN** 元素使用 line_spacing: 1.5（从 fonts_default 继承）
+
+#### Scenario: 当前定义覆盖继承的扩展属性
+
+- **WHEN** parent 定义 space_before: 12，当前定义 space_before: 24
+- **THEN** 元素使用 space_before: 24（当前定义覆盖）
--- a/openspec/changes/archive/2026-03-05-font-theme-system/specs/font-preset/spec.md
+++ b/openspec/changes/archive/2026-03-05-font-theme-system/specs/font-preset/spec.md
@@ -0,0 +1,117 @@
+# Font Preset
+
+## Purpose
+
+预设字体类别提供系统内置的字体类别名称，用户可以直接使用这些类别名称引用推荐的字体，无需指定具体字体名称。系统将预设类别映射到跨平台通用的推荐字体。
+
+## ADDED Requirements
+
+### Requirement: 系统必须支持五种预设字体类别
+
+系统 SHALL 支持以下预设字体类别：sans、serif、mono、cjk-sans、cjk-serif。
+
+#### Scenario: 使用 sans 类别
+
+- **WHEN** 元素定义 font: {family: "sans"}
+- **THEN** 系统使用 "Arial" 作为字体族
+
+#### Scenario: 使用 serif 类别
+
+- **WHEN** 元素定义 font: {family: "serif"}
+- **THEN** 系统使用 "Times New Roman" 作为字体族
+
+#### Scenario: 使用 mono 类别
+
+- **WHEN** 元素定义 font: {family: "mono"}
+- **THEN** 系统使用 "Courier New" 作为字体族
+
+#### Scenario: 使用 cjk-sans 类别
+
+- **WHEN** 元素定义 font: {family: "cjk-sans"}
+- **THEN** 系统使用 "Microsoft YaHei" 作为字体族
+
+#### Scenario: 使用 cjk-serif 类别
+
+- **WHEN** 元素定义 font: {family: "cjk-serif"}
+- **THEN** 系统使用 "SimSun" 作为字体族
+
+### Requirement: 预设类别映射必须使用跨平台通用字体
+
+预设字体类别 SHALL 映射到跨平台通用性最高的字体，确保在不同操作系统上都有较好的显示效果。
+
+#### Scenario: sans 类别映射到 Arial
+
+- **WHEN** 系统解析 family: "sans"
+- **THEN** 映射到 "Arial"（Windows/macOS/Linux 通用）
+
+#### Scenario: serif 类别映射到 Times New Roman
+
+- **WHEN** 系统解析 family: "serif"
+- **THEN** 映射到 "Times New Roman"（Windows/macOS/Linux 通用）
+
+#### Scenario: mono 类别映射到 Courier New
+
+- **WHEN** 系统解析 family: "mono"
+- **THEN** 映射到 "Courier New"（Windows/macOS/Linux 通用）
+
+#### Scenario: cjk-sans 类别映射到微软雅黑
+
+- **WHEN** 系统解析 family: "cjk-sans"
+- **THEN** 映射到 "Microsoft YaHei"（Windows 常用中文字体）
+
+#### Scenario: cjk-serif 类别映射到宋体
+
+- **WHEN** 系统解析 family: "cjk-serif"
+- **THEN** 映射到 "SimSun"（Windows 常用中文字体）
+
+### Requirement: 预设类别必须在 family 字段中识别
+
+系统 SHALL 仅在 font 或 header_font 的 family 字段中识别预设类别名称。
+
+#### Scenario: family 字段使用预设类别
+
+- **WHEN** 元素定义 font: {family: "sans"}
+- **THEN** 系统识别 "sans" 为预设类别，映射到 "Arial"
+
+#### Scenario: 其他字段不解析预设类别
+
+- **WHEN** 元素定义 font: {size: "sans"}
+- **THEN** 系统将 "sans" 作为字符串值，不进行预设类别映射
+
+#### Scenario: 直接使用字体名称
+
+- **WHEN** 元素定义 font: {family: "SimSun"}
+- **THEN** 系统使用 "SimSun" 作为字体族，不进行预设类别映射
+
+### Requirement: 预设类别不进行字体验证
+
+系统 SHALL 不验证预设类别映射的字体是否在系统中存在。
+
+#### Scenario: 预设类别字体不存在时行为
+
+- **WHEN** 系统中不存在 Arial 字体
+- **THEN** 系统仍将 "sans" 映射到 "Arial"，不报错
+
+#### Scenario: PowerPoint 处理字体回退
+
+- **WHEN** PowerPoint 打开包含不存在字体的 PPTX 文件
+- **THEN** PowerPoint 自动回退到系统默认字体
+
+### Requirement: 预设类别可以与 fonts 配置结合使用
+
+用户可以在 fonts 配置中使用预设类别，也可以在元素 font 中直接使用。
+
+#### Scenario: fonts 配置中使用预设类别
+
+- **WHEN** metadata 定义 fonts: {body: {family: "sans", size: 18}}
+- **THEN** 系统将 family: "sans" 解析为 "Arial"
+
+#### Scenario: 元素直接使用预设类别
+
+- **WHEN** 元素定义 font: {family: "cjk-sans", size: 24}
+- **THEN** 系统将 family: "cjk-sans" 解析为 "Microsoft YaHei"
+
+#### Scenario: 预设类别与引用结合
+
+- **WHEN** fonts.title 定义 family: "sans"，元素定义 font: "@title"
+- **THEN** 元素使用 family: "Arial"（通过 title 配置）
--- a/openspec/changes/archive/2026-03-05-font-theme-system/specs/font-theme/spec.md
+++ b/openspec/changes/archive/2026-03-05-font-theme-system/specs/font-theme/spec.md
@@ -0,0 +1,207 @@
+# Font Theme
+
+## Purpose
+
+字体主题系统提供可复用的字体配置管理能力，允许用户在 metadata 中定义字体配置模板，通过引用方式应用到元素，实现统一的字体样式管理。
+
+## ADDED Requirements
+
+### Requirement: 系统必须支持在 metadata 中定义 fonts 字段
+
+系统 SHALL 支持在 YAML metadata 中定义 fonts 字段，用于存储可复用的字体配置。
+
+#### Scenario: 定义 fonts 字段
+
+- **WHEN** metadata 中定义 fonts 字段
+- **THEN** 系统成功解析并存储字体配置字典
+
+#### Scenario: fonts 字段为空字典
+
+- **WHEN** metadata 中定义 fonts: {}
+- **THEN** 系统接受空的字体配置字典
+
+#### Scenario: fonts 字段未定义
+
+- **WHEN** metadata 中未定义 fonts 字段
+- **THEN** 系统正常处理，fonts 为空字典
+
+### Requirement: fonts 字段必须包含命名字体配置
+
+fonts 字段 SHALL 包含一个或多个命名字体配置，每个配置是一个字体属性字典。
+
+#### Scenario: 定义单个字体配置
+
+- **WHEN** fonts 中定义 title: {family: "Arial", size: 44, bold: true}
+- **THEN** 系统创建名为 title 的字体配置
+
+#### Scenario: 定义多个字体配置
+
+- **WHEN** fonts 中定义 title、subtitle、body 等多个配置
+- **THEN** 系统为每个配置创建独立的字体对象
+
+### Requirement: 系统必须支持 fonts_default 字段
+
+系统 SHALL 支持在 metadata 中定义可选的 fonts_default 字段，指定默认字体配置的引用。
+
+#### Scenario: 定义 fonts_default 引用
+
+- **WHEN** metadata 中定义 fonts_default: "@body"
+- **THEN** 系统将 fonts_default 解析为对 fonts.body 的引用
+
+#### Scenario: fonts_default 未定义
+
+- **WHEN** metadata 中未定义 fonts_default 字段
+- **THEN** 系统使用 python-pptx 的默认字体
+
+#### Scenario: fonts_default 引用不存在的配置
+
+- **WHEN** fonts_default: "@undefined" 且 fonts.undefined 不存在
+- **THEN** 系统抛出 ERROR，提示引用的字体配置不存在
+
+#### Scenario: fonts_default 必须引用 fonts 中的配置
+
+- **WHEN** fonts_default: "Arial"（直接字体名称）
+- **THEN** 系统抛出 ERROR，提示 fonts_default 必须是引用格式
+
+### Requirement: 元素 font 字段必须支持三种引用方式
+
+元素 font 字段 SHALL 支持字符串引用（整体引用）、字典引用（继承覆盖或独立定义）两种形式。
+
+#### Scenario: 字符串整体引用
+
+- **WHEN** 元素定义 font: "@title"
+- **THEN** 系统使用 fonts.title 的所有属性
+
+#### Scenario: 字典继承覆盖
+
+- **WHEN** 元素定义 font: {parent: "@title", size: 60}
+- **THEN** 系统继承 fonts.title 的所有属性，覆盖 size 为 60
+
+#### Scenario: 字典独立定义
+
+- **WHEN** 元素定义 font: {family: "SimSun", size: 24}
+- **THEN** 系统使用定义的属性，未定义的属性继承 fonts_default
+
+#### Scenario: font 字段未定义
+
+- **WHEN** 元素未定义 font 字段
+- **THEN** 元素使用 fonts_default 或系统默认字体
+
+### Requirement: parent 字段必须引用 fonts 中的配置
+
+font 字典中的 parent 字段 SHALL 引用 fonts 中已定义的配置名称。
+
+#### Scenario: parent 引用存在的配置
+
+- **WHEN** parent: "@title" 且 fonts.title 存在
+- **THEN** 系统成功继承 fonts.title 的属性
+
+#### Scenario: parent 引用不存在的配置
+
+- **WHEN** parent: "@undefined" 且 fonts.undefined 不存在
+- **THEN** 系统抛出 ERROR，提示引用的字体配置不存在
+
+#### Scenario: parent 必须是引用格式
+
+- **WHEN** parent: "Arial"（直接字体名称）
+- **THEN** 系统抛出 ERROR，提示 parent 必须是引用格式
+
+### Requirement: 系统必须检测并拒绝引用循环
+
+系统 SHALL 在解析字体引用时检测循环引用，检测到循环时抛出 ERROR。
+
+#### Scenario: 直接循环引用
+
+- **WHEN** fonts.title.parent: "@title"（引用自身）
+- **THEN** 系统抛出 ERROR，提示检测到自引用
+
+#### Scenario: 间接循环引用
+
+- **WHEN** fonts.a.parent: "@b" 且 fonts.b.parent: "@a"
+- **THEN** 系统抛出 ERROR，显示完整的引用循环路径
+
+#### Scenario: 深层循环引用
+
+- **WHEN** 引用链深度超过 10 层
+- **THEN** 系统抛出 ERROR，提示引用深度超限
+
+#### Scenario: 错误信息包含引用路径
+
+- **WHEN** 系统检测到循环引用
+- **THEN** 错误信息包含完整的引用路径，如 "fonts.title -> fonts.subtitle -> fonts.title"
+
+### Requirement: 系统必须支持属性继承链
+
+字体属性解析 SHALL 按照优先级顺序继承：parent → 当前定义 → fonts_default → 系统默认。
+
+#### Scenario: parent 定义了基础属性
+
+- **WHEN** fonts.title 定义 size: 44，元素定义 font: {parent: "@title", bold: true}
+- **THEN** 元素使用 size: 44（继承）、bold: true（覆盖）
+
+#### Scenario: parent 未定义的属性继承 fonts_default
+
+- **WHEN** fonts_default 定义 size: 18，元素定义 font: {parent: "@title"} 且 title 未定义 size
+- **THEN** 元素使用 size: 18（从 fonts_default 继承）
+
+#### Scenario: 当前定义覆盖 parent
+
+- **WHEN** parent 定义 size: 44，当前定义 size: 60
+- **THEN** 元素使用 size: 60（当前定义覆盖 parent）
+
+### Requirement: 模板元素必须支持继承 fonts_default
+
+模板中未定义 font 的元素 SHALL 继承 metadata.fonts_default 配置。
+
+#### Scenario: 模板元素未定义 font
+
+- **WHEN** 模板元素未定义 font 字段
+- **THEN** 元素继承 metadata.fonts_default 的配置
+
+#### Scenario: 模板元素定义了 font
+
+- **WHEN** 模板元素定义 font: "@title"
+- **THEN** 元素使用 font: "@title"，不继承 fonts_default
+
+#### Scenario: fonts_default 未定义时模板元素行为
+
+- **WHEN** 模板元素未定义 font 且 metadata 未定义 fonts_default
+- **THEN** 元素使用系统默认字体
+
+### Requirement: 表格元素必须支持 font 和 header_font 字段
+
+表格元素 SHALL 支持 font 和 header_font 字段，分别控制数据单元格和表头的字体样式。
+
+#### Scenario: 表格定义整体字体
+
+- **WHEN** 表格定义 font: {family: "Arial", size: 14}
+- **THEN** 数据单元格和表头都应用该字体（表头可被 header_font 覆盖）
+
+#### Scenario: 表格定义表头字体
+
+- **WHEN** 表格定义 header_font: {bold: true, color: "#ffffff"}
+- **THEN** 表头应用该字体，数据单元格继承 font 或 fonts_default
+
+#### Scenario: 表头字体继承表格字体
+
+- **WHEN** 表格定义 font: {size: 14} 且 header_font: {parent: "@font", bold: true}
+- **THEN** 表头继承 size: 14，覆盖 bold: true
+
+#### Scenario: 表格仅定义 header_font
+
+- **WHEN** 表格仅定义 header_font: {bold: true}
+- **THEN** 表头应用 bold: true，数据单元格继承 fonts_default
+
+### Requirement: 系统必须移除旧的表格字体语法
+
+系统 SHALL 移除 style.font_size 和 style.header_color 字段的处理逻辑。
+
+#### Scenario: 旧语法字段不再生效
+
+- **WHEN** 表格定义 style: {font_size: 14, header_color: "#fff"}
+- **THEN** 系统忽略这些字段，使用 font 和 header_font 替代
+
+#### Scenario: style 字段保留用于非字体属性
+
+- **WHEN** 表格定义 style: {header_bg: "#4a90e2"}
+- **THEN** 系统正常处理背景色等非字体属性
--- a/openspec/changes/archive/2026-03-05-font-theme-system/tasks.md
+++ b/openspec/changes/archive/2026-03-05-font-theme-system/tasks.md
@@ -0,0 +1,115 @@
+# 字体主题系统实现任务清单
+
+## 1. 数据结构更新
+
+- [x] 1.1 在 core/elements.py 中新增 FontConfig 数据类，定义所有字体属性（parent、family、size、bold、italic、underline、strikethrough、color、align、line_spacing、space_before、space_after、baseline、caps）
+- [x] 1.2 更新 TextElement.font 字段类型注解，支持 FontConfig | str | dict 类型
+- [x] 1.3 在 TableElement 中新增 font 字段（FontConfig | str | None）
+- [x] 1.4 在 TableElement 中新增 header_font 字段（FontConfig | str | None）
+- [x] 1.5 为 FontConfig 添加 __post_init__ 验证方法（baseline 和 caps 枚举值验证）
+
+## 2. 解析器实现
+
+- [x] 2.1 创建 utils/font_resolver.py 模块
+- [x] 2.2 实现 FontResolver 类，接受 fonts 和 fonts_default 参数
+- [x] 2.3 实现预设字体类别映射常量（sans → Arial, serif → Times New Roman, mono → Courier New, cjk-sans → Microsoft YaHei, cjk-serif → SimSun）
+- [x] 2.4 实现 resolve_font() 方法，处理字符串引用（整体引用 "@xxx"）
+- [x] 2.5 实现 resolve_font_dict() 方法，处理字典形式（parent、family、其他属性）
+- [x] 2.6 实现引用循环检测逻辑（维护已访问集合，检测重复引用）
+- [x] 2.7 实现属性继承链逻辑（parent → 当前 → fonts_default → 系统默认）
+- [x] 2.8 实现预设类别解析（识别 family 字段中的预设类别名称）
+
+## 3. 加载器集成
+
+- [x] 3.1 在 loaders/yaml_loader.py 中添加解析 metadata.fonts 的逻辑
+- [x] 3.2 在 loaders/yaml_loader.py 中添加解析 metadata.fonts_default 的逻辑
+- [x] 3.3 验证 fonts_default 必须是引用格式（@xxx），直接字体名称抛出 ERROR
+- [x] 3.4 验证 fonts_default 引用的配置必须存在于 fonts 中
+- [x] 3.5 实现元素 font 字段转换逻辑（字符串/字典 → FontConfig 对象）
+- [x] 3.6 实现表格 font 和 header_font 字段转换逻辑
+
+## 4. 渲染器更新
+
+- [x] 4.1 在 renderers/pptx_renderer.py 中导入 FontResolver
+- [x] 4.2 在 PptxGenerator.__init__ 中初始化 FontResolver 实例
+- [x] 4.3 更新 _render_text() 方法，使用 FontResolver 解析 font 配置
+- [x] 4.4 在 _render_text() 中应用 font.family 属性
+- [x] 4.5 在 _render_text() 中应用 font.underline 属性
+- [x] 4.6 在 _render_text() 中应用 font.strikethrough 属性
+- [x] 4.7 在 _render_text() 中应用 paragraph.line_spacing 属性
+- [x] 4.8 在 _render_text() 中应用 paragraph.space_before 属性
+- [x] 4.9 在 _render_text() 中应用 paragraph.space_after 属性
+- [x] 4.10 在 _render_text() 中处理多行文本的扩展属性应用
+- [x] 4.11 更新 _render_table() 方法，支持 font 字段
+- [x] 4.12 更新 _render_table() 方法，支持 header_font 字段
+- [x] 4.13 实现 header_font 继承 font 的逻辑
+- [x] 4.14 在 _render_table() 中移除 style.font_size 和 style.header_color 的处理
+
+## 5. 模板集成
+
+- [x] 5.1 在 core/template.py 的 render() 方法中获取 metadata.fonts_default
+- [x] 5.2 在模板元素渲染前，为未定义 font 的元素注入 fonts_default
+- [x] 5.3 确保内联模板支持字体继承
+- [x] 5.4 确保外部模板支持字体继承
+
+## 6. 测试
+
+### 6.1 移除旧语法相关测试
+
+- [x] 6.1.1 移除 test_pptx_renderer.py 中的 test_render_table 测试（使用旧语法 style.font_size）
+- [x] 6.1.2 移除 test_pptx_renderer.py 中的 test_render_table_with_header_style 测试（使用旧语法 style.font_size 和 style.header_color）
+- [x] 6.1.3 更新 test_render_table_col_widths_mismatch 测试，移除 style={} 参数
+
+### 6.2 添加新语法相关测试
+
+- [x] 6.2.1 添加 FontConfig 数据类的单元测试
+- [x] 6.2.2 添加预设字体类别映射的单元测试
+- [x] 6.2.3 添加整体引用功能（font: "@xxx"）的单元测试
+- [x] 6.2.4 添加继承覆盖功能（font: {parent: "@xxx"}）的单元测试
+- [x] 6.2.5 添加引用循环检测的单元测试
+- [x] 6.2.6 添加属性继承链的单元测试
+- [x] 6.2.7 添加表格 font 字段的单元测试
+- [x] 6.2.8 添加表格 header_font 字段的单元测试
+- [x] 6.2.9 添加表格 header_font 继承 font 的单元测试
+- [x] 6.2.10 添加扩展字体属性（family、underline、strikethrough）的单元测试
+- [x] 6.2.11 添加段落属性（line_spacing、space_before、space_after）的单元测试
+- [x] 6.2.12 添加 baseline 和 caps 属性的单元测试
+- [x] 6.2.13 添加 baseline 和 caps 枚举值验证的单元测试
+- [x] 6.2.14 添加多行文本扩展属性应用的集成测试
+- [x] 6.2.15 添加模板字体继承的集成测试
+- [x] 6.2.16 添加引用循环错误的集成测试
+- [x] 6.2.17 添加预设字体类别解析的集成测试
+
+### 6.3 更新现有测试以支持新语法
+
+- [x] 6.3.1 更新 test_render_text 测试，验证扩展字体属性应用
+- [x] 6.3.2 更新 test_render_multiline_text 测试，验证扩展属性应用到所有段落
+
+## 7. 文档
+
+- [x] 7.1 更新 README.md，添加字体主题系统使用说明
+- [x] 7.2 更新 README.md，说明预设字体类别（sans、serif、mono、cjk-sans、cjk-serif）
+- [x] 7.3 更新 README.md，添加表格 font 和 header_font 字段说明
+- [x] 7.4 更新 README.md，说明扩展字体属性（underline、strikethrough、line_spacing 等）
+- [x] 7.5 更新 README_DEV.md，添加 FontConfig 和 FontResolver 的开发文档
+- [x] 7.6 更新 README_DEV.md，说明字体引用解析逻辑
+- [x] 7.7 在 tests/fixtures/yaml_samples/ 下添加字体主题系统示例 YAML 文件
+- [x] 7.8 在 tests/fixtures/yaml_samples/ 下添加预设字体类别示例 YAML 文件
+- [x] 7.9 在 tests/fixtures/yaml_samples/ 下添加表格字体配置示例 YAML 文件
+- [x] 7.10 在 tests/fixtures/yaml_samples/ 下添加扩展字体属性示例 YAML 文件
+- [x] 7.11 更新测试文档，说明移除旧语法测试的原因和新增测试的内容
+
+## 8. 验证
+
+- [x] 8.1 运行单元测试，确保所有测试通过
+- [ ] 8.2 手动测试预设字体类别显示效果
+- [ ] 8.3 手动测试字体继承链功能
+- [ ] 8.4 手动测试引用循环错误提示
+- [ ] 8.5 手动测试表格新字体字段（font 和 header_font）
+- [ ] 8.6 手动测试表格 header_font 继承 font 的功能
+- [ ] 8.7 手动测试扩展字体属性（underline、strikethrough、line_spacing 等）
+- [ ] 8.8 手动测试多行文本扩展属性应用
+- [ ] 8.9 手动测试模板字体继承
+- [ ] 8.10 生成示例 PPTX 文件并在 PowerPoint 中验证显示效果
+- [ ] 8.11 验证旧语法（style.font_size、style.header_color）不再生效
+- [ ] 8.12 验证新语法（font、header_font）正确工作
--- a/openspec/specs/element-rendering/spec.md
+++ b/openspec/specs/element-rendering/spec.md
@@ -111,17 +111,42 @@ Element rendering系统负责将 YAML 中定义的各类元素（文本、图片

 ### Requirement: 系统必须支持表格元素渲染

-系统 SHALL 将 YAML 中定义的表格元素渲染为 PPTX 表格对象。
+系统 SHALL 将 YAML 中定义的表格元素渲染为 PPTX 表格对象。表格元素支持 font 和 header_font 字段用于字体配置，style 字段仅用于非字体样式（如背景色）。

 #### Scenario: 渲染基本表格

 - **WHEN** 元素定义为 `{type: table, position: [1, 2], data: [["A", "B"], ["C", "D"]], col_widths: [2, 2]}`
 - **THEN** 系统在 (1, 2) 位置创建 2×2 表格，列宽各为 2 英寸

-#### Scenario: 应用表格样式
+#### Scenario: 表格定义整体字体

- **WHEN** 表格定义了 `style: {font_size: 14, header_bg: "#4a90e2", header_color: "#ffffff"}`
- **THEN** 系统将第一行设置为表头样式，背景色为 #4a90e2，文字颜色为白色
+- **WHEN** 表格定义 `font: {family: "Arial", size: 14, color: "#333333"}`
+- **THEN** 系统将数据单元格和表头都应用该字体样式
+
+#### Scenario: 表格定义表头字体
+
+- **WHEN** 表格定义 `header_font: {bold: true, color: "#ffffff"}`
+- **THEN** 系统将表头应用该字体样式，数据单元格继承 font 或使用默认字体
+
+#### Scenario: 表头字体继承表格字体
+
+- **WHEN** 表格定义 `font: {size: 14}` 且 `header_font: {parent: "@font", bold: true}`
+- **THEN** 表头继承 size: 14，覆盖 bold: true
+
+#### Scenario: 表格仅定义 header_font
+
+- **WHEN** 表格仅定义 `header_font: {bold: true}`
+- **THEN** 表头应用 bold: true，数据单元格使用 fonts_default 或系统默认字体
+
+#### Scenario: 表格定义背景样式
+
+- **WHEN** 表格定义 `style: {header_bg: "#4a90e2"}`
+- **THEN** 系统将表头背景色设置为 #4a90e2
+
+#### Scenario: 表格同时定义字体和背景样式
+
+- **WHEN** 表格定义 `font: {size: 14}` 和 `style: {header_bg: "#4a90e2"}`
+- **THEN** 系统同时应用字体样式和背景色

 #### Scenario: 表格数据为空时报错

--- a/openspec/specs/font-extended/spec.md
+++ b/openspec/specs/font-extended/spec.md
@@ -0,0 +1,207 @@
+# Font Extended
+
+## Purpose
+
+扩展字体属性在现有 size、bold、italic、color、align 基础上，新增 family、underline、strikethrough、line_spacing、space_before、space_after、baseline、caps 等属性，提供更完整的字体样式控制能力。
+
+## Requirements
+
+### Requirement: 元素 font 必须支持 family 属性
+
+font 字段 SHALL 支持 family 属性，用于指定字体族名称。
+
+#### Scenario: 设置字体族
+
+- **WHEN** 元素定义 font: {family: "Arial"}
+- **THEN** 系统将字体族设置为 Arial
+
+#### Scenario: family 字段为 None
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 family）
+- **THEN** 系统使用继承或默认的字体族
+
+### Requirement: 元素 font 必须支持 underline 属性
+
+font 字段 SHALL 支持 underline 属性，控制文本是否带下划线。
+
+#### Scenario: 启用下划线
+
+- **WHEN** 元素定义 font: {underline: true}
+- **THEN** 系统为文本添加下划线
+
+#### Scenario: 禁用下划线
+
+- **WHEN** 元素定义 font: {underline: false}
+- **THEN** 系统不为文本添加下划线
+
+#### Scenario: underline 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 underline）
+- **THEN** 系统使用继承或默认的下划线设置
+
+### Requirement: 元素 font 必须支持 strikethrough 属性
+
+font 字段 SHALL 支持 strikethrough 属性，控制文本是否带删除线。
+
+#### Scenario: 启用删除线
+
+- **WHEN** 元素定义 font: {strikethrough: true}
+- **THEN** 系统为文本添加删除线
+
+#### Scenario: 禁用删除线
+
+- **WHEN** 元素定义 font: {strikethrough: false}
+- **THEN** 系统不为文本添加删除线
+
+#### Scenario: strikethrough 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 strikethrough）
+- **THEN** 系统使用继承或默认的删除线设置
+
+### Requirement: 元素 font 必须支持 line_spacing 属性
+
+font 字段 SHALL 支持 line_spacing 属性，控制行距倍数。
+
+#### Scenario: 设置行距倍数
+
+- **WHEN** 元素定义 font: {line_spacing: 1.5}
+- **THEN** 系统将行距设置为 1.5 倍
+
+#### Scenario: line_spacing 为 1.0
+
+- **WHEN** 元素定义 font: {line_spacing: 1.0}
+- **THEN** 系统使用单倍行距
+
+#### Scenario: line_spacing 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 line_spacing）
+- **THEN** 系统使用继承或默认的行距设置
+
+### Requirement: 元素 font 必须支持 space_before 属性
+
+font 字段 SHALL 支持 space_before 属性，控制段前间距（单位：磅）。
+
+#### Scenario: 设置段前间距
+
+- **WHEN** 元素定义 font: {space_before: 12}
+- **THEN** 系统将段前间距设置为 12 磅
+
+#### Scenario: space_before 为 0
+
+- **WHEN** 元素定义 font: {space_before: 0}
+- **THEN** 系统不添加段前间距
+
+#### Scenario: space_before 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 space_before）
+- **THEN** 系统使用继承或默认的段前间距
+
+### Requirement: 元素 font 必须支持 space_after 属性
+
+font 字段 SHALL 支持 space_after 属性，控制段后间距（单位：磅）。
+
+#### Scenario: 设置段后间距
+
+- **WHEN** 元素定义 font: {space_after: 12}
+- **THEN** 系统将段后间距设置为 12 磅
+
+#### Scenario: space_after 为 0
+
+- **WHEN** 元素定义 font: {space_after: 0}
+- **THEN** 系统不添加段后间距
+
+#### Scenario: space_after 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 space_after）
+- **THEN** 系统使用继承或默认的段后间距
+
+### Requirement: 元素 font 必须支持 baseline 属性
+
+font 字段 SHALL 支持 baseline 属性，控制文本基线位置（normal、superscript、subscript）。
+
+#### Scenario: 设置为上标
+
+- **WHEN** 元素定义 font: {baseline: "superscript"}
+- **THEN** 系统将文本设置为上标
+
+#### Scenario: 设置为下标
+
+- **WHEN** 元素定义 font: {baseline: "subscript"}
+- **THEN** 系统将文本设置为下标
+
+#### Scenario: 设置为正常基线
+
+- **WHEN** 元素定义 font: {baseline: "normal"}
+- **THEN** 系统使用正常基线位置
+
+#### Scenario: baseline 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 baseline）
+- **THEN** 系统使用正常基线位置
+
+#### Scenario: baseline 值无效
+
+- **WHEN** 元素定义 font: {baseline: "invalid"}
+- **THEN** 系统抛出 ERROR，提示 baseline 必须是 normal、superscript 或 subscript
+
+### Requirement: 元素 font 必须支持 caps 属性
+
+font 字段 SHALL 支持 caps 属性，控制文本大小写转换（normal、allcaps、smallcaps）。
+
+#### Scenario: 设置为全大写
+
+- **WHEN** 元素定义 font: {caps: "allcaps"}
+- **THEN** 系统将文本转换为大写
+
+#### Scenario: 设置为小型大写
+
+- **WHEN** 元素定义 font: {caps: "smallcaps"}
+- **THEN** 系统将文本转换为小型大写字母
+
+#### Scenario: 设置为正常大小写
+
+- **WHEN** 元素定义 font: {caps: "normal"}
+- **THEN** 系统保持文本原始大小写
+
+#### Scenario: caps 未定义
+
+- **WHEN** 元素定义 font: {size: 18}（未定义 caps）
+- **THEN** 系统保持文本原始大小写
+
+#### Scenario: caps 值无效
+
+- **WHEN** 元素定义 font: {caps: "invalid"}
+- **THEN** 系统抛出 ERROR，提示 caps 必须是 normal、allcaps 或 smallcaps
+
+### Requirement: 多行文本必须将所有属性应用到每个段落
+
+当文本内容包含换行符时，系统 SHALL 将所有字体属性（包括扩展属性）应用到文本框中的每个段落。
+
+#### Scenario: 多行文本应用扩展属性
+
+- **WHEN** 文本内容包含换行符且定义 font: {size: 12, underline: true, line_spacing: 1.5}
+- **THEN** 系统将所有属性（size、underline、line_spacing）应用到所有段落
+
+#### Scenario: 多行文本每个段落样式一致
+
+- **WHEN** 文本包含多个换行符且定义了 font 属性
+- **THEN** 每个段落的字体样式都应一致
+
+### Requirement: 扩展属性必须支持继承机制
+
+扩展属性 SHALL 遵循与基础属性相同的继承机制：parent → 当前定义 → fonts_default → 系统默认。
+
+#### Scenario: 扩展属性从 parent 继承
+
+- **WHEN** parent 定义 underline: true，当前定义未指定 underline
+- **THEN** 元素使用 underline: true（从 parent 继承）
+
+#### Scenario: 扩展属性从 fonts_default 继承
+
+- **WHEN** fonts_default 定义 line_spacing: 1.5，元素未指定 line_spacing
+- **THEN** 元素使用 line_spacing: 1.5（从 fonts_default 继承）
+
+#### Scenario: 当前定义覆盖继承的扩展属性
+
+- **WHEN** parent 定义 space_before: 12，当前定义 space_before: 24
+- **THEN** 元素使用 space_before: 24（当前定义覆盖）
--- a/openspec/specs/font-preset/spec.md
+++ b/openspec/specs/font-preset/spec.md
@@ -0,0 +1,117 @@
+# Font Preset
+
+## Purpose
+
+预设字体类别提供系统内置的字体类别名称，用户可以直接使用这些类别名称引用推荐的字体，无需指定具体字体名称。系统将预设类别映射到跨平台通用的推荐字体。
+
+## Requirements
+
+### Requirement: 系统必须支持五种预设字体类别
+
+系统 SHALL 支持以下预设字体类别：sans、serif、mono、cjk-sans、cjk-serif。
+
+#### Scenario: 使用 sans 类别
+
+- **WHEN** 元素定义 font: {family: "sans"}
+- **THEN** 系统使用 "Arial" 作为字体族
+
+#### Scenario: 使用 serif 类别
+
+- **WHEN** 元素定义 font: {family: "serif"}
+- **THEN** 系统使用 "Times New Roman" 作为字体族
+
+#### Scenario: 使用 mono 类别
+
+- **WHEN** 元素定义 font: {family: "mono"}
+- **THEN** 系统使用 "Courier New" 作为字体族
+
+#### Scenario: 使用 cjk-sans 类别
+
+- **WHEN** 元素定义 font: {family: "cjk-sans"}
+- **THEN** 系统使用 "Microsoft YaHei" 作为字体族
+
+#### Scenario: 使用 cjk-serif 类别
+
+- **WHEN** 元素定义 font: {family: "cjk-serif"}
+- **THEN** 系统使用 "SimSun" 作为字体族
+
+### Requirement: 预设类别映射必须使用跨平台通用字体
+
+预设字体类别 SHALL 映射到跨平台通用性最高的字体，确保在不同操作系统上都有较好的显示效果。
+
+#### Scenario: sans 类别映射到 Arial
+
+- **WHEN** 系统解析 family: "sans"
+- **THEN** 映射到 "Arial"（Windows/macOS/Linux 通用）
+
+#### Scenario: serif 类别映射到 Times New Roman
+
+- **WHEN** 系统解析 family: "serif"
+- **THEN** 映射到 "Times New Roman"（Windows/macOS/Linux 通用）
+
+#### Scenario: mono 类别映射到 Courier New
+
+- **WHEN** 系统解析 family: "mono"
+- **THEN** 映射到 "Courier New"（Windows/macOS/Linux 通用）
+
+#### Scenario: cjk-sans 类别映射到微软雅黑
+
+- **WHEN** 系统解析 family: "cjk-sans"
+- **THEN** 映射到 "Microsoft YaHei"（Windows 常用中文字体）
+
+#### Scenario: cjk-serif 类别映射到宋体
+
+- **WHEN** 系统解析 family: "cjk-serif"
+- **THEN** 映射到 "SimSun"（Windows 常用中文字体）
+
+### Requirement: 预设类别必须在 family 字段中识别
+
+系统 SHALL 仅在 font 或 header_font 的 family 字段中识别预设类别名称。
+
+#### Scenario: family 字段使用预设类别
+
+- **WHEN** 元素定义 font: {family: "sans"}
+- **THEN** 系统识别 "sans" 为预设类别，映射到 "Arial"
+
+#### Scenario: 其他字段不解析预设类别
+
+- **WHEN** 元素定义 font: {size: "sans"}
+- **THEN** 系统将 "sans" 作为字符串值，不进行预设类别映射
+
+#### Scenario: 直接使用字体名称
+
+- **WHEN** 元素定义 font: {family: "SimSun"}
+- **THEN** 系统使用 "SimSun" 作为字体族，不进行预设类别映射
+
+### Requirement: 预设类别不进行字体验证
+
+系统 SHALL 不验证预设类别映射的字体是否在系统中存在。
+
+#### Scenario: 预设类别字体不存在时行为
+
+- **WHEN** 系统中不存在 Arial 字体
+- **THEN** 系统仍将 "sans" 映射到 "Arial"，不报错
+
+#### Scenario: PowerPoint 处理字体回退
+
+- **WHEN** PowerPoint 打开包含不存在字体的 PPTX 文件
+- **THEN** PowerPoint 自动回退到系统默认字体
+
+### Requirement: 预设类别可以与 fonts 配置结合使用
+
+用户可以在 fonts 配置中使用预设类别，也可以在元素 font 中直接使用。
+
+#### Scenario: fonts 配置中使用预设类别
+
+- **WHEN** metadata 定义 fonts: {body: {family: "sans", size: 18}}
+- **THEN** 系统将 family: "sans" 解析为 "Arial"
+
+#### Scenario: 元素直接使用预设类别
+
+- **WHEN** 元素定义 font: {family: "cjk-sans", size: 24}
+- **THEN** 系统将 family: "cjk-sans" 解析为 "Microsoft YaHei"
+
+#### Scenario: 预设类别与引用结合
+
+- **WHEN** fonts.title 定义 family: "sans"，元素定义 font: "@title"
+- **THEN** 元素使用 family: "Arial"（通过 title 配置）
--- a/openspec/specs/font-theme/spec.md
+++ b/openspec/specs/font-theme/spec.md
@@ -0,0 +1,207 @@
+# Font Theme
+
+## Purpose
+
+字体主题系统提供可复用的字体配置管理能力，允许用户在 metadata 中定义字体配置模板，通过引用方式应用到元素，实现统一的字体样式管理。
+
+## Requirements
+
+### Requirement: 系统必须支持在 metadata 中定义 fonts 字段
+
+系统 SHALL 支持在 YAML metadata 中定义 fonts 字段，用于存储可复用的字体配置。
+
+#### Scenario: 定义 fonts 字段
+
+- **WHEN** metadata 中定义 fonts 字段
+- **THEN** 系统成功解析并存储字体配置字典
+
+#### Scenario: fonts 字段为空字典
+
+- **WHEN** metadata 中定义 fonts: {}
+- **THEN** 系统接受空的字体配置字典
+
+#### Scenario: fonts 字段未定义
+
+- **WHEN** metadata 中未定义 fonts 字段
+- **THEN** 系统正常处理，fonts 为空字典
+
+### Requirement: fonts 字段必须包含命名字体配置
+
+fonts 字段 SHALL 包含一个或多个命名字体配置，每个配置是一个字体属性字典。
+
+#### Scenario: 定义单个字体配置
+
+- **WHEN** fonts 中定义 title: {family: "Arial", size: 44, bold: true}
+- **THEN** 系统创建名为 title 的字体配置
+
+#### Scenario: 定义多个字体配置
+
+- **WHEN** fonts 中定义 title、subtitle、body 等多个配置
+- **THEN** 系统为每个配置创建独立的字体对象
+
+### Requirement: 系统必须支持 fonts_default 字段
+
+系统 SHALL 支持在 metadata 中定义可选的 fonts_default 字段，指定默认字体配置的引用。
+
+#### Scenario: 定义 fonts_default 引用
+
+- **WHEN** metadata 中定义 fonts_default: "@body"
+- **THEN** 系统将 fonts_default 解析为对 fonts.body 的引用
+
+#### Scenario: fonts_default 未定义
+
+- **WHEN** metadata 中未定义 fonts_default 字段
+- **THEN** 系统使用 python-pptx 的默认字体
+
+#### Scenario: fonts_default 引用不存在的配置
+
+- **WHEN** fonts_default: "@undefined" 且 fonts.undefined 不存在
+- **THEN** 系统抛出 ERROR，提示引用的字体配置不存在
+
+#### Scenario: fonts_default 必须引用 fonts 中的配置
+
+- **WHEN** fonts_default: "Arial"（直接字体名称）
+- **THEN** 系统抛出 ERROR，提示 fonts_default 必须是引用格式
+
+### Requirement: 元素 font 字段必须支持三种引用方式
+
+元素 font 字段 SHALL 支持字符串引用（整体引用）、字典引用（继承覆盖或独立定义）两种形式。
+
+#### Scenario: 字符串整体引用
+
+- **WHEN** 元素定义 font: "@title"
+- **THEN** 系统使用 fonts.title 的所有属性
+
+#### Scenario: 字典继承覆盖
+
+- **WHEN** 元素定义 font: {parent: "@title", size: 60}
+- **THEN** 系统继承 fonts.title 的所有属性，覆盖 size 为 60
+
+#### Scenario: 字典独立定义
+
+- **WHEN** 元素定义 font: {family: "SimSun", size: 24}
+- **THEN** 系统使用定义的属性，未定义的属性继承 fonts_default
+
+#### Scenario: font 字段未定义
+
+- **WHEN** 元素未定义 font 字段
+- **THEN** 元素使用 fonts_default 或系统默认字体
+
+### Requirement: parent 字段必须引用 fonts 中的配置
+
+font 字典中的 parent 字段 SHALL 引用 fonts 中已定义的配置名称。
+
+#### Scenario: parent 引用存在的配置
+
+- **WHEN** parent: "@title" 且 fonts.title 存在
+- **THEN** 系统成功继承 fonts.title 的属性
+
+#### Scenario: parent 引用不存在的配置
+
+- **WHEN** parent: "@undefined" 且 fonts.undefined 不存在
+- **THEN** 系统抛出 ERROR，提示引用的字体配置不存在
+
+#### Scenario: parent 必须是引用格式
+
+- **WHEN** parent: "Arial"（直接字体名称）
+- **THEN** 系统抛出 ERROR，提示 parent 必须是引用格式
+
+### Requirement: 系统必须检测并拒绝引用循环
+
+系统 SHALL 在解析字体引用时检测循环引用，检测到循环时抛出 ERROR。
+
+#### Scenario: 直接循环引用
+
+- **WHEN** fonts.title.parent: "@title"（引用自身）
+- **THEN** 系统抛出 ERROR，提示检测到自引用
+
+#### Scenario: 间接循环引用
+
+- **WHEN** fonts.a.parent: "@b" 且 fonts.b.parent: "@a"
+- **THEN** 系统抛出 ERROR，显示完整的引用循环路径
+
+#### Scenario: 深层循环引用
+
+- **WHEN** 引用链深度超过 10 层
+- **THEN** 系统抛出 ERROR，提示引用深度超限
+
+#### Scenario: 错误信息包含引用路径
+
+- **WHEN** 系统检测到循环引用
+- **THEN** 错误信息包含完整的引用路径，如 "fonts.title -> fonts.subtitle -> fonts.title"
+
+### Requirement: 系统必须支持属性继承链
+
+字体属性解析 SHALL 按照优先级顺序继承：parent → 当前定义 → fonts_default → 系统默认。
+
+#### Scenario: parent 定义了基础属性
+
+- **WHEN** fonts.title 定义 size: 44，元素定义 font: {parent: "@title", bold: true}
+- **THEN** 元素使用 size: 44（继承）、bold: true（覆盖）
+
+#### Scenario: parent 未定义的属性继承 fonts_default
+
+- **WHEN** fonts_default 定义 size: 18，元素定义 font: {parent: "@title"} 且 title 未定义 size
+- **THEN** 元素使用 size: 18（从 fonts_default 继承）
+
+#### Scenario: 当前定义覆盖 parent
+
+- **WHEN** parent 定义 size: 44，当前定义 size: 60
+- **THEN** 元素使用 size: 60（当前定义覆盖 parent）
+
+### Requirement: 模板元素必须支持继承 fonts_default
+
+模板中未定义 font 的元素 SHALL 继承 metadata.fonts_default 配置。
+
+#### Scenario: 模板元素未定义 font
+
+- **WHEN** 模板元素未定义 font 字段
+- **THEN** 元素继承 metadata.fonts_default 的配置
+
+#### Scenario: 模板元素定义了 font
+
+- **WHEN** 模板元素定义 font: "@title"
+- **THEN** 元素使用 font: "@title"，不继承 fonts_default
+
+#### Scenario: fonts_default 未定义时模板元素行为
+
+- **WHEN** 模板元素未定义 font 且 metadata 未定义 fonts_default
+- **THEN** 元素使用系统默认字体
+
+### Requirement: 表格元素必须支持 font 和 header_font 字段
+
+表格元素 SHALL 支持 font 和 header_font 字段，分别控制数据单元格和表头的字体样式。
+
+#### Scenario: 表格定义整体字体
+
+- **WHEN** 表格定义 font: {family: "Arial", size: 14}
+- **THEN** 数据单元格和表头都应用该字体（表头可被 header_font 覆盖）
+
+#### Scenario: 表格定义表头字体
+
+- **WHEN** 表格定义 header_font: {bold: true, color: "#ffffff"}
+- **THEN** 表头应用该字体，数据单元格继承 font 或 fonts_default
+
+#### Scenario: 表头字体继承表格字体
+
+- **WHEN** 表格定义 font: {size: 14} 且 header_font: {parent: "@font", bold: true}
+- **THEN** 表头继承 size: 14，覆盖 bold: true
+
+#### Scenario: 表格仅定义 header_font
+
+- **WHEN** 表格仅定义 header_font: {bold: true}
+- **THEN** 表头应用 bold: true，数据单元格继承 fonts_default
+
+### Requirement: 系统必须移除旧的表格字体语法
+
+系统 SHALL 移除 style.font_size 和 style.header_color 字段的处理逻辑。
+
+#### Scenario: 旧语法字段不再生效
+
+- **WHEN** 表格定义 style: {font_size: 14, header_color: "#fff"}
+- **THEN** 系统忽略这些字段，使用 font 和 header_font 替代
+
+#### Scenario: style 字段保留用于非字体属性
+
+- **WHEN** 表格定义 style: {header_bg: "#4a90e2"}
+- **THEN** 系统正常处理背景色等非字体属性