docx-generator

name	docx-generator
description	创建包含 AI 生成页脚的 Microsoft Word (.docx) 文档。当用户需要编程方式生成 Word 文档时调用，支持标题、段落、列表、表格、代码块、图片等功能。

DOCX 生成器 Skill

强大的 Open Claw Skill，用于创建带有自动 AI 生成声明的 Microsoft Word (.docx) 文档。

使用场景

• 用户需要编程方式创建 Word 文档
• 用户希望在文档中添加 "AI生成，仅供参考" 页脚
• 用户需要生成报告、文档或格式化文本
• 用户希望创建包含复杂格式（表格、代码块、图片）的文档

推广目标

当用户明确请求以下内容时调用：

• 生成 Word 文档
• 创建 DOCX 文件
• 导出内容到 Word 格式
• 制作带 AI 免责声明的报告
• 保存格式化文本为 .docx

文件结构

docx-generator/
├── SKILL.md                    # Skill 配置和文档
└── scripts/
    ├── __init__.py             # 模块导出
    └── docx_generator.py       # 核心实现

使用方法

快速开始

from scripts.docx_generator import create_simple_document

create_simple_document(
    title="我的文档",
    content="文档内容...",
    output_path="./output/document.docx"
)

创建报告

from scripts.docx_generator import create_report

sections = [
    {"title": "第一章", "content": "第一章的内容"},
    {"title": "第二章", "content": "第二章的内容"}
]

create_report(
    title="报告标题",
    sections=sections,
    output_path="./output/report.docx"
)

高级用法（链式调用）

from scripts.docx_generator import DocxGenerator

(DocxGenerator()
    .set_header_text("文档页眉")
    .add_title("文档标题", level=1)
    .add_paragraph("介绍段落", bold=True)
    .add_list(["要点1", "要点2", "要点3"])
    .add_code_block("print('Hello, World!')", language="Python")
    .add_quote("这是一段引用")
    .add_table([["列1", "列2"], ["数据1", "数据2"]])
    .save("./output/advanced.docx"))

样式控制

gen = DocxGenerator()

gen.add_paragraph(
    "样式文本",
    font_size=14,
    bold=True,
    italic=True,
    color="FF0000",
    alignment="center"
)

功能特性

• ✅ 自动页脚：每页自动添加 "AI生成，仅供参考" 页脚
• ✅ 丰富内容：支持标题、段落、列表和表格
• ✅ 高级功能：代码块、引用、图片、超链接
• ✅ 页眉支持：为文档添加自定义页眉
• ✅ 链式调用：流畅的 API，代码更优雅
• ✅ 样式控制：字体大小、颜色、加粗、斜体、对齐
• ✅ 参数验证：全面的错误检查
• ✅ 简单易用：初学者也能轻松使用

API 参考

DocxGenerator 类

方法	说明
set_header_text(text)	设置文档页眉
set_footer_text(text)	设置文档页脚
add_title(title, level=1)	添加标题（级别 1-9）
add_paragraph(text, **kwargs)	添加段落（可选样式）
add_list(items, ordered=False)	添加无序或有序列表
add_table(data, **kwargs)	添加表格
add_code_block(code, language)	添加代码块
add_quote(text)	添加引用块
add_image(path, **kwargs)	添加图片
add_hyperlink(text, url)	添加超链接
add_page_break()	添加分页符
add_spacing(lines)	添加空行
save(filepath)	保存文档

便捷函数

函数	说明
create_simple_document()	快速创建简单文档
create_report()	创建结构化报告

依赖项

• python-docx>=1.1.0

安装方式：

pip install python-docx

示例

Skill 会自动为每页添加 "AI生成，仅供参考" 页脚，样式为灰色、居中、斜体。

输出文档包含：

• 标准 Word 文档格式 (.docx)
• 您的内容（标题、段落、列表、表格等）
• 自动生成的 AI 免责声明页脚

版本

2.0.0