GitHub 原文

按阶段恢复手册

这篇手册按自动导演阶段列出常见卡住位置、先看哪里、推荐恢复入口和什么时候需要重新规划。

先判断是不是失败

很多“停住”其实是 checkpoint:

  • 「等待方向选择」:等待选方向。
  • 「等待角色确认」:等待确认角色。
  • 「卷战略就绪」:等待确认卷规划。
  • 「章节批次就绪」:等待进入章节执行。
  • 「等待重新规划」:等待处理质量修复或重规划。

如果任务状态是 waiting approval,不要直接删除或重建项目。先看导演跟进。

恢复矩阵

阶段表现先看哪里推荐恢复入口何时重规划
候选种子对齐灵感无法生成候选创作中枢、任务中心修改灵感、换模型、重新生成候选不需要,项目还没立项。
方向批次候选都不满意方向选择页生成下一批、修订候选、定向修正不需要,继续候选阶段即可。
书名候选标题不合适方向选择页只重做标题不需要。
创建小说确认后项目没出现任务中心重试 「候选确认」只有重复数据冲突且无法修复时人工处理。
故事宏观故事方向偏离小说故事宏观页、导演跟进调整宏观故事或回到候选重做方向如果核心卖点错了,回候选阶段。
书契约承诺/受众不准书级信息、故事宏观修改书契约后继续如果会影响全部卷规划,重跑后续规划。
世界搭建世界规则不适配世界模块修改世界或重新准备世界如果世界规则改变主冲突,重跑角色和卷规划。
角色生成角色像功能位、缺身份锚点角色候选页、导演跟进合并、确认、补充或重做角色阵容角色目标影响主线时,重跑卷规划。
角色阵容应用角色无法落库任务中心、角色页重试应用或手动确认角色数据冲突无法修复时再人工处理。
卷战略卷目标不清楚卷规划入口重做卷战略或调整书契约第一卷承诺错位时重跑拆章。
卷骨架卷数量/跨度不合理卷规划入口调整卷骨架影响章节跨度时重跑节奏板。
节奏板节奏节点覆盖不足任务中心、卷规划重生成 「节奏板」节奏目标和卷战略冲突时回卷战略。
章节清单章节数不对、标题错乱章节列表重生成 「章节清单」节奏板本身错时先回节奏板。
章节同步章节任务没写入章节任务中心重试 「章节同步」 或继续结构化拆章不常需要重规划。
章节细化某些章节没有任务单任务中心、导演跟进从最近进度继续 「章节细化」如果章节清单错误,回章节清单。
章节执行正文生成失败或空任务中心、章节页重试、换模型、检查上下文章节任务与大纲冲突时重规划局部。
审核修复修复失败或质量债务章节页、导演跟进轻修复、记录债务、继续明确 「等待重新规划」 且影响后续时。

stale 任务恢复

DirectorWorker 用租约执行命令。服务重启、进程退出或长时间无心跳时,命令可能变 stale。

处理方式:

  1. 打开任务中心。
  2. 查看是否有“后台执行中断”或“等待恢复”。
  3. 如果系统自动恢复,等待任务重新进入队列。
  4. 如果需要手动恢复,点击恢复入口。
  5. 不要同时重复发起同范围任务。

全书自动执行和 「继续」 / 「从检查点恢复」 命令有自动恢复次数;超过次数后会转为手动恢复。

何时应该重新规划

适合重新规划:

  • 书契约、目标读者或核心卖点已经改变。
  • 世界规则改变了主冲突。
  • 角色阵容重做后影响卷目标。
  • 节奏板无法覆盖目标章节范围。
  • 审核明确要求 「等待重新规划」。

不适合重新规划:

  • 单章有局部语病。
  • 轻微节奏问题可以修复。
  • 审核服务暂时不可用。
  • 状态同步失败但正文可用。
  • 只有一个角色资源等待确认。

重试、恢复、重启的区别

操作适用风险
重试同一命令临时失败低,通常保留已有产物。
恢复stale 或 checkpoint 后继续中,需要确认从哪个进度继续。
重启阶段当前阶段产物不可信中高,可能覆盖目标阶段产物。
重新规划上游目标改变或质量要求明确高,影响后续链路。

保留证据

反馈问题时保留:

  • 当前 taskId。
  • 当前阶段 key。
  • checkpointType。
  • 任务中心错误信息。
  • 相关小说和章节。
  • 是否启用 auto-approval。
  • 最近是否重启应用。

这些信息能直接对应命令队列、worker 租约和自动导演 runtime。