用途
Word Document Creator 技能提供以编程方式生成 Microsoft Word（.docx）文档的完整能力，使用 Node.js 的 docx 库处理格式化、样式、表格、图片、页眉、页脚和复杂版式。它适用于自动化文档生成、报告创建和基于模板的工作流，可创建从简单信函到包含表格、图表、图片和自定义样式的复杂报告，并支持从头创建与基于模板的生成（含变量替换）。
主要能力
该技能覆盖以下核心工作流：
-
从头创建格式化文档：导入 docx 库并创建 Document 实例，定义标题、正文、列表样式，添加带页眉页脚的节，创建带格式（加粗、斜体、颜色、对齐）的段落，添加编号和项目符号列表，插入带格式的表格，导出为 .docx 文件。
-
从模板生成文档：使用 pizzip 和 docxtemplater 加载模板 .docx 文件，定义替换值的数据对象，将数据设置到模板，渲染替换，处理重复节的循环（表格、列表），处理图片和条件节，导出最终文档。模板占位符形如 {clientName}、{projectName}，循环语法形如 {#items}{name} - {price}{/items}。
-
创建含表格和图片的文档：创建 Document 实例，定义行列组成的表格，设置单元格格式（边框、底纹、对齐），添加加粗表头，填充数据行，插入带尺寸和定位的图片，为图片添加题注，导出文档。
-
批量生成文档：加载数据源（JSON、CSV、数据库），加载文档模板，对每条记录创建新文档实例、填充数据、应用格式、以唯一文件名保存，跟踪每个文档的成功/失败并生成汇总报告。
-
添加高级格式：定义自定义样式，创建样式层级（标题级别、正文、题注），设置字体族、字号、颜色，配置段落间距和缩进，设置页边距和方向，添加页码和分节符，应用主题和配色方案。
使用方式
安装依赖：
npm install docx docxtemplater pizzip
高级功能的可选依赖：
npm install docx-templates # 替代模板方案
npm install officegen # 旧版支持
快速参考（触发方式）：
- 创建新文档："create word document [name]"
- 从模板生成："generate docx from template [file]"
- 添加表格："add table with [rows] rows to [doc]"
- 插入图片："insert [image] into word doc"
- 批量生成："create word docs for each [data]"
- 应用样式："format word doc with [style]"
- 添加页眉/页脚："add header [text] to document"
- 创建目录："generate table of contents"
适用场景
- 自动化文档生成与报告创建
- 基于模板的合同、报告、信函等重复文档类型
- 邮件合并（如按联系人批量生成个性化信函）
- 会议纪要等结构化文档
- 包含数据表格与嵌入图片的复杂文档
限制与注意事项
资料中未提供关于收费、价格、平台支持范围、效果保证等信息。使用时应遵循以下最佳实践：优先使用样式而非直接格式化；对重复文档类型使用模板；在创建早期设置页边距、方向和页面大小；使用表格样式；嵌入前压缩图片并使用适当分辨率（150-300 DPI）；保持页眉页脚简单一致；监控文档大小；面向广泛受众时在不同 Word 版本中测试；模板替换前验证输入数据；优雅处理缺失的模板占位符；对演进的文档类型使用模板版本控制；使用正确的标题层级和图片替代文本以保证可访问性。错误处理方面需注意：处理前验证模板结构、为可选字段提供默认值、嵌入前检查图片文件存在性、优雅处理写入权限错误、大文档考虑流式处理、确保国际字符使用正确的 UTF-8 编码。性能方面可复用样式定义、预加载模板、对大文档使用流式处理、嵌入前压缩图片、批量文件系统操作、尽可能缓存已编译模板。