☰
Webnovel Writer FAQ:写完全章后,这 3 个状态与关卡问题还卡住你吗
2026/9/25 7:55:28 网站建设 项目流程

Webnovel Writer FAQ:写完全章后,这 3 个状态与关卡问题还卡住你吗

【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统,解决 AI 写作中的「遗忘」和「幻觉」问题,支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer

Webnovel Writer 是基于 Claude Code 的长篇网文辅助创作系统,解决 AI 写作中的「遗忘」和「幻觉」问题。本文直答新手最常卡壳的 3 个问题:本章事实到底算不算"入账"、write-gate三道关卡各查什么、报错了哪些必须亲手处理。

一、本章是 accepted 还是 rejected?看 commit 状态 📮

一句话结论:accepted相当于银行回执盖章——盖了章,本章事实才正式记入故事主链。

提交章节后,系统会生成.story-system/commits/chapter_XXX.commit.json,其中的status只有三种取值:

状态含义后果
accepted本章事实已通过提交下一章可以安全依赖它
rejected本章事实未通过提交不视为已写入,后续章节不能依赖
missing没有 commit 文件等于本章从未提交

项目自带词汇表 author_glossary.json 的"人话"译法:accepted是"本章事实已通过提交",rejected是"本章事实未通过提交"。

出错的修复路径:错误目录 author_error_catalog.json 把chapter-commit rejected列为must_handle(必须处理)级,修复分三步:

  1. 看报告里卡在哪一类:未覆盖节点(missed_nodes)、待确认歧义(pending)还是 blocking 审查问题
  2. 逐项修复后,用chapter-commit重新提交本章事实
  3. 确认status变为accepted,且五个投影的projection_status全部为done或skipped

二、write-gate 三道关卡:入场审查、出厂质检、发货对账 🏭

一句话结论:write-gate是写作流水线上的三道关卡,全过本章才能进入下一步。

三个stage定义在 write_gates/__init__.py:

关卡定位重点检查典型失败
prewrite入场审查项目阶段对不对、本章写作要求是否齐全合同缺失、写前校验有 blocking 项
precommit出厂质检正文存在且非空、四类中间结果文件齐全正文缺失、artifact 文件缺漏
postcommit发货对账commit 是否accepted、五项投影是否落地projection failed / pending

每道关卡的报告结构一致:ok只有 true / false 两态,失败项附带impact和repair,照着repair修完重跑同一条命令即可。判断依据见各关卡实现:precommit.py、postcommit.py。

💡别混淆:preflight不是章节关卡,它只快速校验插件路径、脚本路径、项目根这些运行环境,毫秒级出结果,适合每次动笔前跑一次,完全不检查章节内容。

三、报错该慌哪个?看 severity 三级分诊 🚦

一句话结论:错误目录把问题预先分了三档,只有红牌必须动手,绿牌交给系统。

author_error_catalog.json 给每条登记错误都标了severity:

严重级含义例子
must_handle必须处理,流程会卡住mainline_ready=false、write-gate failed、chapter-commit rejected
needs_confirmation待确认,系统可自动处理但要盯着projection pending
auto_handled系统已处理,无需干预rag degraded(检索临时降级)

用法很简单:每条错误的title都是人话(如"这本书的写作档案还没就绪"),next_action直接告诉你先跑什么,command标好兜底命令。比如rag degraded属于 auto_handled 级,目录写明:本次无需处理,经常出现再查 RAG API key 和网络配置。

💡避坑:看到报错先读severity。auto_handled级不挡写作,不用追;must_handle级才停下处理,否则下一章会带着旧资料继续写。

记住这个流程

写章 → 过三关 → 认 accepted → 按 severity 分级处理。

相关资料 📚

  • 命令详解(含 write-gate、projections 全部子命令):docs/guides/commands.md
  • 错误目录(含严重级与修复建议):webnovel-writer/references/author_error_catalog.json
  • 作者词汇表(技术词 → 人话):webnovel-writer/references/author_glossary.json
  • 项目阶段取值定义:webnovel-writer/scripts/data_modules/project_phase.py
  • 主链健康检查实现:webnovel-writer/scripts/data_modules/story_runtime_health.py

【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统,解决 AI 写作中的「遗忘」和「幻觉」问题,支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询