Files
lanyuanxiaoyao a490b2642c feat: 新增 PPT 旧格式支持,重构 LibreOffice 转换工具
- 新增 PPT (旧格式) 解析器
- 重构 _utils.py,提取通用 convert_via_libreoffice 函数
- 更新依赖配置,添加 PPT 相关依赖
- 完善文档,更新 README 和 SKILL.md
- 添加 PPT 文件检测函数
- 新增 PPT 解析器测试用例
2026-03-16 22:49:04 +08:00

1.8 KiB

Purpose

PPT 文档解析能力,支持解析 Microsoft PowerPoint 97-2003 旧格式文档。

Requirements

Requirement: PPT 文档解析

系统 SHALL 支持解析 .ppt 格式文档,使用 LibreOffice 解析器。

Scenario: 使用 LibreOffice 解析器

  • WHEN 解析 PPT 文档
  • THEN 系统使用 LibreOffice soffice 将 PPT 转换为 PPTX
  • AND 复用 PptxReader 解析转换后的 PPTX

Scenario: 成功解析

  • WHEN 解析器成功
  • THEN 系统返回解析结果

Scenario: 解析器失败

  • WHEN 解析器失败
  • THEN 系统返回失败列表并退出非零状态码

Requirement: LibreOffice 解析器

系统 SHALL 支持使用 LibreOffice soffice 命令行解析 PPT。

Scenario: LibreOffice 解析成功

  • WHEN soffice 可用且文档有效
  • THEN 系统返回 Markdown 内容

Scenario: LibreOffice 未安装

  • WHEN soffice 未在 PATH 中
  • THEN 系统返回失败信息

Scenario: LibreOffice 转换超时

  • WHEN soffice 执行超过 60 秒
  • THEN 系统返回超时错误

Scenario: LibreOffice 转换失败

  • WHEN soffice 返回非零退出码
  • THEN 系统返回失败信息

Scenario: 临时文件自动清理

  • WHEN 解析完成(无论成功或失败)
  • THEN 转换过程中生成的临时 PPTX 文件被自动清理

Requirement: 解析器独立文件

系统 SHALL 将解析器实现为独立的单文件模块。

Scenario: LibreOffice 解析器在独立文件

  • WHEN 使用 LibreOffice 解析器
  • THEN 从 readers/ppt/libreoffice.py 导入

Requirement: PPT Reader 测试使用静态文件

PPT Reader 测试 MUST 使用 tests/test_readers/fixtures/ppt/ 下的静态文件。

Scenario: 测试使用 simple.ppt

  • WHEN 测试 PPT Reader 基础解析能力
  • THEN 使用 simple.ppt 静态文件