常见问题
这里收集第一次使用时最常见的问题。遇到复杂故障时，可以继续阅读《故障排查》。
自动导演的「运行模式」该选哪个
自动导演有四种模式，决定确认方案后会跑到哪里：
- 先准备到可开写（推荐第一本书）：自动跑完规划、角色、卷战略和章节任务，停在可开写状态。
- 全书自动成书：从方案直接跑到正文持续产出，需要稳定的模型供应和额度。
- 按范围执行：只跑全书、前 N 章或第 1 卷等指定范围，适合验证一段后再扩大。
- 正文后去 AI 检测与修正：是个开关，可叠加在上面三种之上，让章节产出带审核 + 修复闭环。
详见自动导演阶段全景的"运行模式"章节。
全书自动驾驶中途停下来了怎么办
「全书自动驾驶」遇到模型不可用、配额耗尽、连续修复失败、要求重新规划或结构性数据问题时会主动停下而不是无限重试。处理步骤：
- 打开导演跟进，看暂停原因。
- 打开任务中心，确认最新失败任务和错误信息。
- 排除外部原因（补充配额、切模型、修网络）。
- 在导演跟进点"继续自动导演"，从原检查点恢复。
不要直接退出导演模式或删除项目；中断的状态会被保存，恢复后不会从头跑。
介绍网站和主程序端口会冲突吗
不会。主程序 client 默认 3000，介绍站 site 默认 4173。 两者完全独立，可同时启动。如果某个端口被其它进程占用，按对应配置文件改即可。
桌面版数据存在哪
桌面版默认把小说数据库、任务状态、配置和生成产物保存在应用数据目录里。Windows 上通常在 %APPDATA% 下的应用目录。
重要项目建议定期备份：
- 应用数据库文件。
- 小说导出文本。
- 角色 / 世界 / 知识库 / 写法资产。
- 关键任务日志或错误截图。
排查问题前先备份再操作，不要在没备份的情况下删除数据库或重置数据。
模型连接失败怎么办
先检查四项：
- API Key 是否填写完整。
- Base URL 是否和供应商接口兼容。
- 模型名称是否存在并支持当前任务。
- 网络是否能访问供应商接口。
如果供应商需要额外 Header、代理或兼容 OpenAI 的路径，请按供应商文档填写。模型连接不通时，不建议继续创建复杂任务；先用连接测试或简单对话确认返回正常。
创建小说后不知道下一步
优先进入新手上路或创作中枢。
推荐路径：
- 输入一句灵感。
- 让自动导演生成方向候选。
- 选择一个方向。
- 跟随系统准备世界、角色和章节任务。
- 执行第一章。
不要一开始就手动填写所有高级设置。先让主链跑起来，再逐步补资产。
章节生成失败怎么办
先看任务中心的失败信息，再决定操作：
- 临时网络或供应商错误：重试任务。
- 提示模型输出格式不对：换更稳定的模型或降低并发。
- 缺小说基础信息：回到小说页补充设定。
- 多次失败且无可用正文：回到导演跟进查看是否需要重新规划。
如果任务生成了可用正文但审核仍提示问题，可以先接受质量债务，再继续后续章节；局部质量问题不一定需要中断整本书。
知识库为什么检索不到内容
常见原因：
- 文档还没有完成索引。
- Qdrant 没有启动或连接失败。
- 文档内容和当前任务问题不相关。
- 检索设置过于严格。
- 文档只上传了文件，但没有进入可召回状态。
先确认知识库任务已完成，再在知识库详情里查看文档状态。需要更强召回时，可以调整检索设置或把关键设定写得更明确。
自动导演暂停是不是失败
不一定。暂停通常表示系统需要你选择方向、确认候选、补信息或处理恢复入口。
优先查看：
- 导演跟进里的暂停原因。
- 任务中心里的最新任务状态。
- 小说页是否有等待确认的方向、角色或章节计划。
只有明确的不可恢复错误、数据完整性问题或系统要求重新规划时，才需要把它当成阻断问题处理。
模型路由应该怎么配
初次使用可以只配一个默认模型。跑通主链后，再按任务拆分：
- 开书和规划：理解能力强、结构稳定的模型。
- 正文生成：长文本能力好、风格稳定的模型。
- 审核和修复：输出结构稳定、遵循 JSON 要求的模型。
- 拆书和知识分析：长上下文和信息抽取能力强的模型。
如果某类任务经常失败，优先检查该任务绑定的模型。
能不能完全一键出书
项目目标是帮助新手完成整本小说，但更推荐“自动推进 + 关键节点确认”的方式。方向选择、重要角色和章节策略会影响整本书质量，系统会尽量给出清晰默认建议，同时保留必要确认入口。
如何保护数据
重要小说建议定期导出或备份。不要在没有备份的情况下删除数据库、重置数据或手动清理应用目录。需要排查问题时，先保留日志和数据库副本。