GitHub 原文

按阶段恢复手册

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

先判断是不是失败

很多“停住”其实是 checkpoint:

  • 「等待方向选择」:等待选方向。
  • 「等待角色确认」:等待确认角色。
  • 「卷战略就绪」:等待确认卷规划。
  • 「章节批次就绪」:等待进入章节执行。
  • 「等待重新规划」:等待处理质量修复或重规划。
  • 「暂停处理」:本书问题规则要求停在已保存的章节边界。

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

恢复矩阵

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

stale 任务恢复

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

处理方式:

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

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

从安全章节边界恢复

章节生产会保存已完成正文和首个未完成章节。遇到模型余额、配额、服务中断或质量规则暂停时,按下面顺序处理:

  1. 在章节页确认最后一章已保存正文。
  2. 在运行记录查看真实失败原因和首个未完成章节。
  3. 修正模型连接、额度或需要人工确认的问题。
  4. 从导演跟进执行恢复。
  5. 确认任务从未完成章节继续,而不是重新覆盖已保存正文。

“质量优先”的人工暂停不会被后台轮询、worker 恢复或应用重启自动清除。只有用户明确恢复后,主链才会继续。

何时应该重新规划

适合重新规划:

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

不适合重新规划:

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

重试、恢复、重启的区别

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

保留证据

反馈问题时保留:

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

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