连环画生成器

每页一幅画、底部配文字，生成完整连环画故事。

概述

连环画是中国传统叙事形式，每页包含：

• 上方：一幅完整插图（约占页面 80%）
• 下方：一段叙述文字（约占页面 20%），清晰排版，不嵌入图片中

连环画注重单幅完整场景和文字叙事的配合。

图片生成工具

本技能使用 zhz-image-gen 作为图片生成后端。

调用方式：

python ~/.openclaw/workspace/skills/zhz-image-gen/scripts/main.py \
  --promptfiles prompts/NN-page-[slug].md \
  --image illustrations/NN-page-[slug].png \
  --ar 3:4 \
  --quality 2k

⛔ 禁止用 SVG、HTML、Canvas 等代码渲染替代光栅图片生成。

提示词文件要求（硬性）：在调用任何后端之前，必须先将每页的完整提示词写入独立文件 prompts/NN-page-[slug].md。

脚本目录

{baseDir} = 本 SKILL.md 所在目录。所有 scripts/... 路径均相对于 {baseDir}。

Python 环境：需要 Pillow 和 fpdf2 库。如果缺失，先安装：

pip install Pillow fpdf2

参数选项

文件结构

输出目录：picture-story/{主题简称}/

页面布局规范

每页最终布局如下：

┌─────────────────────────────┐
│                             │
│                             │
│         插图区域             │  ← 占页面高度的 (1 - text_ratio)
│       （AI生成的图片）       │
│                             │
│                             │
├─────────────────────────────┤
│    文字说明 / 旁白           │  ← 占页面高度的 text_ratio
│      （清晰排版的文字）       │ 
└─────────────────────────────┘

• 插图区域：AI 生成的图片，不在图上叠加任何文字
• 文字区域：纯色背景（默认白色），清晰排版
• 字体：中文用衬线体（宋体/Noto Serif CJK），英文用无衬线体
• 字号：自动适配区域，最小 14px，行距舒适
• 分隔线：插图与文字之间有一条细线

工作流程

进度检查表

连环画进度：
- [ ] 步骤 1：故事规划
- [ ] 步骤 2：确认 ⚠️ 必须
- [ ] 步骤 3：生成故事板 + 角色定义
- [ ] 步骤 4：生成提示词
- [ ] 步骤 5：生成插图
- [ ] 步骤 6：合成页面（插图 + 文字）
- [ ] 步骤 7：合并为 PDF
- [ ] 步骤 8：完成报告

步骤 1：故事规划

分析用户提供的故事/主题：

1. 提取核心叙事弧线（开端 → 发展 → 高潮 → 结局）
2. 将故事拆分为连续场景（每页一个场景）
3. 确定页数（用户指定或根据故事复杂度推荐）
4. 检测源语言和输出语言
5. 将故事大纲写入 storyboard.md

步骤 2：确认 ⚠️ 必须

向用户展示：

• 故事标题和推荐页数
• 画风 + 画面基调（根据内容推荐）
• 每页场景简介
• 角色列表

询问用户（合并所有问题）：

1. 画风确认：使用哪种视觉风格？（显示推荐项 + 备选）
2. 审阅模式：生成前先审阅故事板？还是直接生成？

步骤 3：生成故事板 + 角色定义

1. 完善 storyboard.md，包含详细的场景描述和每页文字说明
2. 创建 characters.md，包含重复出现角色的视觉定义
3. 保存两个文件

storyboard.md 格式：

---
title: "故事标题"
topic: "主题简称"
page_count: N
art_style: "画风"
tone: "画面基调"
aspect_ratio: "3:4"
language: "zh"
generated: "YYYY-MM-DD"
---

# 故事标题 - 连环画故事板

## 第 1 页：场景标题
**文件名**：01-page-[slug].png
**场景**：[画面的视觉描述——插图展示什么]
**角色**：[出场人物]
**文字说明**：[页面底部的叙述文字]

## 第 2 页：场景标题
...

characters.md 格式：

# 角色定义 - 故事标题

