convert-doc 是一个面向上下文效率的智能文档管道，主要用途是把常见办公文档转换为干净 Markdown，并自动缓存、自动摘要，方便在 AI 助手中读取和分析。
主要能力：支持 PDF（PyMuPDF，逐页文本提取）、Word（.docx/.doc，pandoc/python-docx，完整 Markdown）、PowerPoint（.pptx/.ppt，python-pptx，逐张幻灯片含备注）、Excel（.xlsx/.xls，openpyxl，表格转为 Markdown）、RTF（pandoc）。超过 100KB 的文档会自动生成摘要版本（目标约 30KB），保留全部标题与结构、每节开头部分、元数据与来源引用；结果以 JSON 返回缓存路径、摘要路径、原始与转换后大小、节省比例以及“summary 或 full”建议。
使用方式：基础命令为 python ~/.claude/lib/document-converter.py "/path/to/file.pdf"；可用 --force 强制重新生成，用 --list 列出缓存文档，用 --cleanup 清理超过一周的旧缓存。缓存位于 ~/.claude/cache/documents/，保存完整转换版本及摘要版本，一周后过期。smart-read-interceptor 钩子会在读取 PDF、Word、PowerPoint、Excel 文件或任何超过 200KB 的文件时自动触发，并建议使用摘要、使用缓存、先转换或委派子代理。对超大文档，可委派给隔离子上下文（如 Explore 子代理）先摘要，避免大内容进入主上下文。批量处理可用 for f in *.pdf; do python ~/.claude/lib/document-converter.py "$f"; done。
限制：相关资料未提供安装步骤、收费信息、具体依赖版本和平台支持范围，部分内容暂未提供。