SuperAPI AI 工具集

docx

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:创建、读取、编辑和操作 Word 文档(.docx)及 Word 模板(.dotx)。.docx 本质是 XML 文件的 ZIP 归档,需按任务选择方式。

主要能力与用法:新建文档用 docx(npm)脚本,docx 已预装,直接 require('docx'),仅在失败时执行 npm install docx;编辑已有文档需 unzip → 修改 word/document.xml → zip,docx-js 无法打开已有文件;读取内容用 pandoc -t markdown file.docx。旧版 .doc 需先转换:python scripts/office/soffice.py --headless --convert-to docx file.doc。

新建注意事项:默认 A4,US Letter 需设 page: { size: { width: 12240, height: 15840 } };横向需传纵向尺寸加 orientation: PageOrientation.LANDSCAPE;表格需在 table 设 columnWidths 且每个单元格设 width,均用 WidthType.DXA,列宽之和等于表宽;表格底纹用 ShadingType.CLEAR;列表用 numbering 配置与 LevelFormat.BULLET,不要插入 •;ImageRun 需 type;PageBreak 须在 Paragraph 内;不要用 \n,改用独立 Paragraph;目录标题须用内置 HeadingLevel.*;不要用表格作分隔线;点线右对齐用 PositionalTab。

编辑与校验:解压后删除符号链接条目,运行 python scripts/merge_runs.py unpacked/ 合并碎片化 run,就地编辑 document.xml 且不要重排格式,再 zip -Xr 打包,最后用 python scripts/office/validate.py out.docx --original doc.docx 校验,--auto-repair 可修复常见问题。修订需用 <w:ins>/<w:del> 包裹并带 w:id、w:author、w:date,删除文本用 <w:delText>;可用 --author 检查是否遗漏修订标记。接受全部修订用 python scripts/accept_changes.py in.docx out.docx。批注需六个互链文件,用 python scripts/comment.py 生成,并手动放置 commentRangeStart/End 与 commentReference 标记。

验证输出:python scripts/office/soffice.py --headless --convert-to pdf output.docx,再用 pdftoppm -jpeg -r 100 output.pdf page 并查看图片。

依赖:docx(npm,预装)、pandoc、LibreOffice(soffice)、pdftoppm(Poppler)。限制:docx-js 不能打开已有文件;外部来源 docx 不可信;接受修订时段落合并行为在不同工具间存在差异。