核心用法
docx 技能提供两条技术路线处理 Microsoft Word 文档：
1. 创建新文档（docx-js）
- 基于 Node.js 的
docx库生成复杂文档结构 - 核心能力：自定义页面尺寸（US Letter/A4）、覆盖内置标题样式、专业列表（禁用 Unicode 项目符号）、双宽表格系统、图像嵌入、页眉页脚、多栏布局、目录生成、脚注、超链接等
- 关键约束：必须显式设置页面尺寸（默认 A4）、表格需同时设置
columnWidths和单元格width、图像必须指定type、分页符必须包裹在段落内
2. 编辑现有文档（XML 级操作）
- 三步流程：Unpack → 编辑 XML → Pack
- 支持修订追踪（插入/删除标记）、批注系统、智能引号转换、运行合并优化
- 使用
comment.py处理批注样板，使用Edit工具直接修改 XML（禁止脚本化）
显著优点
- 格式精确控制：通过原始 XML 编辑实现像素级排版控制，超越普通办公软件的精度
- 批量自动化：适合合同、报告、标书等标准化文档的模板化生成
- 修订追踪完整：支持作者标记、时间戳、嵌套修订（拒绝/恢复他人修订）
- 跨平台兼容：输出符合 OOXML 标准，兼容 Word、Google Docs、LibreOffice
潜在局限
- 技术门槛高：需理解 DXA 单位（1440 = 1 英寸）、XML 结构、OOXML 规范
- 无可视化反馈：错误常表现为文档损坏或渲染异常，调试成本较高
- 依赖外部工具链：需 Node.js/npm、Python、LibreOffice、pandoc、Poppler 协同
- 智能引号陷阱：手动输入直引号在 XML 中可能引发编码问题
适合人群
- 法律/金融行业需批量生成标准化合同的专业人员
- 企业 IT 部门构建文档自动化流水线的开发者
- 需要精确控制文档格式（政府机构、出版社、咨询公司）的技术写作者
- 已熟悉 JavaScript 或愿意学习 OOXML 结构的高级用户
常规风险
- 文档损坏风险：XML 结构错误、ID 冲突、关系缺失会导致文件无法打开
- 格式兼容性问题：
WidthType.PERCENTAGE在 Google Docs 中失效，必须使用 DXA - 修订追踪残留：未正确标记段落删除会导致接受修订后残留空行
- 字体依赖：使用非系统字体时接收方可能出现替代字体渲染
- 图像路径失效：相对路径依赖打包结构，直接移动文件可能破坏引用