自动导演阶段全景

对应代码来源：

• server/src/services/novel/director/projections/novelDirectorProgress.ts
• shared/types/directorWorkflowStepCatalogData.ts
• server/src/services/novel/director/novelDirectorPipelineRuntime.ts
• server/src/services/novel/director/commands/DirectorCommandService.ts

自动导演不是一个五步向导，而是一条可暂停、可恢复、可自动审批的生产管线。用户看到“方向 → 世界 → 角色 → 拆章 → 执行”只是概览；任务中心和导演跟进里出现的 「卷骨架」、「节奏板」、「应用角色阵容」 等术语来自更细的阶段投影。

运行模式

启动自动导演时必须选择运行模式。模式决定管线确认方案后自动跑到哪里。模式不改变阶段顺序，只改变 auto-approval 边界、章节执行范围和哪些异常必须交还给用户。

全书自动驾驶的中断条件

「全书自动驾驶」遇到下列情形会主动停下等用户处理，而不是无限重试：

• 模型不可用 / 服务不可用 / 配额耗尽
• 质量审核要求重新规划
• 修复链路连续失败
• 检测到结构性数据问题或安全策略阻断

中断后状态会被保存到导演跟进，可以在排除问题后从原检查点恢复。

选择建议

• 第一本书想稳一点：选「先准备到可开写」，让 AI 自动完成规划、角色、卷和章节任务，再决定是否开始写正文。
• 第一本书想完整体验自动产出：选「全书自动成书」，并开启「正文后去 AI 检测与修正」。
• 想先试跑一小段：选「按范围执行」，先跑前 N 章或第 1 卷，确认正文质量后再扩大范围。
• 长时间无人值守前，先确认模型供应、额度、网络和任务中心都稳定。

模式可以在导演跟进的“继续自动导演”或接管动作里调整；切换不会丢失已完成的阶段产物。

从确认方案到小说产出的全自动链路

真实使用时，用户只需要做一个关键创作选择：确认哪一套书级方案。确认之后，系统会把后续步骤写入后台任务队列，由 AI 驾驶舱持续推进。

界面截图路径

下面这组截图对应真实操作路径：创建自动导演任务、没有想法时选择灵感卡、生成第一批方案、确认书级方案，然后进入 AI 驾驶舱自动推进到角色、卷规划、节奏拆章和章节执行。

创建弹窗上半部分决定起始灵感、模型和运行方式。这里选择“先准备到可开写”或“全书自动成书”，会影响确认方案后是否自动进入正文产出。

创建弹窗下半部分用于设置世界处理、书级 framing、目标长度和生成动作。点击“生成第一批方案”后，系统进入候选阶段。

如果用户没有明确灵感，可以直接从灵感卡开始。灵感卡只负责给候选生成提供 seed，不要求用户先写完整大纲。

生成候选时，页面会显示当前任务进度。此时系统在后台完成灵感对齐、立项 framing、方向候选和书名候选。

确认书级方案是最后一个必须由用户做出的创作选择。确认后，系统创建小说，并把后续阶段写入自动导演任务链。

进入 AI 驾驶舱后，不需要逐个模块手动点击生成。顶部状态和左侧步骤显示当前自动导演的真实推进位置。

页面停在角色准备并不等于系统停住。只要 AI 驾驶舱显示正在处理或已进入后续步骤，后台会继续推进卷战略和拆章。

节奏板阶段会把卷规划拆成可执行章节任务。选择“全书自动成书”或授权范围执行后，系统会继续进入章节正文、审核和修复链路。

[!CHECKPOINT] 最后一个必须选择的创作点

“确认书级方案”是从创意选择进入自动生产的关键点。确认后，除非模型不可用、额度耗尽、结构性质量问题、重规划风险或用户主动退出导演模式，系统应自动推进到所选模式的目标结果。

确认方案后会自动推进哪些页面

确认方案后，用户可能会看到页面停在某个模块，例如角色准备、卷战略或节奏/拆章。这不代表需要手动做完该模块。AI 驾驶舱顶部的状态条和左侧步骤才是自动导演事实状态：

产出标准

选择“先准备到可开写”时，成功产出是：

• 小说项目已创建。
• 书契约、故事宏观、世界、角色、卷战略已保存。
• 第一批章节已有节奏板、章节清单和章节任务单。
• AI 驾驶舱停在可开写或章节批次就绪。

选择“全书自动成书”时，成功产出还包括：

• 目标范围内章节正文已生成。
• 每章有审核、修复记录或质量债务。
• 角色状态、事实、伏笔和世界变化回灌到后续章节。
• 全书或目标范围结束后，任务进入完成、可导出或可继续下一批状态。

阶段分组

分组详解

候选阶段

候选阶段解决“这本书到底写什么”。它不会直接写章节，而是把用户灵感整理成多个可选方向，避免新手一开始就被要求手动写世界观、角色和大纲。

