feat: initial implementation of html2pptx with OpenSpec documentation

Add core Python script (yaml2pptx.py) for converting YAML to PowerPoint:
- Element rendering: text, image, shape, table, chart
- Template system with placeholders
- PPTX generation with python-pptx

OpenSpec workflow setup:
- 3 archived changes: browser-preview, template-dir-cli, yaml-to-pptx
- 7 main specifications covering all core modules
- Config and documentation structure

30 files changed, 4984 insertions(+)

openspec/changes/archive/2026-03-02-add-template-dir-parameter/tasks.md

@@ -0,0 +1,40 @@
+## 1. 添加命令行参数
+
+- [x] 1.1 在 `parse_args` 函数中添加 `--template-dir` 参数定义
+- [x] 1.2 设置参数类型为 `str`，默认值为 `None`
+- [x] 1.3 添加清晰的帮助信息，说明参数用途和路径格式
+
+## 2. 修改 Template 类
+
+- [x] 2.1 修改 `Template.__init__` 方法签名，将 `templates_dir='templates'` 改为 `templates_dir=None`
+- [x] 2.2 添加 templates_dir 为 None 的检查，抛出清晰的错误信息
+- [x] 2.3 添加模板名称验证，检查是否包含 `/` 或 `\` 路径分隔符
+- [x] 2.4 移除 `if not template_path.is_absolute() and not template_path.exists()` 的逻辑
+- [x] 2.5 直接使用 `Path(templates_dir) / f"{template_file}.yaml"` 构建模板路径
+- [x] 2.6 改进模板文件不存在时的错误信息，包含查找位置和期望路径
+
+## 3. 修改 Presentation 类
+
+- [x] 3.1 修改 `Presentation.__init__` 方法签名，将 `templates_dir='templates'` 改为 `templates_dir=None`
+- [x] 3.2 确保 templates_dir 参数正确传递给 Template 类
+
+## 4. 修改 main 函数
+
+- [x] 4.1 从 `args.template_dir` 获取参数值
+- [x] 4.2 将 `templates_dir=args.template_dir` 传递给 Presentation 构造函数
+
+## 5. 错误信息优化
+
+- [x] 5.1 实现"未指定模板目录"错误信息，包含使用建议
+- [x] 5.2 实现"模板名称包含路径分隔符"错误信息，包含正确格式示例
+- [x] 5.3 实现"模板文件不存在"错误信息，包含查找位置、期望路径和解决建议
+
+## 6. 测试验证
+
+- [x] 6.1 测试不使用模板的纯自定义幻灯片（不指定 --template-dir）
+- [x] 6.2 测试使用模板但未指定 --template-dir 的错误提示
+- [x] 6.3 测试使用绝对路径指定 template-dir
+- [x] 6.4 测试使用相对路径指定 template-dir
+- [x] 6.5 测试模板名称包含路径分隔符的错误提示
+- [x] 6.6 测试模板文件不存在的错误提示
+- [x] 6.7 在 Mac 和 Windows 上验证路径处理的跨平台兼容性