核心用法
本 skill 提供两套互补的 Word 文档处理方案:
1. 新建文档:使用 docx-js 库(Node.js)程序化生成 .docx 文件,支持段落、表格、图片、页眉页脚、目录等完整功能
2. 编辑现有文档:通过解包→编辑 XML→重新打包的三步流程,实现精细化的内容修改、修订追踪和批注管理
显著优点
- 格式控制精确:明确指定 US Letter/A4 页面尺寸、DXA 单位(避免百分比在 Google Docs 中失效)、智能引号等专业排版细节
- 修订追踪完整:支持插入、删除、批注、回复等 tracked changes 操作,可接受或拒绝他人修订
- 多格式互转:内置 pandoc 文本提取、LibreOffice PDF 转换、pdftoppm 图片生成等工具链
- 模板化生成:通过 JavaScript 代码可批量生成标准化文档(合同、报告、信函等)
潜在缺点与局限性
- 技术门槛较高:新建文档需编写 JavaScript 代码,编辑文档需理解 OOXML 结构
- .doc 格式不支持:旧版 .doc 需先转换,增加一步操作
- 中文排版限制:文档未针对中文特性(如首行缩进、竖排)做特殊说明
- 依赖外部工具:需预装 pandoc、LibreOffice、Node.js/npm 等环境
适合人群
- 开发者/技术用户需自动化生成大量结构化文档
- 法律、金融领域需程序化修改合同模板并保留修订记录
- 企业 IT 部门搭建文档自动化流水线
常规风险
- XML 格式错误:手动编辑 XML 时元素顺序错误、缺少命名空间会导致文档损坏(skill 提供 validate.py 自动修复部分问题)
- 样式继承混乱:未正确覆盖内置样式(Heading1/Heading2)或缺少 outlineLevel 会导致目录生成失败
- 图片/表格渲染不一致:未按规范设置 type、width、ShadingType.CLEAR 等参数可能在不同阅读器显示异常