这个阶段的核心 checkpoint 是 「等待方向选择」。用户可以选择方向、生成下一批、整批修订、单项修订或只重做标题。只有候选被确认后，系统才进入建书。

立项阶段

「创建小说」 把确认的候选方向变成真实小说项目。它会建立小说记录、导演任务状态、运行 snapshot 和后续 pipeline 所需的基础 payload。

这个阶段失败通常是运行时或持久化问题，不是创作判断问题。优先看任务中心错误，再重试 「候选确认」 或恢复当前命令。

资产准备阶段

资产准备阶段把“我想写什么”变成“后续每章都能读取的资料”。

角色阶段是重要质量闸口。如果角色名仍像“导师型女主”“反派老板”这类功能位，或缺少身份锚点，系统应停在 「等待角色确认」，而不是把低质量阵容带进卷规划。

卷规划阶段

卷规划阶段解决“整本书怎么分卷推进”。它不直接写章节正文，而是先确定每卷读者承诺、主要冲突、阶段目标和结构承载。

如果卷战略不对，优先在卷规划入口处理，不要只改章节标题。章节标题是下游结果，无法修正上游卷使命。

章节细化阶段

章节细化阶段把卷规划拆成可以执行的章节任务。它是自动导演和正文执行之间的移交层。

这个阶段属于高内存任务，重复启动同一本书同范围的拆章任务容易造成用户难以判断最终结果来自哪次运行。看到任务已排队或运行时，先去任务中心查看。

阶段总表

阶段产物在哪里看

[!TIP] 产物应落到模块里

自动导演的结果不应该只停留在聊天记录或任务日志里。长期生效的信息必须落到小说资料、角色、世界、卷规划、章节任务、知识库或写法资产中。

Checkpoint 清单

[!CHECKPOINT] 人工确认与自动确认

auto-approval 不是“无条件跳过质量”。它只在配置允许的审批点生效，并且高风险点如重规划、重写清理默认应谨慎授权。

Auto-approval 行为分层

auto-approval 的价值是降低重复确认成本，但它不应该掩盖真正需要用户判断的创作风险。

新手用户更适合自动通过低风险规划点，让系统完成从开书到章节批次的连续准备；高风险点保留确认，避免不知道为什么结构被重做。

命令队列如何承载阶段

用户操作会进入 DirectorRunCommand 队列。常见命令包括：

DirectorWorker 会租约命令、续租、执行、完成或失败。ResourceGate 会按小说和资源类型限制并发，例如 planner、writer、repair、state_resolution 默认每类 2 个槽位。节奏板、章节清单和章节细化还会走高内存保留，同一本书同范围通常只允许一个高内存任务。

阶段与命令的关系

阶段是用户理解进度的投影，命令是后台执行的单位。一个命令可能推进多个阶段，一个阶段也可能因为重试或恢复被多个命令触达。

排查时不要只看阶段名，也要看任务中心里的命令类型和错误。阶段说明“卡在 beat_sheet”，命令错误可能实际来自模型、资源限流或持久化同步。

进度投影如何理解

导演跟进看到的进度不是后台日志原文，而是从运行状态投影出来的用户视图。

如果投影显示阶段完成，但对应模块没有产物，优先检查同步阶段和任务中心错误；如果模块已有产物，但投影还停在旧阶段，优先检查任务状态是否 stale 或前端是否刷新到最新任务。

阶段事件与用户动作

这些事件应该让用户明确下一步，而不是只展示代码阶段名。公开文档和 UI 文案都应尽量给出“你可以做什么”。

失败重试原则

按分组恢复

[!WARN] 不要把局部问题升级成全局中断

章节审核中的局部质量债务、可修复 obligation gap 或低风险修复失败，不应自动阻断整本自动导演。只有明确 「等待重新规划」、正文不可用、运行时安全问题或数据完整性问题才应停止全局链。

关联模块

新增阶段时的文档检查

新增自动导演阶段时，不能只改后端类型。至少要同步检查：

新增 checkpoint 或 auto-approval point 时，还要同步更新《导演跟进》和任务中心相关说明。

阶段文档的目标是让用户能恢复任务，也让维护者知道新增阶段会影响哪些公开说明。 每次调整阶段投影后，都应同时确认用户入口、恢复入口和公开术语是否仍然一致。

常见误解

文档阅读建议

UI 术语对照

维护规则

如果代码新增 DirectorProgressItemKey，本页顶部的 DIRECTOR_PROGRESS_ITEM_KEYS 清单必须同步。站点校验会读取代码和文档，发现阶段缺漏时阻止通过。

技术别名对照表

文档面向用户，正文统一使用中文名。下表列出对应的内部 key，仅供开发者排查日志、调用接口或阅读源码时查阅。