SuperAPI AI 工具集

docx

办公与效率

查看项目

更新于 10-15 17:19

技能介绍

用途:处理 Word 文档(.docx)与模板(.dotx)的创建、读取、编辑和操作。

主要能力与用法:

  • 新建文档:编写 docx(npm)脚本,docx 已预装,直接 require('docx'),仅在失败时执行 npm install docx。注意页面默认 A4,US Letter 需设 page: { size: { width: 12240, height: 15840 } };横向用 PageOrientation.LANDSCAPE;表格需同时设 columnWidths 与单元格 width(WidthType.DXA);底纹用 ShadingType.CLEAR;列表用 LevelFormat.BULLET;ImageRun 需 type;PageBreak 须在 Paragraph 内;换行用独立 Paragraph;目录标题须用内置 HeadingLevel.*。
  • 读取内容:pandoc -t markdown file.docx。
  • 编辑已有文档:docx-js 无法打开已有文件,需 unzip → 编辑 word/document.xml → zip。旧版 .doc 先转 docx:python scripts/office/soffice.py --headless --convert-to docx file.doc。解包后删除符号链接,运行 python scripts/merge_runs.py unpacked/ 合并碎片化 run,再原地编辑 XML,最后 zip -Xr 打包并用 python scripts/office/validate.py out.docx --original doc.docx 校验。
  • 修订追踪:用 <w:ins>/<w:del> 包裹 run,删除文本用 <w:delText>;校验加 --author 检查未追踪的改动;接受修订可用 python scripts/accept_changes.py in.docx out.docx。
  • 批注:用 python scripts/comment.py 生成六个关联文件,并手动放置 commentRangeStart/End/Reference 标记。
  • 校验输出:转 PDF 后 pdftoppm -jpeg -r 100 output.pdf page 并查看图片。

依赖:docx(npm,预装)、pandoc、LibreOffice(soffice)、pdftoppm(Poppler)。

限制:docx-js 不能打开已有文件;外部来源 docx 视为不可信;XML 编辑不要重新格式化;接受修订工具在段落合并上存在已知差异。