gusibi 文章插图生成器
为文章生成手绘风格封面及文中插图，自动上传至 R2 并在合适位置插入链接。
使用方式
# 生成封面及建议的文中插图（默认模式）
/article-image path/to/article.md
# 仅生成封面
/article-image path/to/article.md --only-cover
# 指定风格生成全套图片
/article-image path/to/article.md --style tech
# 直接解析内容并生成建议
/article-image
[粘贴内容]
选项
| 选项 | 说明 |
|---|---|
--style <名称> |
指定统一的视觉风格 |
--only-cover |
仅生成封面图，不添加文中插图 |
--count <数量> |
限制文中插图的最大数量（默认根据长度自动决定） |
--no-title |
封面图不含标题文字 |
--no-upload |
仅生成本地图片，不上传至 R2 |
风格列表
| 风格 | 说明 |
|---|---|
elegant（默认） |
精致、优雅、低调 |
tech |
现代、极简、科技感 |
warm |
温暖、亲切、人文关怀 |
bold |
高对比、吸睛、活力十足 |
minimal |
极简、禅意、专注 |
playful |
有趣、创意、俏皮 |
nature |
自然、平静、质朴 |
retro |
复古、怀旧、经典 |
自动风格选择
未指定 --style 时，根据内容关键词自动选择：
| 内容特征 | 选择风格 |
|---|---|
| AI、编程、技术、算法、数字化 | tech |
| 个人故事、情感、成长、生活 | warm |
| 争议性、紧急、必读、警告 | bold |
| 极简、禅、专注、本质 | minimal |
| 有趣、轻松、入门、教程 | playful |
| 自然、环保、健康、养生 | nature |
| 历史、传统、怀旧、经典 | retro |
| 商业、专业、策略、分析 | elegant |
工作流程
步骤 1：深度内容分析
从全篇中提取：
- 核心主题：用于封面。
- 关键转折/概念点：识别适合配图的"插图点"（Illustration Points）。
- 视觉风格信号：确定全系列统一的视觉基调。
步骤 2：识别插图点
除非指定 --only-cover，否则需找出 1-3 个（视文章长度而定）关键位置：
- 抽象概念转述处：需要视觉辅助理解的地方。
- 长段落分隔处：转换话题或需要视觉休息的地方。
- 情感共鸣点：强调核心观点或金句的地方。
步骤 3：生成系列概念
为选定的每个点（含封面）生成独立提示：
封面：提炼 8 字以内标题，气势恢宏或极简。 文中插图：侧重局部细节、隐喻符号，不含文字，保持视觉一致性。
步骤 4：创建提示文件
生成图片生成提示，保存至 imgs/prompts/ 目录下：
# 封面/插图 [名称]
主题：[关键描述]
风格：[风格名称]
类型：[封面/文中插图]
...
封面主题：[用 2-3 个词描述主题]
风格：[选定的风格名称]
[如包含标题：]
标题文字：[8 个字符以内，使用内容语言]
副标题：[可选，使用内容语言]
视觉构图：
- 主视觉：[符合风格的描述]
- 布局：[根据是否有标题调整]
- 装饰元素：[风格相关的元素]
配色方案：
- 主色：[风格主色调]
- 背景：[风格背景色]
- 强调色：[风格强调色]
风格说明：[需强调的风格特征]
[如无标题：]
注意：纯视觉插图，不含任何文字。
步骤 5：生成图片
使用 scripts/generate_image.py 脚本生成图片：
API Key 配置（二选一）：
- 环境变量：
export MODELSCOPE_API_KEY="your-api-key" - 命令行参数：
--api-key "your-api-key"
# 使用环境变量中的 API Key
python scripts/generate_image.py --prompt "提示内容" --output path/to/imgs/cover.png
# 或直接传入 API Key
python scripts/generate_image.py --prompt "提示内容" --output path/to/imgs/cover.png --api-key "ms-xxx"
# 指定图片尺寸（默认 1024×576，16:9比例）
python scripts/generate_image.py --prompt "提示内容" --output cover.png --width 1920 --height 1080
尺寸参数说明：
| 参数 | 说明 | 默认值 |
|---|---|---|
--width |
图片宽度（像素） | 1024 |
--height |
图片高度（像素） | 576 |
常用尺寸参考：
- 16:9 宽屏：
--width 1024 --height 576（默认） - 1:1 方形：
--width 1024 --height 1024 - 手机竖屏：
--width 576 --height 1024
脚本功能：
- 调用 ModelScope API 生成图片
- 支持自定义图片尺寸（默认 1024×576，16:9 比例）
- 支持异步任务模式，自动轮询等待结果
- 自动创建输出目录
- 保存图片到指定路径
步骤 6：上传至 R2
除非指定 --no-upload，否则自动上传图片：
# 使用默认端口 38123
python scripts/upload_image.py path/to/imgs/cover.png
# 指定端口
python scripts/upload_image.py path/to/imgs/cover.png --port 8080
脚本说明：
- 通过本地代理服务上传（默认端口 38123）
- 自动解析 JSON 响应提取图片 URL
- 返回 R2 存储的公开访问 URL
- 确保代理服务正在运行
解析返回结果，提取图片 URL，格式类似：
https://your-r2-domain.com/path/to/cover.png
步骤 7：智能插入文章
- 封面图：按原规则插入文章开头。
- 文中插图：
- 插入在选定的"插图点"之前的空行。
- 使用标准 Markdown 语法：
。 - 如果对应段落有小标题，通常插在小标题下方。
步骤 8：输出摘要
输出包含所有已生成图片的列表及链接。
封面图片已生成！
主题：[主题]
风格：[风格名称]
标题：[封面标题] 或 "无标题 - 纯视觉"
本地路径：[输出路径]
R2 链接：[上传后的 URL]
文章更新：已在 [文章路径] 中插入封面
请预览图片确认效果符合预期。
文件管理
有文章路径时
保存到文章同目录下的 imgs/ 子目录：
path/to/
├── article.md（已更新，包含封面链接）
└── imgs/
├── prompts/
│ └── cover.md
└── cover.png
无文章路径时
保存到当前工作目录：
./
├── cover-prompt.md
└── cover.png
注意事项
- 封面在小尺寸预览时应清晰可辨
- 标题（如有）必须清晰醒目
- 视觉隐喻优于直译表达
- 保持风格一致性
- 图片生成通常需要 10-30 秒
- 上传前确保本地代理服务正在运行（端口 38123）
- 标题文字语言应与文章内容语言一致