Webnovel Writer preflight 检查项逐项解析mainline_ready 为 false 时该看什么【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统解决 AI 写作中的「遗忘」和「幻觉」问题支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writerWebnovel Writer 是基于 Claude Code 的长篇网文辅助创作系统专为解决 AI 写长文时的「遗忘」和「幻觉」问题支持 200 万字量级连载。它的preflight命令是写作链路的第一道体检一次运行就能告诉你「环境能不能跑、项目找没找到、主链档案就不到位」。这篇文章带你逐项读懂 preflight 输出重点讲清楚当mainline_readyfalse时该看什么、改什么。一、preflight 是什么写作前的一次快速体检 preflight是统一 CLI 的子命令官方文档把它描述为「校验统一 CLI 运行环境与 project_root」。它的完整用法见 commands.mdpython webnovel.py --project-root 项目根目录 preflight --format json它不写任何文件只做只读检查退出码为 0 表示全部通过1 表示有检查项失败。所有检查项的定义都在 webnovel.py 的 _build_preflight_report 中。二、5 个检查项逐个看每个 OK/ERROR 代表什么preflight 文本模式下每行是一个检查项格式为状态 名称: 路径。共 5 项检查项含义ERROR 时通常怎么办scripts_dir插件的 scripts 目录是否存在检查插件安装是否完整entry_script统一入口webnovel.py是否存在同上重装或补全插件extract_context_script上下文提取脚本是否存在同上skill_rootskills/webnovel-write写作技能目录是否存在检查插件目录结构project_root是否解析到书项目根目录含.webnovel/state.json的目录见下方重点解读前四项属于「安装健康」几乎不会单独失败真正常出问题的是project_root。project_root 失败最常见的「没找到项目」project_root检查会解析出你书项目的根目录。找不到时它会打印诊断信息来源项目根解析逻辑常见两种情况从未初始化当前工作区还没有书项目先运行/webnovel-init创建或运行webnovel use project_root绑定已有项目传错了路径--project-root指向的目录里必须有.webnovel/state.json指向上层目录也可能解析失败改成指向具体的书项目目录再试。story_runtimepreflight 顺手带出的主链健康只要项目根解析成功preflight 最后会多打一行INFO story_runtime格式为INFO story_runtime: chapter12 mainline_readyFalse latest_commit_statusmissing这三个字段就是本文的重点——它们由 story_runtime_health.py 生成也是 Dashboard 系统状态页顶部「Story Runtime: Mainline / Fallback」卡片的同一份数据。三、mainline_ready 为 false 时该看什么 mainline_ready在作者视角的翻译是「这本书的档案是否就绪」见 author_glossary.json。它的判定规则很直接只要存在任何 fallback source就是 false。具体来说story_runtime_sources.py 会检查当前章节的 4 份「写作合同」加 1 份「已接受提交」来源缺失时的 fallback 标记说明总纲合同 mastermissing_master_contract.story-system/MASTER_SETTING.json卷合同 volumemissing_volume_contract当前卷的设定合同章合同 chaptermissing_chapter_contract本章的写作要求合同审校合同 reviewmissing_review_contract上一章的审校结论已接受提交missing_accepted_commit最近一次statusaccepted的 commit所以 mainline_readyfalse 时的排查路径是看fallback_sources字段--format json输出里。它精确告诉你缺的是哪份合同看latest_commit_statusmissing表示还没有任何已提交章节rejected表示上一章没通过审校先把上一章的 review 修到 accepted按缺失项补齐合同缺失 → 运行 story-system 主链并输出合同命令形式webnovel.py story-system ... --persist --emit-runtime-contracts --chapter N项目还没初始化 → 先/webnovel-init不确定缺什么 → 直接运行/webnovel-doctor它会给出逐条的 impact 和 repair 建议。错误目录里对这一项的作者友好描述是「这本书的写作档案还没就绪」建议动作就是「先 init再 doctor」见 author_error_catalog.json。四、preflight 与 doctor 的分工一个看门、一个查房preflight 通过之后不代表万事大吉。系统还有一层更深的体检命令doctor源码doctor.py两者的关系是preflight5 项环境检查 1 行主链健康摘要秒级完成适合每次写作前跑doctor阶段感知的项目体检覆盖必需要目录/文件、JSON 可解析性、SQLite 索引库、RAG 配置、Python 依赖等几十项并且会把 preflight 的结果转写成preflight.*检查项一并纳入转换逻辑。其中 doctor 对主链健康的判定项story_runtime.health与 preflight 同源mainline_ready 为 false 时它报 warningrepair 建议统一为「补齐 Story System 合同和 accepted commit 后再写」。技能入口见 webnovel-doctor SKILL.md。五、一张速查表看到报错先查这里 ✅现象先看什么下一步preflight 有 ERROR哪个检查项是 ERROR按上表对应处理project_root失败先 init/usemainline_readyfalsefallback_sources具体标记缺合同跑 story-system 补合同缺 accepted commit 先修审校latest_commit_statusmissing是否写过并 commit 过章节尚未 commit 时属正常写完提交即可preflight 全 OK 但写作异常doctor 报告的 warning按每条 repair 建议逐条处理小结preflight 只读、快速5 项检查 1 行主链摘要是写作链路的第一道闸门mainline_readyfalse不必慌fallback_sources字段已经告诉你缺哪份合同补齐即可环境类问题找 preflight项目内容类问题找 doctor两条命令配合基本能覆盖 90% 的「写不动」场景。建议把preflight放在每次开写前的固定动作里把doctor放在报错时深入排查养成「先体检、再开写」的习惯。【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统解决 AI 写作中的「遗忘」和「幻觉」问题支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考