用途:创建、编辑和分析 .docx 文件。.docx 本质是包含 XML 与资源的 ZIP 包,可按任务选择不同工具与流程。
主要能力:文本提取(用 pandoc 转 markdown,支持 --track-changes=accept/reject/all 查看修订);原始 XML 访问(批注、复杂格式、结构、嵌入媒体、元数据);新建文档(用 docx-js,Document/Paragraph/TextRun,Packer.toBuffer() 导出);编辑现有文档(用 Python Document 库操作 OOXML);修订追踪(redlining)工作流,用 <w:ins>/<w:del> 标记增删,建议每批 3-10 处改动并逐批验证;文档转图片(soffice 转 PDF,pdftoppm 转 JPEG)。
必要用法:解包 python ooxml/scripts/unpack.py <office_file> <output_directory>;打包 python ooxml/scripts/pack.py <input_directory> <office_file>;转 markdown pandoc --track-changes=all path-to-file.docx -o output.md;转 PDF soffice --headless --convert-to pdf document.docx;转图片 pdftoppm -jpeg -r 150 document.pdf page。新建与编辑前须完整阅读 docx-js.md 或 ooxml.md。
适用场景:读取分析文档、从零生成 Word 文件、修改自有或他人文档、法律/学术/商业/政府文档审阅(要求使用 redlining 工作流)、可视化分析。
限制:依赖 pandoc、docx、LibreOffice、Poppler、defusedxml 等外部工具;修订需按批次系统实施并最终校验;markdown 行号不能映射 XML 结构,定位需用章节号、段落标识或唯一文本 grep。