用途:处理 .docx 文件的创建、编辑与分析。.docx 本质是含 XML 的 ZIP 包,可按任务选择不同流程。
主要能力:读取/分析内容(pandoc 转 markdown,或解包读取原始 XML);创建新文档(docx-js);编辑现有文档(Document 库);修订追踪与批注(红线批注工作流);文档转图片(LibreOffice + pdftoppm)。
必要用法:文本提取用 pandoc --track-changes=all path-to-file.docx -o output.md;解包用 python ooxml/scripts/unpack.py <office_file> <output_directory>;打包用 python ooxml/scripts/pack.py <input_directory> <office_file>;转 PDF 用 soffice --headless --convert-to pdf document.docx;转图片用 pdftoppm -jpeg -r 150 document.pdf page。创建新文档前须完整阅读 docx-js.md,编辑前须完整阅读 ooxml.md。
适用场景:创建新文档、修改内容、处理修订追踪、添加批注,以及法律、学术、商业或政府文档的审阅。
限制:修订追踪需按 3-10 个修改分批实现并逐批测试;只标记实际更改文本,保留未更改文本的原始 RSID;不要使用 markdown 行号定位 XML;每次脚本运行后行号会变化,需重新 grep 验证。依赖项包括 pandoc、docx、LibreOffice、Poppler、defusedxml。