webnovel-writer

让 AI 写到 200 章，依然记得住设定、接得住伏笔、守得住大纲

如果你是一名网文作者，你大概率遭遇过这种崩溃时刻：写到第 80 章时，AI 把三个月前埋下的伏笔忘得一干二净，主角的名字在不同章节里出现了三种叫法，战力体系在第 45 章突然崩掉，世界观规则自相矛盾——读者在评论区留下一串问号，你只能对着 AI 暴怒："你不是看过大纲吗？"

这正是 Webnovel Writer 试图解决的核心问题。它不是又一个"AI 一键生成小说"的噱头工具，而是一套面向长篇连载的一致性系统，专门解决 AI 写作中最顽固的两大顽疾——"遗忘"（上下文窗口之外的设定被丢弃）和**"幻觉"**（AI 自作主张编造与大纲冲突的情节）。

这套系统的开发者 lingfengQAQ，本身是一名活跃的网文作者，他把自己写长篇连载时积累的经验，转化为一套可复用的 Claude Code 插件。GitHub 数据显示该项目已积累超过 6600 个 stars，有多个 B 站 UP 主做了深度测评，在"AI 辅助网文创作"这个细分领域属于头部开源项目。

---

从第 1 章到第 200 章：AI 为何记不住

用 AI 写小说，最痛苦的不是生成第一章，而是保持连续性。当上下文窗口超过 AI 的极限之后，早期章节中的设定、世界观规则、角色关系就会逐渐从 AI 的"记忆"中消失。这是大语言模型的固有限制——Transformer 的注意力机制天然倾向于关注最近的 token，距离越远的信息权重越低。

传统的解决方案是手动提供大量背景信息，但这种方式有两个致命缺陷：信息过多会让 AI 困惑（提示词膨胀），信息过少又无法支撑一致性。Webnovel Writer 的思路是将写作过程工程化，把"记忆"从隐式的上下文，变成显式的可查询数据。

打个比方：传统 AI 写作像是一个记忆力极差但文笔出色的枪手作者，每章都要重新交代背景；而 Webnovel Writer 给这个枪手配了一个超详细的故事数据库和专职编辑，动笔前先查资料，写完后编辑审查，审查通过才归档，同时把新信息同步进数据库。这样即写到了第 200 章，AI 依然可以精准查询第 15 章某个配角的战斗力数值。

---

核心架构：三层记忆 + 多 Agent 协作

Webnovel Writer 的架构可以概括为**"三层记忆 + 多 Agent 协作"**。

第一层：Story System（故事系统）。这是整个系统的"真源"，位于项目根目录的 .story-system/ 目录。里面包含：MASTER_SETTING.json（总设定）、volumes/（卷合同）、chapters/（章合同）、reviews/（审查合同）。所有写入操作最终都要经过这里——写作前查合同，写完后签合同，合同就是约束，违约就审查失败。

第二层：投影层（Read Model）。.webnovel/ 目录下的 state.json、SQLite 数据库 index.db、向量数据库 vectors.db、摘要文件和长期记忆文件，都是从 Story System 投影出来的只读视图。Dashboard 面板读取的就是这一层。

第三层：工具层。Python 脚本 scripts/webnovel.py 是统一的工具入口，提供 preflight（预检）、story-system（合同管理）、memory-contract（记忆查询）、index（索引操作）等 CLI 命令。

在工具层之上，是 8 个 Claude Code Skill 命令（即斜杠命令）和 4 个子 Agent：

Agent	职责
Context Agent	写前 research，从数据库构建"创作任务书"——本章上下文、约束条件、追读力策略
Reviewer Agent	章节审查，从爽点、一致性、时间线、角色 OOC、连贯性、追读力六个维度打分
Data Agent	从正文中提取实体，生成 commit artifacts，驱动状态同步
Deconstruction Agent	参考书拆解，提炼可迁移的写作手法，扩充项目长期记忆

这种设计的好处是职责单一、可独立测试、可替换：审查不满意可以换 Reviewer 的 prompt，数据提取有问题可以调整 Data Agent 的提取规则，底层数据格式保持不变。

---

写章流水线：不是一次生成，而是一条关卡链

/webnovel-write 是整个系统最核心的命令。它的执行流程不是简单地把章纲丢给 AI 生成，而是一条带多个检查点的完整流水线：

Step 1：预检。检查目录结构、数据库、RAG 索引、Dashboard 产物的健康状态，有问题提前暴露。

Step 2：上下文准备。Context Agent 读取 Story System 中的章合同，加载 MASTER_SETTING、章节摘要、追读力数据、题材资料和作者文风修正，生成一份精准的"创作任务书"。

Step 3：起草。基于创作任务书起草章节正文。

Step 4：审查。Reviewer Agent 从六个维度审查章节：爽点密度与质量（High-point）、设定一致性（战力/地点/时间线）、节奏比例（Strand Weave 系统：60% 主线 Quest、20% 感情线 Fire、20% 世界观 Constellation）、角色是否 OOC（Out of Character）、叙事连贯性、钩子强度与追读力。

Step 5：润色与提交。Data Agent 从审查通过的章节中提取实体和状态变更，生成 CHAPTER_COMMIT，驱动投影写作者更新 state.json、index.db、摘要和长期记忆。

