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>

scripts/config.py

@@ -110,5 +110,11 @@ DEPENDENCIES = {
                 "olefile"
             ]
         }
+    },
+    "doc": {
+        "default": {
+            "python": None,
+            "dependencies": []
+        }
     }
 }

scripts/readers/__init__.py

@@ -2,6 +2,7 @@
 
 from .base import BaseReader
 from .docx import DocxReader
+from .doc import DocReader
 from .xlsx import XlsxReader
 from .pptx import PptxReader
 from .pdf import PdfReader
@@ -10,6 +11,7 @@ from .xls import XlsReader
 
 READERS = [
     DocxReader,
+    DocReader,
     XlsxReader,
     PptxReader,
     PdfReader,
@@ -20,6 +22,7 @@ READERS = [
 __all__ = [
     "BaseReader",
     "DocxReader",
+    "DocReader",
     "XlsxReader",
     "PptxReader",
     "PdfReader",

scripts/readers/_utils.py

@@ -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
+
+
 # ============================================================================
 # 格式化工具
 # ============================================================================

scripts/readers/doc/__init__.py

@@ -0,0 +1,46 @@
+"""DOC 文件阅读器，使用 LibreOffice 解析。"""
+
+import os
+from typing import List, Optional, Tuple
+
+from readers.base import BaseReader
+from utils import is_valid_doc
+
+from . import libreoffice
+
+
+PARSERS = [
+    ("LibreOffice", libreoffice.parse),
+]
+
+
+class DocReader(BaseReader):
+    """DOC 文件阅读器"""
+
+    def supports(self, file_path: str) -> bool:
+        return file_path.lower().endswith('.doc')
+
+    def parse(self, file_path: str) -> Tuple[Optional[str], List[str]]:
+        failures = []
+
+        # 检查文件是否存在
+        if not os.path.exists(file_path):
+            return None, ["文件不存在"]
+
+        # 验证文件格式
+        if not is_valid_doc(file_path):
+            return None, ["不是有效的 DOC 文件"]
+
+        content = None
+
+        for parser_name, parser_func in PARSERS:
+            try:
+                content, error = parser_func(file_path)
+                if content is not None:
+                    return content, failures
+                else:
+                    failures.append(f"- {parser_name}: {error}")
+            except Exception as e:
+                failures.append(f"- {parser_name}: [意外异常] {type(e).__name__}: {str(e)}")
+
+        return None, failures

scripts/readers/doc/libreoffice.py

@@ -0,0 +1,9 @@
+"""使用 LibreOffice soffice 命令行解析 DOC 文件"""
+
+from typing import Optional, Tuple
+from readers._utils import parse_via_libreoffice
+
+
+def parse(file_path: str) -> Tuple[Optional[str], Optional[str]]:
+    """使用 LibreOffice soffice 解析 DOC 文件"""
+    return parse_via_libreoffice(file_path)

scripts/readers/docx/libreoffice.py

@@ -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)

scripts/utils/__init__.py

@@ -1,6 +1,7 @@
 """Utils module for lyxy-document."""
 
 from .file_detection import (
+    is_valid_doc,
     is_valid_docx,
     is_valid_pptx,
     is_valid_xlsx,
@@ -11,6 +12,7 @@ from .file_detection import (
 )
 
 __all__ = [
+    "is_valid_doc",
     "is_valid_docx",
     "is_valid_pptx",
     "is_valid_xlsx",

scripts/utils/file_detection.py

@@ -6,7 +6,7 @@ from typing import List, Optional
 
 
 def _is_valid_ole(file_path: str) -> bool:
-    """验证 OLE2 格式文件（XLS）"""
+    """验证 OLE2 格式文件（XLS/DOC）"""
     try:
         import olefile
     except ImportError:
@@ -53,6 +53,11 @@ def is_valid_xls(file_path: str) -> bool:
     return _is_valid_ole(file_path)
 
 
+def is_valid_doc(file_path: str) -> bool:
+    """验证文件是否为有效的 DOC 格式（OLE2）"""
+    return _is_valid_ole(file_path)
+
+
 def is_valid_pdf(file_path: str) -> bool:
     """验证文件是否为有效的 PDF 格式"""
     try: