Novel To Comic

通用小说转完整漫画

将用户实际提供的小说制作成可阅读的完整漫画。作品内容只写入作品项目，不把测试样例的人物、情节或世界观带入用户作品；tests/fixtures 中的原创短篇仅用于隔离验证。

规范权威来源映射（Source of Truth）

为避免规则分散与多处重复引发指令漂移，本项目各领域规范以对应权威文件为唯一准则：

核心原则：忠实原著与改编推断边界

三级证据体系（Three-Tier Evidence Model）

为平衡小说文学叙事与漫画视听语言的媒介特征，防止将合理分镜误判为虚构，同时死守剧情真实性底线，实行三级证据分类：

1. 第一类：原文明示事实（Explicit Canonical Facts）——【严格忠实，必须有明确出处】
   • 剧情事件走向、对白核心意义、角色发言态度、既定身份与人际关系、因果动机、情节揭示、原文明示的场景环境与关键道具。
   • 红线要求：必须 100% 严格忠实原著，具备真实 source_unit_ids 绑定与精准原文短引句；严禁遗漏有效细节，严禁以概括跳过过程。
2. 第二类：视觉呈现选择（Visual Staging Choice）——【允许专业转译，标明视觉呈现】
   • 为在画格中具象化第一类事实所需的分镜机位（景别/俯仰角度）、构图透视、分格节奏、肢体动作中间过渡、微表情神态、符合世界观的光影与环境细节。
   • 红线要求：属于漫画转译的合理艺术推断，在分镜与细节记录中明确标明为“视觉呈现（visual staging）”。无需伪造逐字引句，但必须服从角色性格基调、情节氛围与美术规范，不得冲突或喧宾夺主。
3. 第三类：新增实体/情节/因果（Fabricated Canonical Elements）——【绝对禁止，一票否决】
   • 小说中完全未发生的新事件、凭空捏造的感情线或平行冲突、改变故事走向的自创动机、与原作设定冲突的魔改剧情、无中生有的虚假对白。
   • 红线要求：绝对严厉禁止。一旦发现，判定为 Major/Critical 缺陷，一票否决，绝不得锁定剧本或放行出图。

README 与工程文档剧情描述零臆测

项目顶层 README.md、各卷 README.md、docs/overview.md（作品概述/故事梗概）、docs/info.md（本卷叙事焦点）等工程文档，凡涉及对剧情的描述与概括，必须完全严格摘自已阅读并核实的原文真实事件。尚未提供或未读到的后续分卷，严禁根据常识猜测、网络同名故事记忆或主观臆想编造任何剧情，统一如实标注“待后续原文输入后提取真实剧情”。

双轨质检体系：机械门禁与人工语义审查

必须在流程中严格区分机械门禁通过与人工语义/视觉审查结论：

• 机械门禁（Automated Gate）：由辅助脚本校验 JSON 结构、字段合法性、SHA256 哈希、文件真实性及关联引用。机械通过仅代表数据结构闭环与可追溯，绝不代表剧情未被遗漏，绝不代表模型实际精读了原文，绝不代表画面合格。
• 人工语义与视觉审查（Semantic & Visual Review）：主代理（或人工审阅人）必须亲自通读原文、核对分镜、审阅原图与排版。审查证据必须明确指向具体原文段落、具体画格 ID、角色对比基准和问题修订记录，严禁填写形式化虚假报告。

两层级分镜规划原则

• 层级一：整卷/整章叙事总规模（不设固定格数硬上限）：默认完整细节改编，忠实覆盖全部有效原文，保留独立事件、人物弧线、因果、支线、伏笔、对白交锋与心理/情绪转折。整章叙事总格数不设固定硬上限。约 2,000 字中文章节常规参考 50–80 格（初始按约 60 格规划），交锋密集时 80–120 格或更多，事件较少时 30–50 格；绝不为了省页数过度概括，也绝不为了凑格虚构新情节。
• 层级二：单张成图与成品页规模（限定 3–4 格整宽纵排）：针对手机竖屏沉浸阅读体验与 AI 画面原生像素质量，单页漫画格数调整为 3~4 格，常规模式下 3 格，信息简单可以使用 4 格；严禁单页少于 3 格（条漫节奏散漫或画格过少）或超过 4 格（单格过扁、面部模糊、对白拥挤），禁止双列小格或 2×2 网格。一章 60 格通常规划为 15–20 张成品页；一页对应一次生成调用，完整页内原生绘制所有镜头、边框与气泡，不建立独立画格图片。

