fix: 优化配置、修复测试和 temp_pdf 中文字体支持
- 优化 config.py,为所有依赖添加版本号,为所有文件类型添加 Darwin-x86_64 配置 - 修改 run_tests.py,添加平台相关 TEST_FIXTURE_DEPENDENCIES,简化 cli 和 all 测试逻辑 - 修复 tests/conftest.py 中 temp_pdf 的中文字体支持,使用 macOS 系统字体 - 更新 tests/test_core/test_advice_generator.py 以适应 Python 3.12 的默认配置 - 更新 openspec 相关规格文档
This commit is contained in:
@@ -13,6 +13,7 @@ context: |
|
||||
- 代码: 模块文件150-300行; 错误需自定义异常+清晰信息+位置上下文
|
||||
- 项目阶段: 未上线,无用户,破坏性变更无需迁移说明
|
||||
- Git提交: 仅中文; 格式为"类型: 简短描述",类型可选: feat(新功能)/fix(修复)/refactor(重构)/docs(文档)/style(格式)/test(测试)/chore(构建/工具); 多行描述空行后加详细说明
|
||||
- 提问: 对用户的提问优先使用提问工具而不是文字选项
|
||||
# 项目概述
|
||||
- 目标:统一文档解析工具,将DOCX/XLSX/PPTX/PDF/HTML/URL 转换为 Markdown,面向AI skill使用
|
||||
# 项目目录结构
|
||||
|
||||
@@ -22,12 +22,42 @@
|
||||
- 必须使用 Python 3.12
|
||||
- `docling-parse` 5.x 无 x86_64 wheel,必须使用 4.0.0
|
||||
- 提供完整的 `uv run --python 3.12 --with "docling==2.40.0" --with "docling-parse==4.0.0" --with "numpy<2" ...` 命令示例
|
||||
- unstructured 在 Darwin-x86_64 平台不可用,已从配置中移除
|
||||
|
||||
#### Scenario: 每个平台的运行命令
|
||||
- **WHEN** 用户阅读 SKILL.md
|
||||
- **THEN** 系统必须为每个平台(Windows/macOS Intel/macOS ARM/Linux)和每种文档格式提供清晰的 `uv run --with` 命令示例
|
||||
- **AND** 命令必须包含所有必需的依赖包
|
||||
|
||||
### Requirement: 依赖配置结构
|
||||
config.py 中的 DEPENDENCIES 配置使用字典结构,保持简单直接以便于在不同平台进行细致调整。
|
||||
|
||||
#### Scenario: 配置数据格式不变
|
||||
- **WHEN** 代码访问 config.DEPENDENCIES["pdf"]["default"]
|
||||
- **THEN** 返回的数据结构保持不变
|
||||
- **AND** 包含 "python" 和 "dependencies" 字段
|
||||
|
||||
#### Scenario: 所有文件类型都有 Darwin-x86_64 配置
|
||||
- **WHEN** 查看 config.DEPENDENCIES
|
||||
- **THEN** pdf/docx/xlsx/pptx/xls/ppt 都有 "Darwin-x86_64" 平台配置
|
||||
- **AND** Darwin-x86_64 配置中不包含 unstructured 相关依赖
|
||||
|
||||
### Requirement: 依赖版本管理
|
||||
所有依赖必须指定版本号,default 平台使用截止 2026-03-17 的最新版本,Darwin-x86_64 平台使用已验证可用的版本。
|
||||
|
||||
#### Scenario: default 平台使用最新版本
|
||||
- **WHEN** 查看 config.DEPENDENCIES 中 default 配置的依赖
|
||||
- **THEN** 所有依赖都有明确的版本号
|
||||
- **AND** docling 使用 2.80.0
|
||||
- **AND** docling-parse 使用 5.5.0
|
||||
- **AND** markitdown 使用 0.1.5
|
||||
|
||||
#### Scenario: Darwin-x86_64 平台使用验证版本
|
||||
- **WHEN** 查看 config.DEPENDENCIES 中 Darwin-x86_64 配置的依赖
|
||||
- **THEN** docling 使用 2.40.0
|
||||
- **AND** docling-parse 使用 4.0.0
|
||||
- **AND** numpy 使用 <2
|
||||
|
||||
### Requirement: 平台检测文档
|
||||
系统必须在 `SKILL.md` 中提供平台检测方法和平台特定的安装指南。
|
||||
|
||||
|
||||
@@ -6,6 +6,23 @@
|
||||
|
||||
## Requirements
|
||||
|
||||
### Requirement: 测试运行器包含 fixtures 依赖
|
||||
run_tests.py 必须定义 TEST_FIXTURE_DEPENDENCIES 常量,包含创建临时测试文件所需的所有依赖。
|
||||
|
||||
#### Scenario: TEST_FIXTURE_DEPENDENCIES 定义存在
|
||||
- **WHEN** 查看 run_tests.py
|
||||
- **THEN** 存在 TEST_FIXTURE_DEPENDENCIES 常量
|
||||
- **AND** 包含 python-docx(用于创建临时 DOCX)
|
||||
- **AND** 包含 reportlab(用于创建临时 PDF)
|
||||
- **AND** 包含 pandas(用于创建临时 XLSX)
|
||||
- **AND** 包含 openpyxl(pandas 写 XLSX 需要)
|
||||
- **AND** 包含 python-pptx(用于创建临时 PPTX)
|
||||
|
||||
#### Scenario: fixtures 依赖与文件类型依赖合并
|
||||
- **WHEN** 运行任何类型的测试
|
||||
- **THEN** TEST_FIXTURE_DEPENDENCIES 中的依赖自动合并到 uv run --with 参数中
|
||||
- **AND** 去重处理,避免重复添加
|
||||
|
||||
### Requirement: 临时文件自动清理
|
||||
测试使用的临时文件 MUST 在测试完成后自动清理,使用 pytest 的 tmp_path fixture。
|
||||
|
||||
|
||||
@@ -12,21 +12,26 @@
|
||||
#### Scenario: 运行 PDF 测试
|
||||
- **WHEN** 用户执行 `python run_tests.py pdf`
|
||||
- **THEN** 自动加载 config.DEPENDENCIES["pdf"] 中的依赖
|
||||
- **AND** 自动加载测试 fixtures 所需的依赖
|
||||
- **AND** 运行 tests/test_readers/test_pdf/ 目录下的测试
|
||||
|
||||
#### Scenario: 运行 DOCX 测试
|
||||
- **WHEN** 用户执行 `python run_tests.py docx`
|
||||
- **THEN** 自动加载 config.DEPENDENCIES["docx"] 中的依赖
|
||||
- **AND** 自动加载测试 fixtures 所需的依赖
|
||||
- **AND** 运行 tests/test_readers/test_docx/ 目录下的测试
|
||||
|
||||
#### Scenario: 运行 CLI 测试(无特殊依赖)
|
||||
- **WHEN** 用户执行 `python run_tests.py cli`
|
||||
- **THEN** 仅加载 pytest 依赖
|
||||
- **THEN** 加载 pytest 依赖
|
||||
- **AND** 自动加载测试 fixtures 所需的依赖
|
||||
- **AND** 加载 config.DEPENDENCIES 中所有类型的依赖(去重)
|
||||
- **AND** 运行 tests/test_cli/ 目录下的测试
|
||||
|
||||
#### Scenario: 运行所有测试
|
||||
- **WHEN** 用户执行 `python run_tests.py all`
|
||||
- **THEN** 加载 config.DEPENDENCIES 中所有类型的依赖(去重)
|
||||
- **AND** 自动加载测试 fixtures 所需的依赖
|
||||
- **AND** 运行 tests/ 目录下的所有测试
|
||||
|
||||
### Requirement: 测试运行器支持透传 pytest 参数
|
||||
|
||||
Reference in New Issue
Block a user