lanyuanxiaoyao
98098dc911
实现了统一的metadata结构和字体作用域系统，支持文档和模板库之间的单向字体引用。 主要变更： - 模板库必须包含metadata字段（包括size、fonts、fonts_default） - 实现文档和模板库的size一致性校验 - 实现字体作用域系统（文档可引用模板库字体，反之不可） - 实现跨域循环引用检测 - 实现fonts_default级联规则（模板库→文档→系统默认） - 添加错误代码常量（SIZE_MISMATCH、FONT_NOT_FOUND等） - 更新文档和开发者指南 测试覆盖： - 新增33个测试（单元测试20个，集成测试13个） - 所有457个测试通过 Breaking Changes： - 模板库文件必须包含metadata字段 - 模板库metadata.size为必填字段 - 文档和模板库的size必须一致 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
85 lines
3.2 KiB
Markdown
85 lines
3.2 KiB
Markdown
# 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 确保所有测试通过
|