手机单页尺寸与可读性规范

编剧、出图、排版和验收前读取 phone-reading.md。建议规格：画布 1080×2400（宽高比 9:20，高宽比建议 2.0–2.4），单页限定 3–4 格整宽纵排（常规 3 格，信息简单可 4 格）；正文建议字高 48–60 像素（360 宽视口建议约 16 CSS 像素，仅作为排版参考建议，字体验收放宽，字体大小不应成为卡点），清晰易读、画面自然饱满即可。页面 QA 记录 phone_readability 与逐页 phone_reading_notes。

不可跳过的制作顺序与独立卷原则

以当前卷为独立制作与锁定单位，不可跳过的标准制作顺序统一为： 本卷原文归档 → 按章委派编剧子代理推进编写（读本章 → 细节清单 → 逐场详细剧本 → 逐格分镜 → 对照原文核查）→ 每五章阶段双子代理双轮审批与打磨整改（初审扣分挑刺-打磨修改-复审核销，杜绝一把过虚高） → 本卷汇总审查修订 → 本卷锁定 → 基准制作或继承 → 按章正文生成验收 → 排版 → 本卷交付。

在有效剧本锁定前，不生成或编辑任何角色设定图、试画、样章、封面或正文图。不能以摘要、大纲、少量章节分镜替代本卷详细分镜剧本。

主代理定位：总导演与总制片人（严禁下场干活铁律）

• 总导演严格扮演与协调统筹（严禁肉身下场干活）：主代理扮演总导演兼总制片人（Showrunner），严格遵循其专属提示词 roles/lead_director.md。绝对禁止主代理下场干具体的活（包括但不限于：严禁肉身精读写初稿分镜、严禁亲自整改被驳回的不合格剧本、严禁亲自编写出图提示词、严禁亲自调用绘图工具、严禁亲自填报整页 QA 报告、严禁通过 Python 脚本批量合成伪造虚假审查报告）。
• 指定严格扮演角色与单一提示词注入（上下文物理隔离）： 主代理通过 invoke_subagent 派发子代理时，必须指定其严格扮演的角色，并仅注入该子代理专属的系统提示词（位于 roles/ 目录）。各角色拥有完全独立的上下文，不需要也不应读取其他角色的扮演提示词：
  • 改编编剧师（Screenwriter）：注入 roles/screenwriter.md，逐章精读原著，提炼三级证据细节清单，编写逐格分镜草稿；
  • 剧本改稿整改师（Script Reviser）：注入 roles/script_reviser.md，专职承接驳回剧本的画格级整改任务，增补 Establishing Shot、扩充高潮交锋镜头、补齐吃瘪吐槽笑点，严禁主导演代劳；
  • 红队审评官 A（Auditor A - 场景与高潮）：注入 roles/script_auditor_a.md，每 5 章充当严苛啄木鸟，量化扣分场景与高潮缺陷，绑定真实引句驳回并复审核销；
  • 红队审评官 B（Auditor B - 笑点与台词）：注入 roles/script_auditor_b.md，每 5 章量化扣分幽默笑点过滤与台词 AI 腔，绑定真实引句驳回并复审核销；
  • 全卷文学终审编辑（Chief Script Editor）：注入 roles/chief_script_editor.md，全卷汇总后执行 coverage、continuity、comic 三轮拉网自校验；
  • 概念美术与人设设计师（Art Director）：注入 roles/art_director.md，提炼角色档案、制定风格指南与基准图提示词；
  • 分镜提示词工程师（Prompt Engineer）：注入 roles/prompt_engineer.md，将锁定分镜编译打磨为 3~4 格整宽纵排（常规 3 格，信息简单可 4 格）、建议字高 48-60px（作为参考建议）、气泡排版的完整页提示词；
  • 画面渲染执行员（Render Operator）：注入 roles/render_operator.md，调用生图工具一次性生成包含所有画格与气泡的原生 1080×2400 PNG；生图遇到工具报错/API异常时允许重试最多六次，六次均失败生成默认失败占位图推进流程；
  • 画面与排版品控员（QA Inspector）：注入 roles/qa_inspector.md，在手机 360/390/430px 视口下核验原生整页，实测字高与文字错漏，填写真实整页 QA；字体验收放宽，字体大小仅为建议不作为卡点；三次审图不符合标准时兜底选择一张最符合的图片并解释缺陷处；支持六次失败默认占位图验收入库；
  • 后制包装与交付员（Packager）：注入 roles/packager.md，执行页面归档（prepare-pages）、排版审阅汇总、多格式导出（HTML/PDF/CBZ）与完整性校验。
