> ## Documentation Index
> Fetch the complete documentation index at: https://ai-novel-writing-assistant.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 按阶段恢复

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

很多"停住"其实不是失败，而是自动导演在等待确认。本页按阶段列出常见表现、先看哪里、推荐恢复入口和什么时候需要重新规划。处理任何可能影响数据的操作前，请先备份。

如果问题属于安装启动、模型连接或通用错误，先看 [故障排查](https://ai-novel-writing-assistant.mintlify.site/troubleshooting.md)。运行记录是只读查看，继续或恢复操作请在导演跟进或对应工作台处理。

## 先判断是不是失败

自动导演在以下位置会停下来等你确认，这些属于正常 checkpoint：

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

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

## 恢复矩阵

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

> [!NOTE]
>
> 运行记录负责查看状态和打开来源页；继续、恢复、取消等操作在来源工作台处理。不要靠重复点击生成来代替恢复。

## 恢复操作的区别

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

## Stale 任务恢复

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

处理方式：

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

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

## 从安全章节边界恢复

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

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

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

## 何时应该重新规划

适合重新规划：

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

不适合重新规划：

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

## 常见问题

> [accordion] 运行记录显示失败，但导演跟进看起来正常，以哪个为准？
>
> 优先看导演跟进的暂停原因，再看运行记录的后台状态。很多情况下只是等待确认而不是失败。不要只凭单个页面判断任务状态。

> [accordion] 恢复时会不会覆盖已经写好的章节？
>
> 正常恢复会从首个未完成章节继续，不会覆盖已保存正文。恢复前先在章节页确认最后一章正文已保存，再执行恢复。

> [accordion] 可以一边恢复一边重新发起同范围任务吗？
>
> 不建议。同一本书同范围通常不应重复启动多个任务。看到"已有自动导演任务正在处理同一范围"时，先去运行记录看正在运行的任务。

> [accordion] 模型额度耗尽后，补充额度就能直接继续吗？
>
> 补充额度或切换模型后，回到当前执行页或导演跟进恢复即可。不需要删除小说或重建项目。

> [accordion] 什么情况下需要人工介入而不是自动恢复？
>
> 以下情况不会自动恢复：质量优先规则暂停、角色等待确认、方向等待确认、明确"等待重新规划"。这些都需要用户在对应工作台显式操作后才能继续。

> [accordion] 反馈问题时需要保留哪些信息？
>
> 保留当前 taskId、当前阶段 key、checkpointType、运行记录错误信息、相关小说和章节、是否启用 auto-approval、最近是否重启应用。这些信息能直接对应命令队列、worker 租约和自动导演 runtime。

> [card] [故障排查](https://ai-novel-writing-assistant.mintlify.site/troubleshooting.md)
>
> 安装启动、模型连接和通用错误的排查步骤。

> [card] [导演跟进](https://ai-novel-writing-assistant.mintlify.site/features/director-follow-up.md)
>
> 查看暂停原因、处理等待确认和显式恢复的操作入口。

> [card] [第一本小说实战](https://ai-novel-writing-assistant.mintlify.site/guides/first-novel-walkthrough.md)
>
> 从灵感到完成第一卷的完整端到端案例。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.