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

@@ -4,6 +4,9 @@
"""
import re
import subprocess
import tempfile
import shutil
import zipfile
from pathlib import Path
from typing import List, Optional, Tuple
@@ -63,6 +66,75 @@ def parse_via_docling(file_path: str) -> Tuple[Optional[str], Optional[str]]:
return None, f"docling 解析失败: {str(e)}"
def parse_via_libreoffice(file_path: str) -> Tuple[Optional[str], Optional[str]]:
"""使用 LibreOffice soffice 命令行转换文件为 Markdown。
支持 .doc/.docx/.odt 等 LibreOffice 可处理的格式。
Args:
file_path: 文件路径
Returns:
(markdown_content, error_message): 成功时 (content, None),失败时 (None, error)
"""
# 检测 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
# ============================================================================
# 格式化工具
# ============================================================================