安全扫描（ClawHub）

• VirusTotal ：良性
• OpenClaw ：良性

OpenClaw 评估

The skill's code and runtime instructions match its stated purpose (generating .docx files with AI footer) and request no unrelated credentials, installs, or system access.

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「docx-generator」。简介：创建包含 AI 生成页脚的 Microsoft Word (.docx) 文档。当用户需要编程方式生成 Word 文档时调用，支持标题、段落、列表、表格、代码…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/983488728/docx-generator/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
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       # 核心实现
```

## 使用方法

### 快速开始

```python
from scripts.docx_generator import create_simple_document

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

### 创建报告

```python
from scripts.docx_generator import create_report

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

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

### 高级用法（链式调用）

```python
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"))
```

### 样式控制

```python
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

安装方式：
```bash
pip install python-docx
```

## 示例

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

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

## 版本

2.0.0