webnovel-writer · AIGC 内容生成

让 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 重度用户
推荐指数	⭐⭐⭐⭐（技术型用户强烈推荐，纯写作用户需评估学习成本）