Step 6：备份。章节正文和 commit artifacts 归档。

整个流程中，只有在创作方向、事实一致性或 blocking issue 上才需要作者裁决，其他步骤全自动执行。重复执行 /webnovel-write 时，系统会先检查可信断点，从失败点继续，不重写已完成的部分。

---

防幻觉三定律：把约束变成铁律

Webnovel Writer 架构文档中明确提出了防幻觉三定律：

大纲即法律。Context Agent 强制加载章节大纲作为写作约束，不允许 AI 擅自偏离。

设定即物理。Reviewer Agent 内置一致性审查，世界规则就像物理定律一样不可违背。

发明需识别。新出现的实体必须经过 Data Agent 提取、消歧，然后登记入库。没有登记的实体就是不存在。

这三定律通过 Story System 的合同机制落地：动笔前 AI 必须签合同（加载章合同），写完后必须通过审查才能签收（CHAPTER_COMMIT 提交），违规内容被 Reviewer 标记为 blocking issue。

---

可视化 Dashboard：状态一目了然

系统自带一个 FastAPI 驱动的只读 Dashboard，启动命令是 /webnovel-dashboard。这是一个预打包好的前端（Vite + 前端框架），跟着插件一起分发，本地不需要跑 npm build。

Dashboard 可以查看：

• 项目整体状态：当前章节数、字数、追读力趋势
• 实体关系图：角色、法宝、势力、地点之间的关联
• 章节内容：按卷/章浏览正文
• 伏笔追踪：哪些伏笔已回收、哪些悬而未决
• 追读力数据：以"钩子强度"和"期待管理"为核心的阅读吸引力指标

Dashboard 通过 path_guard 模块防止目录穿越攻击，严格限制只读访问。

---

题材覆盖与 RAG 配置

系统内置了 37 个中文网文题材模板（都市、玄幻、仙侠、穿越、系统流、高武、末世等），开箱即用。同时支持多题材混合创作，比如"都市 + 系统流"或"仙侠 + 异能"。

RAG（检索增强生成）配置是可选的。需要配置 .env 文件中的 EMBEDDING_API_KEY（OpenAI 兼容格式），启用语义召回。不填也能用——系统会自动退回 BM25 关键词检索，只是语义理解能力会弱一些。Embedding 和 Reranker 都支持替换为任何 OpenAI 兼容接口。

---

上手门槛：命令行用户友好，但有学习曲线

Webnovel Writer 是一个 Claude Code 命令式写作系统，面向的是熟悉终端操作、了解 Claude Code 基本用法的用户。安装流程是通过 Claude Code Marketplace 安装插件，然后用 /webnovel-init 引导初始化项目。

对于纯写作用户来说，有一定的技术门槛：

• 需要安装 Claude Code（Anthropic 官方 CLI 工具）
• 需要配置 Python 3.10+ 环境
• RAG 功能需要申请 Embedding API Key
• 所有操作通过命令行（/webnovel-init、/webnovel-write、/webnovel-review 等）

Dashboard 提供了一个相对友好的图形界面，但整体来说，这套系统更适合有技术背景的网文作者或AI 写作爱好者，而非纯写作小白。

---

v7 重构进行中：从插件走向更通用的架构

值得注意的是，项目当前处于 v7 重构 RFC 公示期，开发者 lingfengQAQ 在 GitHub Discussions 上公开征集设计反馈。v7 的主要方向是让系统从 Claude Code 插件走向更通用的 Agent 架构，解耦对 Claude Code 的依赖，同时引入更标准化的记忆管理和事件溯源机制。

这说明项目在快速迭代中，v7 可能会带来breaking change，但当前的 v6 已经是一个功能完整、经过大量用户验证的稳定版本。

---

行业意义：AI 网文写作的工具化标杆

在"AI 写小说"这个赛道上，大多数工具的思路是"让 AI 写得更多、更快"，而 Webnovel Writer 的思路是"让 AI 写得更一致、更可控"。这是本质上的区别。

它代表了一种趋势：当 AI 生成能力已经不是瓶颈时，工作流设计和一致性管理成为了真正有价值的差异化方向。Story System 的合同驱动机制、Reviewer 的六维审查、追读力量化指标——这些都来自真实的连载写作经验，有很强的实践基础。

据 B 站多个 UP 主的测评和媒体报道，使用 Webnovel Writer 辅助创作的中文网文作品已在番茄小说等平台连载，其中不乏百万字级别的长篇作品。当然，AI 辅助写作的质量最终仍取决于作者的把控能力——工具再强，也替代不了对故事本身的理解。

---

总结

维度	评估
定位	面向长篇网文连载的 AI 一致性管理系统
核心能力	多 Agent 协作写章、六维审查、合同驱动的状态管理、可视化 Dashboard
技术栈	Python + Claude Code + FastAPI + SQLite + 向量检索
上手难度	中等偏高，需熟悉命令行和 Claude Code
容器化	❌ 不支持 Docker，❌ 不支持 docker-compose
Web UI	✅ 有只读 Dashboard（FastAPI）
License	GPL v3
适用人群	有技术背景的网文作者、AI 写作爱好者、Claude Code 重度用户
推荐指数	⭐⭐⭐⭐（技术型用户强烈推荐，纯写作用户需评估学习成本）