用途:创建、读取、编辑和操作 Word 文档(.docx 文件)。.docx 是包含 XML 文件的 ZIP 归档。
主要能力与用法: 读取/分析内容可用 pandoc(如 pandoc --track-changes=all document.docx -o output.md)或解包获取原始 XML。旧版 .doc 需先转换:python scripts/office/soffice.py --headless --convert-to docx document.doc。转换为图片可先转 PDF 再 pdftoppm;接受修订可用 python scripts/accept_changes.py input.docx output.docx。
创建新文档:安装 npm install -g docx,用 docx-js 生成,随后用 python scripts/office/validate.py doc.docx 验证。需显式设置页面尺寸(默认 A4),表格使用 DXA 宽度并同时设置 columnWidths 与单元格宽度,避免使用百分比;列表用 LevelFormat.BULLET,不要手动插入 Unicode 项目符号。
编辑现有文档:三步走——解包(python scripts/office/unpack.py document.docx unpacked/)、编辑 unpacked/word/ 下的 XML、打包(python scripts/office/pack.py unpacked/ output.docx --original document.docx)。修订与评论以 Claude 为作者,除非用户另有要求;使用智能引号 XML 实体;替换整个 w:r 元素而非在内部注入修订标签。
适用场景:需要程序化生成或批量修改 Word 文档、处理修订与评论、转换文档格式等。
限制:未提供收费、价格等信息;部分操作依赖 LibreOffice、pandoc、pdftoppm 等外部工具;打包时自动修复仅覆盖部分 XML 问题,无法修复格式错误、无效嵌套、缺失关系或模式违规。