• 子代理模型选用建议（建议与主代理保持一致）：调度各专业子代理时，建议使用与主代理同等水平或一致的模型（在支持继承或指定模型的宿主中优先对齐主代理模型），以保证编剧精读、改稿增补、红队双审、提示词打磨及品控质检等全流程子代理具备充分且一致的理解力与审查深度。
• 主代理核心统筹权责：主代理仅负责工单拆解派发、审查争议客观仲裁（下达整改指令单）、运行 CLI 机械门禁校验（check-*）、全卷剧本锁定（lock-script）与最终交付物验收放行（complete）。主代理必须坚决恪守成品资产保护底线，严禁擅自删除 exports/ 成品文件及已完成成品图；收到用户删除要求时必须严格执行二次确认。

1. 建立和读取项目

1. 唯一默认复制归档保护原稿：运行 init-book 时，唯一默认行为是将小说文本复制归档到书名项目内的 source_texts/ 统一集中管理并校验 SHA256，完整保留外部原稿在原位置不变。仅在用户明确指定 --action move 时才执行移动。切分长篇文本存入 split_texts/。
2. 模块化文档体系：书名根目录自动生成总览 README.md 与 docs/ 模块文档（overview.md、structure.md、worldview.md、characters.md、art_direction.md、progress.md）；各分卷目录维护卷级精简 README.md 与卷级 docs/（info.md、status.md、commands.md、structure.md、notes.md、deliverables.md）。模板统一由 assets/templates/ 动态渲染载入。
3. 分卷独立初始化：只有新卷或新作品才运行 init，自动归档原稿副本至卷内 source/originals/，统一采用单一权威版本 schema_version=6。已有项目先通过 status 续做。

2. 本卷剧本与多轮审查修订

1. 改编编剧师子代理逐章推进与细节充分展开：主代理调度独立的改编编剧师子代理（Screenwriter Subagent），按原文章节顺序完整精读当前章正文，保存 docs/adaptation/<chapter_id>.md 细节清单与详细场戏，在 scripts/chapters/<chapter_id>.json 保存分镜草稿及 chapter_adaptations。
   • 防遗漏三大铁律：严禁过度概括或跳步省略。必须充分阐述关键场景空间与氛围细节（建立身临其境的视听张力）、层层推进关键剧情冲突与高潮转折（拒绝一格带过）、原汁原味还原原著笑点/幽默梗/吐槽与反差互动（严禁遗漏喜剧包袱）。
   • 正文细节严格遵循三级证据分类，第一类事实提供原文短引句与分镜摘句，第二类标明视觉呈现，严禁第三类虚构。主代理执行 check-adaptation 并完成语义核查后进入下一章。
