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(必须处理)级,修复分三步:
- 看报告里卡在哪一类:未覆盖节点(missed_nodes)、待确认歧义(pending)还是 blocking 审查问题
- 逐项修复后,用
chapter-commit重新提交本章事实 - 确认
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),仅供参考