novel-to-manga
把一部小说转成漫画书:阅读小说拆解人物、场景、世界观设定,生成设定图,把章节剧情拆成漫画分镜,再以设定图为参考逐页生成带对话框文字的漫画页(日漫或国漫风格)。用户给出小说并要求"转漫画""漫画化""小说改编漫画""出设定图/分镜/漫画页"时使用;单张插画、封面图或短剧视频分镜不适用。
SKILL.mdSKILL.md
GitHub小说转漫画
把一部小说变成一本可翻阅的漫画。四个阶段串行,每阶段产物落在固定工程目录, ID 互相引用,中途可断点续跑。
单章原则(硬性)
每次任务只做一章的分镜与漫画页。
- 用户点名章节(如"做第 3 章")就只做该章;没点名时默认从第 1 章开始(或问用户)。
- 一章完成即停靠,向用户交付本章页面清单;不自动续做下一章,等用户点章。
- 设定(S1/S2)是工程基建:第一次建立,之后跨章复用;后续章节出现新角色/新场景时按需补卡、补图,不重做全书分析。
前瞻阅读原则(硬性,防张冠李戴)
只读当前章就拆设定,必然把"后文才揭示身份"的角色张冠李戴。
- 做第 N 章前,至少读到第 N+20 章;首次开工至少普查前 30 章。
- 读完立即建《角色出场总表.md
》(01-设定/角色出场总表.md`): 角色档案卡(真实身份/变身形态/首次点名章节/设定图状态)+逐章出场矩阵+设定图补录计划。 - 身份以"首次点名章节"为准:无名角色先挂"待确认"标签,禁止提前绑定已知名; 同一外形描述(蓝发/法杖/蓬蓬裙)可能属于不同角色,形似≠同一人。
- 亲属代称("妹妹/少年/少女")在点名前单独按代称建档,点名后再合并。
- 新角色要先补设定图(S2)再进分镜(S3);补录优先级:当前章需要 > 未来 3 章内 > 远期提及。
- 设定图状态精确到形态:同一角色的每个形态/年龄段都是独立的设定图需求 (如"角色X:魔法少女形态✅ / 幼年便服❌")。总表里角色级的一个 ✅ 不代表全部形态已补齐。
- 缺图即停(硬性):S3 发现任何将被画到的角色/形态/场景没有设定图,禁止用 "只画背影/局部/虚焦"等理由绕过,必须先回 S2 补图并在停靠汇报里列为 P0 缺口, 经用户确认后才能继续拆分镜。
- 描述考古(出设定图前必做):为任何角色/形态出设定图前,先全文检索该角色的 全部描写——含本名、别名、代称、变身名,把散落在各章的外貌、服装、气质描述汇总成 「描述档案」(写入角色档案卡),确保前后文是同一个人的同一定义;设定图提示词只能 从描述档案取材,禁止凭印象补特征。方法见 character-tracking-guide.md。
- 留白属性禁止自动补全(硬性):原著未描写的属性(发色/瞳色等)在描述档案中标注 "留白",出图暂停,由用户从候选项中拍板后才可写入设定图。两条禁忌: 禁止用"与已生成页面一致"作补全依据——无设定图时代的生成页面本就是无据自由发挥, 拿它锚定=循环论证;禁止模型以"合理推测"名义静默定值(典型事故:某角色原生发色 原著留白,早期页面在无参考图时误借已出场角色的配色,设定图反向锚定后两个角色剪影相撞)。
工程目录规范
每本小说一个独立工程。工程根目录默认建在当前工作目录下,命名 <小说名>-漫画工程/。
用 python3 {技能目录}/scripts/init_project.py "<小说名>" 一键创建,结构如下:
<小说名>-漫画工程/
├── 原著/ # 创作者输入,只读
│ └── 原文.txt
├── 01-设定/
│ ├── 设定总表.md # 人物卡 / 场景卡 / 世界观 / 画风基准,全部带章节出处
│ ├── 角色出场总表.md # 档案卡+逐章出场矩阵+设定图补录计划(前瞻阅读产物)
│ ├── 伏笔与关键道具表.md # 伏笔/关键道具:埋设章页→回收章页(契诃夫之枪登记处)
│ └── 设定图/
│ ├── 人物/ # CHAR-<角色名>-<类型>.png
│ └── 场景/ # LOC-<场景名>-<视角或时段>.png
├── 02-分镜/
│ └── CH<章号>/ # 如 CH001/
│ ├── 节拍表.md # S3 第一交付物:逐拍列剧情节拍,页数由它推导
│ ├── 分镜脚本.md # 页 → 格 → 镜头表,每格引用设定图 ID
│ ├── 检查清单.md # 每页引用的设定图/机位图 ID 清单(S4 参考图校验依据)
│ └── prompts/ # 每页提示词文件 CH001-P001.md(改页先改此文件再重生)
├── 03-漫画页/
│ └── CH<章号>/
│ └── CH<章号>-P<三位页号>.png
├── 04-成书/ # 可选:PDF 合并交付
└── 生成日志.md # 每张图的提示词、参考图、状态,断点续跑依据
各阶段文档在该阶段开始时由执行者创建(S1 建两表、S3 建节拍表/检查清单);
init_project.py只建目录骨架与初始文件,不要求初始化时一次建全。
ID 规范(一旦建立不得改名,跨文档引用全靠它):
- 人物设定图:
CHAR-<角色名>-三视图 | 表情集 | <服装/状态变体> - 场景设定图:
LOC-<场景名>-<视角或时段> - 分镜格:
CH001-G03-02= 第 1 章第 3 页第 2 格 - 漫画页:
CH001-P003
已有工程时读 生成日志.md 从断点继续,不要重建目录、不要重跑已完成阶段。
流程与停靠点
| 阶段 | 范围 | 做什么 | 产出 | 停靠 |
|---|---|---|---|---|
| S1 | 全书一次,跨章复用 | 读小说,拆人物/场景/世界观,定画风 | 设定总表.md |
确认设定与画风后才进入 S2 |
| S2 | 首次建立 + 按需补 | 生成人物/场景设定图 | 设定图/ 下全部 PNG |
给用户过目,不满意重roll |
| S3 | 单章 | 节拍表落盘 → 点名章节剧情 → 漫画分镜 → 检查清单落盘 | 02-分镜/CH<章号>/ 下 节拍表.md、分镜脚本.md、检查清单.md |
确认分镜后才批量出页 |
| S4 | 单章 | 该章逐页生成漫画(按检查清单自动传参考图 + 文字内嵌) | 03-漫画页/CH<章号>/ |
出页前按检查清单校验参考图,缺图即停;跑完本章即停 |
页级重生:用户对某页不满意时,先改 prompts/CH<章号>-P<页号>.md,再单页重生;
旧图改名 *-backup-YYYYMMDD-HHMMSS.png 保留,不删除。全章完成后可把页面按序合并 PDF 放 04-成书/。
出图花钱,三个停靠点是硬性的;用户明确说"一路跑到底"时,可把 S1–S3 合并为一次性确认, S4 仍逐页落日志。
一致性铁律
- 设定图先行,且精确到形态:漫画页里每个被画到的角色/形态必须已有对应设定图; 角色有设定图但该形态没有(如只有成年形态、缺幼年形态)同样算缺图,先回 S2 补图。
- 身份核实先行:分镜前对照《角色出场总表》核实本章每个角色的身份与设定图;后文才揭示的身份不得提前使用。
- 每页必带参考,清单机读:S3 检查清单里每页列出引用的全部设定图/机位图 ID; S4 生成某页前按该清单传参考图,传入前逐项比对——清单里有而没传 = 违规, 禁止手工凭记忆配参考图。
- 伏笔必须闭环:关键道具/伏笔(跨章才回收的"枪")登记进《伏笔与关键道具表》; 埋设页必须真的画出"持有/藏匿"动作,回收页必须画出"取出/兑现"动作——两端缺一,观众看到的就是凭空道具。
- 文字逐字:台词和旁白用原文逐字写入提示词,标明所属气泡;提示词加"文字铁律"(禁止自创台词、 禁止 ①②③④ 序号徽章入画);生成后拼总览图(压到 ≤1MB JPEG 再目检,防请求超限)逐页放大校对。
- 画风基因唯一:画风从小说自身推导为「风格基因」(五维:线条/上色/色彩/构图气质/媒介质感), 写在《设定总表.md》的「画风基准」段,所有出图提示词原样复用,禁止逐页即兴改风格。 彩漫 / 黑白漫(网点涂黑)必须由用户在 S1 选定。去 AI 味是硬要求:负面词清单、不完美注入、 媒介质感锚见 style-guide.md。
阶段指南
按需读取,一次只读当前阶段的一份:
- S1 拆解方法:analysis-guide.md
- 前瞻阅读与角色出场总表:character-tracking-guide.md
- 节拍表与伏笔追踪:foreshadow-tracking-guide.md
- 风格预设库(基底×基调×题材特殊规则):style-presets.md
- 风格基因文档模板:style-dna-template.md
- 风格基因与去AI味:style-guide.md
- S2 设定图提示词配方:design-sheet-guide.md
- S3 分镜拆解方法:storyboard-guide.md
- S4 漫画页生成与文字内嵌:page-generation-guide.md
- 漫画页基础提示词(每页必带):page-base-prompt.md
一次任务的典型请求
用户:把 D:\books\xxx.txt 转成漫画,先做第 1 章
执行:建工程 → S1 全书拆设定(确认画风)→ S2 出本章涉及角色的设定图(确认)
→ S3 拆 CH001 分镜(确认)→ S4 出 CH001 全部页 → 停,交付本章清单
用户:继续做第 2 章
执行:读设定总表与生成日志 → 补新角色/新场景设定图 → S3 拆 CH002 → S4 出页 → 停
用户:继续做第 2 章(标准执行序)
执行:向后读到第 22 章 → 核对/更新角色出场总表(新角色补设定图)→ S3 拆 CH002
→ S4 出页 → 拼总览图逐页质检(文字/徽章/角色一致)→ 停
出图后端
优先推荐模型:gpt-image-2.0。若宿主环境只提供旧别名 gpt-image-2,可回退;
若使用 Codex 内置 imagegen,则直接调用可用的图像生成工具。
推荐单页规格:1024x1536、质量 high。gpt-image 系模型对参考图有较强保真能力,
这是角色一致性的基础。单页漫画是一次生成任务,禁止把多页合并进一次调用。
生成后把选定图片移动/复制到工程目录对应位置并按 ID 命名,不要留在默认输出目录。
如果必须通过 OpenAI 兼容 API 出图,使用 scripts/generate_image.py。
API Key 只放 IMAGE_API_KEY 环境变量或本机 .env,API 根地址只放 IMAGE_API_BASE;
不要把凭据或私有网关地址写入提示词、生成日志、工程文件或 Git。
版权与文字风险
- 只处理创作者合法持有、有权使用的小说;分析是转化性工作,设定文档不整段复制原文。
- 中文对话框文字由模型渲染,可能出错字:重roll(单页最多 3 次;文字类 1 次不中先转确定性修字, 修字不成再回用剩余次数)→ 仍失败则该页按无字出图并记录,交用户决定是否后期加字。