# Implementation Tasks

## 0. 清理旧代码和测试

- [x] 0.1 识别并标记需要清理的旧测试
- [x] 0.2 清理 tests/unit/test_template.py 中向后兼容性相关测试
- [x] 0.3 清理 tests/integration/test_template_library.py 中向后兼容性相关测试
- [x] 0.4 清理旧版本的模板库元数据处理逻辑

## 1. YAML 加载和验证

- [x] 1.1 在 loaders/yaml_loader.py 中创建 validate_metadata() 函数
- [x] 1.2 修改 validate_presentation_yaml() 调用 validate_metadata()
- [x] 1.3 修改 validate_template_library_yaml() 验证模板库必须包含 metadata
- [x] 1.4 在 validate_template_library_yaml() 中验证模板库 fonts_default 只能引用模板库内部字体

## 2. Size 一致性校验

- [x] 2.1 在 core/presentation.py 中添加 size 一致性校验
- [x] 2.2 添加 size 一致性校验的单元测试

## 3. FontResolver 跨域支持

- [x] 3.1 扩展 FontResolver 类支持 scope 和 template_fonts 参数
- [x] 3.2 修改 _resolve_reference() 方法根据作用域限制引用范围
- [x] 3.3 实现跨域循环引用检测
- [x] 3.4 添加 parent 引用的跨域限制

## 4. Presentation 类扩展

- [x] 4.1 在 Presentation 中解析和存储模板库 metadata.fonts
- [x] 4.2 创建文档作用域的 FontResolver
- [x] 4.3 创建模板库作用域的 FontResolver

## 5. Template 类扩展

- [x] 5.1 修改 Template.from_data() 接收 scope 和 font_resolver 参数
- [x] 5.2 修改 Template.render() 应用正确的 FontResolver 和 fonts_default 级联
- [x] 5.3 添加表格双字体字段的处理

## 6. 错误代码定义

- [x] 6.1 在 validators/result.py 中添加新的错误代码：
  - SIZE_MISMATCH - 文档和模板库尺寸不一致
  - TEMPLATE_FONT_REF_DOC_FORBIDDEN - 模板元素引用文档字体
  - TEMPLATE_PARENT_REF_DOC_FORBIDDEN - 模板库 parent 引用文档字体
  - FONT_NOT_FOUND - 字体配置不存在
  - CIRCULAR_REFERENCE - 循环引用（包括跨域）
  - FONT_DEFAULT_INVALID - fonts_default 引用无效
  - TEMPLATE_LIBRARY_MISSING_METADATA - 模板库缺少 metadata 字段
  - TEMPLATE_LIBRARY_METADATA_MISSING_SIZE - 模板库 metadata 缺少 size
  - TEMPLATE_LIBRARY_METADATA_INVALID_SIZE - 模板库 metadata.size 无效

## 7. 单元测试

- [x] 7.1 添加 validate_metadata() 的单元测试
- [x] 7.2 添加 FontResolver 跨域引用的单元测试
- [x] 7.3 添加 fonts_default 级联的单元测试
- [x] 7.4 添加跨域循环引用检测的单元测试（包括单域内循环和跨域循环）
- [x] 7.5 添加模板库 fonts_default 验证的单元测试

## 8. 集成测试

- [x] 8.1 添加跨域字体引用的集成测试
- [x] 8.2 添加 size 一致性校验的集成测试
- [x] 8.3 添加完整渲染流程的集成测试
- [x] 8.4 添加表格双字体字段（font 和 header_font）的集成测试

## 9. 文档更新

- [x] 9.1 更新 README.md 添加模板库 metadata 说明和示例
- [x] 9.2 更新 README_DEV.md 记录错误代码和作用域规则
- [x] 9.3 添加模板库示例文件

## 10. 代码清理和格式化

- [x] 10.1 验证旧测试已完全清理
- [x] 10.2 代码格式化和添加中文注释

## 11. 最终测试

- [x] 11.1 运行完整的测试套件
- [x] 11.2 手动测试关键场景
- [x] 11.3 确保所有测试通过