feat: 新增 .doc 格式支持,借助 LibreOffice soffice

- 提取 LibreOffice 解析逻辑为公共工具函数 _utils.parse_via_libreoffice()
- 新增 DocReader 独立 Reader,支持 .doc 格式
- 新增 is_valid_doc() 文件验证函数(复用 OLE2 检测)
- 新增 doc 格式依赖配置(独立配置)
- 新增完整的测试套件,使用静态测试文件
- 更新 README.md 和 SKILL.md,添加 .doc 格式支持说明
- 新增 openspec/specs/doc-reader/spec.md 规范文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-16 10:40:43 +08:00
parent 0dd7aa221c
commit e0c6ed1638
14 changed files with 274 additions and 65 deletions

View File

@@ -1,67 +1,9 @@
"""使用 LibreOffice soffice 命令行解析 DOCX 文件"""
import subprocess
import tempfile
import shutil
from pathlib import Path
from typing import Optional, Tuple
from readers._utils import parse_via_libreoffice
def parse(file_path: str) -> Tuple[Optional[str], Optional[str]]:
"""使用 LibreOffice soffice 解析 DOCX 文件"""
# 检测 soffice 是否在 PATH 中
soffice_path = shutil.which("soffice")
if not soffice_path:
return None, "LibreOffice 未安装"
# 创建临时输出目录
with tempfile.TemporaryDirectory() as temp_dir:
temp_path = Path(temp_dir)
input_path = Path(file_path)
expected_output = temp_path / (input_path.stem + ".md")
# 构建命令
cmd = [
soffice_path,
"--headless",
"--convert-to", "md",
"--outdir", str(temp_path),
str(input_path)
]
# 执行命令,超时 60 秒
try:
result = subprocess.run(
cmd,
capture_output=True,
text=True,
timeout=60
)
except subprocess.TimeoutExpired:
return None, "LibreOffice 转换超时 (60秒)"
# 检查返回码
if result.returncode != 0:
return None, f"LibreOffice 转换失败 (code: {result.returncode})"
# 检查输出文件是否存在
output_file = None
if expected_output.exists():
output_file = expected_output
else:
# Fallback: 遍历目录找任意 .md 文件
md_files = list(temp_path.glob("*.md"))
if md_files:
output_file = md_files[0]
if not output_file:
return None, "LibreOffice 未生成输出文件"
# 读取输出内容
content = output_file.read_text(encoding="utf-8", errors="replace")
content = content.strip()
if not content:
return None, "LibreOffice 输出为空"
return content, None
return parse_via_libreoffice(file_path)