f34405be36
feat: 移除图片适配模式功能
...
移除图片 fit 和 background 参数支持，简化图片渲染逻辑。系统恢复到直接使用 python-pptx 原生图片添加功能，图片将被拉伸到指定尺寸。
变更内容：
- 移除 ImageElement 的 fit 和 background 字段
- 移除 metadata.dpi 配置
- 删除 utils/image_utils.py 图片处理工具模块
- 删除 validators/image_config.py 验证器
- 简化 PPTX 和 HTML 渲染器的图片处理逻辑
- HTML 渲染器使用硬编码 DPI=96（Web 标准）
- 删除相关测试文件（单元测试、集成测试、e2e 测试）
- 更新规格文档和用户文档
- 保留 Pillow 依赖用于未来可能的图片处理需求
影响：
- 删除 11 个文件
- 修改 10 个文件
- 净减少 1558 行代码
- 所有 402 个测试通过
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-03-04 14:23:12 +08:00
2fd8bc1b4a
feat: 为metadata、模板和幻灯片添加description字段支持
...
添加可选的description字段用于文档目的，不影响渲染输出。
主要更改：
- core/presentation.py: 添加metadata.description属性
- core/template.py: 添加template.description属性
- tests: 添加16个新测试用例验证description功能
- docs: 更新README.md和README_DEV.md文档
- specs: 新增page-description规范文件
2026-03-04 13:22:33 +08:00
5d60f3c2c2
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
19d6661381
feat: 添加图片适配模式支持
...
- 支持四种图片适配模式：stretch、contain、cover、center
- 支持背景色填充功能（contain 和 center 模式）
- 支持文档级 DPI 配置（metadata.dpi）
- PPTX 渲染器集成 Pillow 实现高质量图片处理
- HTML 渲染器使用 CSS object-fit 实现相同效果
- 添加完整的单元测试、集成测试和端到端测试
- 更新 README 文档和架构文档
- 模块化设计：utils/image_utils.py 图片处理工具模块
- 添加图片配置验证器：validators/image_config.py
- 向后兼容：未指定 fit 时默认使用 stretch 模式
2026-03-04 10:29:21 +08:00
01eacb0b97
feat: 添加内联模板支持
...
支持在 YAML 源文件中直接定义模板，无需单独的模板文件。
简化单文档编写流程，降低模板系统使用门槛。
核心功能：
- 在 YAML 顶层新增 templates 字段定义内联模板
- 支持变量替换、条件渲染、默认值等完整模板功能
- 内联模板优先于外部模板查找
- 同名冲突检测：禁止内联和外部模板同名
- 相互引用检测：禁止内联模板之间相互引用
- 完整的错误处理和验证机制
代码变更：
- core/template.py: 新增 from_data() 类方法
- core/presentation.py: 支持内联模板查找和冲突检测
- loaders/yaml_loader.py: 新增 validate_templates_yaml() 验证
- validators/: 扩展验证器支持内联模板
测试：
- 新增 9 个内联模板专项测试
- 修复 1 个变量验证测试
- 所有 333 个测试通过
文档：
- README.md: 添加内联模板使用指南和最佳实践
- README_DEV.md: 说明实现细节和设计决策
完全向后兼容，不使用 templates 字段时行为不变。
2026-03-03 15:59:55 +08:00
c73bd0fedd
fix: 修复测试问题，提升测试通过率
...
修复内容:
- E2E测试命令执行方式：将 python -m uv run 改为 uv run
- HTML渲染器：添加 & 字符的HTML转义
- Presentation尺寸验证：添加尺寸值类型验证
- PPTX验证器：修复文本框检测兼容性
- 验证结果格式化：修复提示信息显示
- Mock配置：修复表格渲染等测试的Mock配置
测试结果:
- 修复前: 264 通过, 42 失败, 1 错误
- 修复后: 297 通过, 9 失败, 1 错误
剩余9个失败为待实现的功能增强(验证器模板变量验证)
2026-03-03 00:42:39 +08:00
ed940f0690
refactor: modularize yaml2pptx into layered architecture
...
Refactor yaml2pptx.py from a 1,245-line monolithic script into a modular
architecture with clear separation of concerns. The entry point is now
127 lines, with business logic distributed across focused modules.
Architecture:
- core/: Domain models (elements, template, presentation)
- loaders/: YAML loading and validation
- renderers/: PPTX and HTML rendering
- preview/: Flask preview server
- utils.py: Shared utilities
Key improvements:
- Element abstraction layer using dataclass with validation
- Renderer logic built into generator classes
- Single-direction dependencies (no circular imports)
- Each module 150-300 lines for better readability
- Backward compatible CLI interface
Documentation:
- README.md: User-facing usage guide
- README_DEV.md: Developer documentation
OpenSpec:
- Archive refactor-yaml2pptx-modular change (63/70 tasks complete)
- Sync 5 delta specs to main specs (2 new + 3 updated)
2026-03-02 16:43:45 +08:00
