long-article-illustration

# 长文配图助手

为长篇文章自动生成配图，包括智能段落划分、配图提示词生成、图像生成调用。

## 工作流程

```
用户上传长文 → 段落划分 → 提示词生成 → 图像生成 → 输出交付
```

## Step 1: 收集输入

向用户确认以下信息：

| 参数 | 必填 | 默认值 | 说明 |
|------|------|--------|------|
| 文章内容 | ✅ | - | 完整文章文本 |
| 图片风格 | ❌ | 扁平插画 | 见 `references/style-presets.md` |
| 图片比例 | ❌ | 16:9 | 公众号内文建议16:9，封面2.35:1 |
| 配图密度 | ❌ | 每2-3段一图 | 可选：每段一图/每小节一图 |

## Step 2: 段落划分

按以下优先级划分：

1. **显式标题**：识别 `#`、`##`、`一、`、`1.` 、`（1）`、`（一）`、`1️⃣`、`①`等标题标记
2. **语义边界**：主题转换、时间跳跃、场景切换
3. **长度均衡**：单个配图覆盖300-600字为宜

输出格式：
```
【段落1】标题/摘要
正文内容...

【段落2】标题/摘要
正文内容...
```

## Step 3: 生成配图提示词

为每个需要配图的段落生成提示词，遵循以下结构：

```
[主体描述], [场景/背景], [风格关键词], [技术参数]
```

### 提示词生成规则

1. **提取核心意象**：从段落中识别最具画面感的元素
2. **避免抽象概念**：将抽象概念转化为具象画面
3. **保持风格一致**：全文配图使用统一的风格关键词，特别是出现了人物或角色的图片，需要保持是同一个人物
4. **添加技术参数**：比例、光线、构图等
5. **不要出现文字**：在提示词中，需要强调最终生成的图片不要包含任何文字

风格预设详见 `references/style-presets.md`

### 示例

段落内容：
> 创业初期，我们挤在一间不到20平米的小办公室里，每天工作到深夜...

生成提示词：
> A small crowded office space with desks and computers, warm lamplight at night, papers and coffee cups scattered around, flat illustration style, warm color palette, 16:9

## Step 4: 调用图像生成

根据生成的提示词，调用图像生成模型完成配图。

**支持的生图方式**：
- 调用已配置的 AI 生图 API（如 DALL-E、Midjourney、Stable Diffusion 等）
- 将提示词复制到在线生图工具手动生成
- 使用本地部署的生图模型

> 💡 用户可根据自身需求选择生图工具，并自行配置对应的 API

## Step 5: 输出交付

### 输出格式选项

**选项A：Markdown文档（默认）**
```markdown
# 文章标题

![配图1](image1.png)
第一段正文内...

# 长文配图助手 (Long Article Illustration)

为长篇文章自动生成 AI 配图的 Skill 配置文件。

## ✨ 功能特性

- **智能段落划分**：自动识别文章结构，按语义边界划分配图段落
- **提示词生成**：为每个段落生成高质量的图像生成提示词
- **多风格支持**：扁平插画、水彩、卡通、国风水墨、科技感、极简线条
- **人物一致性**：通过角色锚定描述保持同一人物外观一致
- **避免图片文字**：自动添加参数避免生成的图片出现乱码文字

## 📁 文件结构

```
├── SKILL.md                    # 主配置文件，定义完整工作流程
├── references/
│   ├── style-presets.md        # 6种图片风格预设及提示词模板
│   ├── paragraph-rules.md      # 段落划分详细规则
│   └── troubleshooting.md      # 常见问题处理方案
└── preview/                    # 效果预览案例
    ├── 校园主题文章_配图效果.pdf
    ├── 职场主题文章_配图效果.pdf
    └── 案例*.png
```

## 🚀 使用方法

1. 将 `SKILL.md` 及 `references/` 文件夹导入支持 Skill 的 AI 助手
2. 向 AI 提供需要配图的长文章
3. 可选参数：
   - **图片风格**：默认扁平插画
   - **图片比例**：默认 16:9
   - **配图密度**：默认每 2-3 段一图

## 🎨 支持风格

| 风格 | 适用场景 |
|------|----------|
| 扁平插画 | 科技、商业、教程 |
| 水彩风格 | 情感、文艺、生活 |
| 卡通风格 | 轻松、幽默、儿童 |
| 国风水墨 | 传统文化、古典 |
| 科技感 | AI、数据、未来 |
| 极简线条 | 高端、简约、商务 |

## 📐 支持比例

| 用途 | 比例 |
|------|------|
| 公众号封面 | 2.35:1 |
| 公众号内文 | 16:9 |
| 小红书配图 | 3:4 |
| 正方形 | 1:1 |

## 📸 效果预览

| | |
|:---:|:---:|
| ![案例1](preview/案例1.png) | ![案例2](preview/案例2.png) |
| ![案例3](preview/案例3.png) | ![案例4](preview/案例4.png) |

## 📄 许可证

本项目采用 [MIT 许可证](LICENSE) 开源。


# Long Article Illustration Assistant

An AI Skill configuration for automatically generating illustrations for long-form articles.

## ✨ Features

- **Smart Paragraph Segmentation**: Automatically identifies article structure and divides content by semantic boundaries
- **Prompt Generation**: Creates high-quality image generation prompts for each paragraph
- **Multiple St...