PPTX/openspec/changes/archive/2026-03-02-add-yaml-validation/tasks.md

1. 验证结果数据结构

• 1.1 创建 validators/ 目录结构
• 1.2 实现 validators/result.py 中的 ValidationIssue 数据类
• 1.3 实现 validators/result.py 中的 ValidationResult 数据类
• 1.4 实现 ValidationResult.has_errors() 方法
• 1.5 实现 ValidationResult.format_output() 方法，支持图标和分组显示

2. 元素类验证增强

• 2.1 在 core/elements.py 中添加颜色格式验证工具函数 _is_valid_color()
• 2.2 为 TextElement 类添加 validate() 方法，检查颜色格式和字体大小
• 2.3 为 ImageElement 类添加 validate() 方法，检查必需字段
• 2.4 为 ShapeElement 类添加 validate() 方法，检查颜色格式和形状类型枚举
• 2.5 为 TableElement 类添加 validate() 方法，检查数据完整性

3. 几何验证器

• 3.1 创建 validators/geometry.py 文件
• 3.2 实现 GeometryValidator 类
• 3.3 实现元素边界检查方法，支持 0.1 英寸容忍度
• 3.4 实现表格边界检查方法
• 3.5 实现元素完全在页面外的检查

4. 资源验证器

• 4.1 创建 validators/resource.py 文件
• 4.2 实现 ResourceValidator 类
• 4.3 实现图片文件存在性检查，支持相对路径和绝对路径
• 4.4 实现模板文件存在性检查
• 4.5 实现模板文件结构验证（检查 elements 字段）

5. 主验证器

• 5.1 创建 validators/validator.py 文件
• 5.2 实现 Validator 类的 validate() 方法
• 5.3 集成 YAML 加载（复用 loaders/yaml_loader.py）
• 5.4 集成元素级验证（调用元素类的 validate() 方法）
• 5.5 集成几何验证器
• 5.6 集成资源验证器
• 5.7 在 validators/init.py 中导出主验证器

6. 命令行接口 - check 子命令

• 6.1 修改 yaml2pptx.py，使用 argparse 的 subparsers 添加 check 子命令
• 6.2 实现 check 子命令的参数解析（input, --template-dir）
• 6.3 实现 check 子命令的处理函数，调用验证器
• 6.4 实现验证结果的命令行输出
• 6.5 根据验证结果返回正确的退出码（有 ERROR 返回非零）

7. 命令行接口 - 自动验证

• 7.1 在转换命令中添加 --no-check 选项
• 7.2 在转换流程中添加自动验证逻辑（加载 YAML 后、渲染前）
• 7.3 实现验证失败时终止转换的逻辑
• 7.4 确保 --no-check 选项可以跳过验证

8. 测试

• 8.1 在 temp/ 目录创建测试用的 YAML 文件（包含各种错误场景）
• 8.2 测试独立 check 命令的各种场景
• 8.3 测试自动验证功能
• 8.4 测试 --no-check 选项
• 8.5 测试元素超出页面边界的检测
• 8.6 测试图片文件不存在的检测
• 8.7 测试模板文件验证
• 8.8 测试颜色格式验证
• 8.9 测试字体大小警告
• 8.10 测试容忍度（0.1 英寸）

9. 文档更新

• 9.1 更新 README.md，添加 check 命令的使用说明
• 9.2 更新 README.md，说明自动验证功能和 --no-check 选项
• 9.3 添加验证错误码和消息的说明（如果需要）