docx

DOCX 技能

用途

提供以编程方式创建和操作 Word 文档的专业能力。使用 python-docx 和 JavaScript 库处理文档生成、模板填充、样式管理和批量文档处理。

适用场景

• 以编程方式生成 Word 文档
• 使用数据填充文档模板
• 修改现有 .docx 文件
• 从 Word 文档中提取内容
• 应用样式和格式
• 创建邮件合并工作流
• 将数据转换为格式化文档

快速入门

在以下情况下调用此技能：

• 以编程方式生成 Word 文档
• 使用数据填充文档模板
• 修改现有 .docx 文件
• 从 Word 文档中提取内容
• 自动化文档工作流

以下情况不要调用：

• 撰写文档内容（使用 document-writer）
• 创建 PDF（使用 pdf-skill）
• 创建电子表格（使用 xlsx-skill）
• 创建演示文稿（使用 pptx-skill）

决策框架

Library Selection:
├── Python backend → python-docx
├── Node.js backend → docx (npm)
├── Browser-based → docx.js
├── Complex templates → docxtemplater
└── Simple text extraction → mammoth

Task Type:
├── Generate from scratch → Build document programmatically
├── Fill template → Use placeholder replacement
├── Modify existing → Load, edit, save
└── Batch processing → Loop with template

核心工作流

1. 文档生成（python-docx）

1. 创建 Document 对象
2. 添加带级别的标题
3. 添加包含文本的段落
4. 应用样式（内置或自定义）
5. 按需添加表格
6. 插入图像
7. 保存文档

2. 模板处理

1. 加载模板文档
2. 查找占位符（{{variable}}）
3. 替换为实际值
4. 处理条件部分
5. 处理重复部分
6. 另存为新文档

3. 批量生成文档

1. 加载一次模板
2. 遍历数据记录
3. 为每条记录复制模板
4. 填充占位符
5. 生成唯一文件名
6. 保存每个文档

最佳实践

• 使用段落样式，而非直接格式设置
• 使用占位符创建可重复使用的模板
• 妥善处理缺失的占位符值
• 保留原始模板，另存为新文件
• 使用复杂内容（表格、图像）进行测试
• 验证输出文件能否正确打开

反模式

反模式	问题	正确做法
直接格式设置	难以维护	使用样式
修改模板	会损坏原始文件	另存为新文件
不进行错误处理	输入无效时会失败	先验证数据
路径硬编码	缺乏可移植性	使用相对路径
忽略编码	字符显示异常	使用 UTF-8 字符串