## 角色名
- **角色**：主角/反派/配角
- **外貌**：[详细视觉描述]
- **服装**：[服装细节，含具体颜色和十六进制色值]
- **标志性特征**：[独特的视觉标记]

步骤 4：生成提示词

为每页创建提示词文件 prompts/NN-page-[slug].md：

# 第 NN 页：场景标题

## 视觉风格
画风：[style] | 画面基调：[tone]

## 角色参考
[从 characters.md 提取相关角色描述]

## 场景描述
[详细的画面视觉描述]

## 生成提示词
[组合好的英文提示词——包含画风关键词、场景构图、角色、动作、环境、光线、色彩。
不要在图片中包含任何文字/词语/标签。]

提示词编写规则：

• 生成提示词用英文编写，以获得最佳 AI 图片质量
• 在提示词开头包含画风关键词
• 描述场景构图、角色、动作、环境、光线
• 包含角色一致性细节（外貌、服装颜色含十六进制色值）
• 不要在图片提示词中包含任何文字、词语、标签或说明——文字只出现在底部文字区域
• 结尾加上宽高比和画质关键词

步骤 5：生成插图

逐页生成图片：

• 使用已配置的图片后端
• 保存原始插图到 illustrations/NN-page-[slug].png
• 宽高比按故事板设定
• 默认单线程顺序生成；设置 --batch-size 可批处理
• 如果生成失败，重试一次；仍失败则跳过并在报告中注明
• 插图中绝不包含任何文字

步骤 6：合成页面（插图 + 文字）

使用 {baseDir}/scripts/composite-page.py 合成每页：

python {baseDir}/scripts/composite-page.py \
  --image illustrations/01-page-[slug].png \
  --text "页面底部的文字说明内容" \
  --output pages/01-page-[slug].png \
  --text-ratio 0.20 \
  --aspect 3:4

脚本功能：

1. 读取原始插图
2. 创建画布，按页面尺寸
3. 在上方区域绘制插图
4. 在下方区域填充纯色背景
5. 排版文字说明（自动换行、自动字号）
6. 保存最终合成页面

步骤 7：合并为 PDF

python {baseDir}/scripts/merge-to-pdf.py picture-story/{主题简称}/

页面按数字顺序合并。每页成为 PDF 的完整页面。

步骤 8：完成报告

连环画完成！
标题：[title] | 画风：[art] | 画面基调：[tone] | 页数：[count]
位置：picture-story/{主题简称}/
✓ storyboard.md
✓ characters.md
✓ illustrations/（原始插图）
✓ pages/（最终页面含文字）
✓ {主题简称}.pdf

画风

卡通

画面基调

文字说明写作指南

文字说明是每页底部的叙述文字。详细范例见 references/caption-examples.md。

规则：

• 长度：1-3 句话，20-80 个汉字
• 风格：叙述者视角，像说书人一样描述画面中的事件
• 内容：提供画面之外的信息（心理活动、因果关系、时间推进）
• 避免重复：不要只描述图中已有的内容

好的写法："悟空举棒便打，白骨精惨叫一声，化作一缕青烟逃去。唐僧见状大怒：'你这泼猴，又伤人性命！'" 不好的写法："这一页画的是悟空在打架。"（太简短，无叙事价值） 不好的写法：[500 字长篇描述]（太长，放不下）

角色一致性

多页故事中有重复出现的角色时：

1. 在 characters.md 中定义每个角色的视觉外观，包含具体颜色（十六进制色值）
2. 在每页的生成提示词中包含关键视觉特征
3. 跨所有页面使用一致的颜色代码
4. 如果后端支持参考图（--ref），可先生成角色参考图

错误处理

注意事项

• 图片生成：每页 15-30 秒
• 文字绝不作为图片的一部分生成——始终单独合成以保证排版清晰
• 所有生成提示词用英文编写以获得最佳图片质量；文字说明用用户选择的语言
• 默认 10 页；用户可要求更多或更少（范围 3-30 页）
• 插图提示词中不得包含任何文字渲染指令