2. 每五章阶段剧本审查与打磨整改（全覆盖与指纹绑定）：根据本卷实际正文章节计算应审批次（每 5 章为一批，尾批不足 5 章单独成批），由审评子代理 A 与 B 执行阶段审查：
   • 客观严谨与证据绑定：子代理通读原文与分镜草稿，按场景空间、剧情高潮、幽默还原（严肃章节不适用）与台词人设维度客观评估。允许充分检查无缺陷的初审直接通过；若发现重大缺陷，必须绑定真实逐字引句并驳回整改；
   • 仲裁裁定与剧本改稿整改师执笔整改：总导演客观裁定扣分项（可裁定误报并记录理由），下发整改单；由剧本改稿整改师子代理（subagent_reviser）亲自修改分镜并记录画格前后实质对比（before_revision vs after_revision），严禁主导演代改；
   • 复审核销与指纹绑定：审评子代理复核修改画格，缺陷全部闭环（或裁定消除）且复审得分 ≥85 分后通过。阶段报告必须绑定对应章节的内容指纹（stage_script_hash），剧本修改后旧阶段报告自动失效需重审。全卷必须完整覆盖所有批次方可推进。
3. 汇总与全卷文学终审：完成全部章节并通过各阶段审批后汇总本卷工作 JSON，执行 set-script 导入并运行 check-script 结构预检。运行 preflight-typeset 预检对白气泡容量可行性，并查看 estimate-cost 全卷页数与调用量估算。主代理调度全卷文学终审编辑子代理产出绑定当前剧本指纹的 JSON 审查报告并运行 review 登记：
   • coverage：核对全部有效原文事件无遗漏、无过度概括、无新增虚构（第一、三类证据审查）；
   • continuity：核对因果逻辑、状态转换与知情范围，所有因果转折严格来源于原著；
   • comic：核对镜头视听节奏、第二类“视觉呈现”合理自然、台词对白忠于原著语气和原意。
4. 锁定剧本：三类报告对应同一剧本指纹且阶段审查全覆盖通过后，主代理执行 lock-script 输出 full-script.md。任何出图前必须先运行 assert-art 放行。

3. 人物、场景和美术基准

在剧本通过后落实美术规范到基准图：

• 概念美术与人设设计师子代理设计：制定风格指南与角色档案（男女造型清晰，主角面部五官精细，建立多角度与多表情设定板），编写基准图出图提示词；
• 主代理登记基准图：审阅品控报告，通过 register-reference 登记基准图。续卷可直接复用前卷已通过的基准图。

4. 整页漫画一次生成

正文唯一流程是完整页提示词→一次绘图→一张完整PNG→一份整页验收报告。严格要求整页一次成型，严禁分格生成、裁切画格、跨页合图、后续拼版或代码补字。

