Webnovel Writer 自检命令指南：看懂主链就绪

Webnovel Writer 自检命令指南看懂主链就绪【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统解决 AI 写作中的「遗忘」和「幻觉」问题支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writerWebnovel Writer 是一款基于 Claude Code 的长篇网文辅助创作系统专门解决 AI 连载写作里的「遗忘」和「幻觉」两个顽疾支持 200 万字量级的长期连载。它的自检机制核心是一个布尔值mainline_ready和两条命令preflight、doctor。这篇文章拆解主链就绪的判定原理、两条自检命令的分工差异并给出一条从建档到排障的完整命令闭环。一、档案就绪机制mainline_ready 的判定原理动笔前老练的作家会先核对素材清单角色状态如何哪条伏笔该在本章回收Webnovel Writer 靠 Story System故事主链数据体系做这件事而mainline_ready就是核对结果的总开关。它是个布尔值直白理解就是这本书的写作档案是否就绪。计算逻辑不复杂为当前章节加载运行时资料只要出现任何fallback_sources降级来源指资料不完整时系统临时改用旧数据或缺省值它就置为false。核心实现在 story_runtime_health.py。字段含义mainline_ready主链资料是否完整无降级来源fallback_sources具体缺了哪些资料latest_commit_status最近一次章节提交是accepted、rejected还是missingprimary_write_source本章实际取用的数据来源mainline_ready 为 false 时的修复步骤值为false意味着主链资料缺失继续写章会退回 fallback临时降级读取用旧资料或缺少本章写作要求前后不一致几乎是必然结果。项目自带的 author_error_catalog.json 把它列为must_handle必须处理级错误修复路径分两步走还没初始化过项目先跑/webnovel-init创建项目档案已经初始化过跑/webnovel-doctor查缺项补齐 Story System 合同和 accepted 状态的 commit。作者在词汇表里能查到这个字段的人话解释见 author_glossary.jsonStory System 主链是否已经具备继续写作所需的基础资料。二、场景对照preflight 与 doctor 的检查范围对比一句话概括preflight 是起飞前快检doctor 是全身体检。两者定义在同一个 CLI 入口 webnovel.py 里。对比项preflightdoctor定位运行环境快速预检阶段感知的只读项目体检检查范围插件路径、脚本路径、项目根、主链健康目录、文件、数据库、RAG、依赖、Dashboard 产物输出短小的通过/失败报告每项检查的影响说明 修复建议适用场景毫秒级适合每次动笔前跑更耗时适合排障时跑一个容易忽略的细节doctor 内部会先跑一遍 preflight再展开深度检查。所以 doctor 不通过时应该先定位 preflight 层面的报错再往下查。project-status 的辅助定位还有第三个命令容易和它俩混淆project-status。它只输出机器可读的短状态phase、目标章节、下一步不检查任何内容适合脚本化查询。写自动化脚本时用它读状态把两条自检命令留给人工介入。三、排障路径doctor 体检报告里的三个必查字段doctor 的报告会给每项检查标注状态、影响和修复建议。mainline_ready不 ready 时doctor.py 里的表述很直白影响是当前章节可能会使用 fallback source修复是补齐 Story System 合同和 accepted commit 后再写。排障时按顺序看这三处story_runtime.mainline_ready应为true。为false说明当前章节处于降级状态先回看第一节的两条修复路径。.story-system/commits/chapter_XXX.commit.json文件必须存在且状态为accepted。rejected意味着本章事实没进主链后续章节不能直接依赖它。projection_status应全部为done或skipped。它记录本章事实是否同步到状态、摘要、长期记忆和检索库出现pending或失败时用projections子命令从已有 commit 补跑。四、命令闭环init → preflight → write → doctor 的操作顺序日常连载不用背几十个工具子命令记住这四步就够/webnovel-init—— 建档只跑一次生成合同与主链资料python webnovel.py preflight --format json—— 动笔前快检确认环境与档案可用/webnovel-write 12—— 正式写作系统消耗主链资料产出正文/webnovel-doctor --chapter 12 --deep—— 报告异常时深度体检拿修复建议闭环的逻辑是每步给下步供料init 产出合同preflight 确认可用write 消费资料doctor 对任何偏离预期的状态给出修复路径。正常项目里每次动笔前只需 preflight只有mainline_readyfalse或报告异常时才升级到 doctor 深查。一句话口诀init 建档preflight 快检正常写异常找 doctor。相关资料入门docs/guides/commands.md命令详解与统一 CLI 用法、docs/operations/operations.md项目结构与运维排障webnovel-writer/skills/webnovel-doctor/SKILL.mddoctor 技能说明与检查项参考author_error_catalog.json错误目录与修复建议、author_glossary.json技术词到人话的对照表【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统解决 AI 写作中的「遗忘」和「幻觉」问题支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考