1. 分镜提示词工程师子代理编写打磨：必须读取 production.md 和 page-prompt-template.md，按锁定本页全部分镜、人物状态和原样台词编写完整页提示词。提示词子代理打磨画幅、格数（3~4格纵排，常规模式3格，信息简单可4格）、布局、视觉中心、连续性、气泡位置与归属，消除冲突和漏台词。
2. 渲染执行员子代理调用出图：主代理运行 build-prompt --page <page_id> 编译完整页内容，打磨后 begin-page --page <page_id> --prompt <file> 登记调用。渲染子代理调用一次绘图工具，只请求一张包含全部画格与气泡的 1080×2400 原生竖屏完整页。若生图失败（工具报错、网络超时、API异常等），允许重试最多六次。
3. 画面与排版品控员子代理多视口质检与双重兜底保障：
   • 品控子代理运行 preview-page --page <page_id> --file <image> 预先生成 360/390/430 手机预览，核对镜头、人物、气泡位置与实测字高（放宽字体验收，字号仅为建议不作为卡点）；运行 qa-inputs --page <page_id> --attempt <num> --file <image> 读取机械字段，填写一份真实整页 QA。
   • 若前 1、2 次审图合格执行 finish-page（无缺陷标记为 accepted），不合格执行 fail-page 派单返修完整页（前两次尝试严禁带缺陷通过，门禁直接阻断）。
   • 【三绘即决铁律：严禁无限重绘，严禁中途停工】：单页审图尝试严格以 3 次为上限（初画 1 次 + 最多 2 次返修）。重绘达 3 次后，即使画面仍不完美，绝对禁止发起第 4 次重绘（绝对禁止再次调用 begin-page），也绝对禁止中断流水线或停下来等待用户！ 品控员必须立刻在 3 次历史尝试中横向对比并挑选一张最合适的候选图，在 QA 报告中详细说明缺陷处（写入 defect_explanation），主代理执行 finish-page 兜底暂存为 accepted_flawed 状态（若含未解决 critical 严重缺陷则标记为 blocked 阻断），并直接无缝推进下一页生产。
   • 【六次生图报错兜底铁律：默认失败占位图，严禁中断死锁】：若遇生图接口报错、网络异常或无法出图，允许重试最多 6 次（通过 fail-page ... --generation-failure 记录）。若 6 次重试全部失败无法出图，绝对禁止死锁或停滞！ 立即执行 placeholder-page --project <dir> --page <page_id> --reason "<failure_reason>" --finish 自动生成标明失败诊断、保留剧本分镜与对白的 1080×2400 原生失败占位图，暂存为 placeholder_pending 状态，并直接无缝推进下一页生产！
4. 后制包装子代理归档与内部预览：运行 prepare-pages 按顺序复制完整原生 PNG 并生成缩小手机预览。已结算页面（accepted、accepted_flawed、placeholder_pending）均可生成内部预览包。

5. 质检、恢复与交付

1. 页面审阅与导出：后制包装子代理整理页面审阅数据后，主代理执行 review-layout，运行 export 导出离线 HTML 阅读器、PDF 与 CBZ，运行 verify-export 校验交付完整性。
2. 最终验收与交付门禁：主代理执行 complete 记录真实最终验收。交付门禁红线：若全卷包含 placeholder_pending 占位图或 accepted_flawed 缺陷暂存页，complete 命令默认严格阻断交付，杜绝带缺陷或缺页作品静默伪装成品；正式交付必须补齐重绘，或经由用户明确提供 --allow-placeholders / --allow-flawed 参数显式授权放行。
3. 中断恢复：中断或返修时，运行 status 依据真实文件和指纹恢复，复用输入一致且已验收的成果，严格按 recovery.md 处理。
4. 成品资产保护与二次确认铁律（禁止随意删除）：
   • 绝对禁止乱删除：导出到 exports/ 目录的全部成品文件（离线 HTML 阅读器 reader.html、全卷高画质 PDF comic.pdf、标准 CBZ 封包 comic.cbz 等）以及全部已验收完成的整页成品图（art/pages/、pages/ 等成品图像资产），为项目的核心最终成果，绝对禁止任何形式的擅自删除、清空、重命名破坏或静默覆盖。无论是在重新导出、脚本重跑、流程中断恢复、版本分叉隔离还是目录整理维护中，均必须完整保留已有成品资产。
   • 删除唯一触发条件：除非且仅当用户主动、明确发出删除成品文件或成品图的指令，否则任何代理、脚本或子代理严禁擅自执行删除。
   • 强制二次确认机制：当用户明确要求删除时，总导演/主代理绝不能直接执行删除，必须停下来主动与用户进行二次确认：
     • 明确列出即将被删除的成品文件清单（包括具体路径与所属卷次）以及已完成成品图的页码范围；
     • 严肃告知该删除操作完全不可逆，已完成的画面与排版将永久丢失；
     • 明确询问用户：“检测到您要求删除已完成的成品图/exports 成品文件。请确认：是否确认删除已完成的成品图及相关成品交付文件？”；
     • 必须在获得用户明确肯定答复（如“确认删除”）后方可执行物理删除；若用户未明确肯定确认或取消，则立即终止删除并原样保留所有成品。