Webnovel Writer - 让 AI 写长篇小说不再「乱编」和「忘事」
解决 AI 写作最大痛点：200 万字连载不矛盾，自动管理角色、剧情、世界观
项目背景
你有没有遇到过这样的场景：用 AI 写小说，写到第 50 章时发现主角的武功名字变了，第 80 章时配角突然性格大变，第 100 章时前面埋的伏笔完全忘了？
这就是 AI 写长篇内容的两大致命问题：
- 遗忘问题：AI 无法记住几百章的内容细节
- 幻觉问题：AI 会「发明」新设定，导致前后矛盾
Webnovel Writer 就是为解决这个问题而生的。
项目简介
Webnovel Writer 是一个基于 Claude Code 的长篇网文辅助创作系统。它的目标很简单：让 AI 在写长篇小说时不乱编、不忘事。
GitHub 地址：https://github.com/lingfengQAQ/webnovel-writer
开源协议：GPL v3
主要语言：Python
Stars：3470 ⭐（热度非常高！）
系统会自动管理：
- ✅ 角色设定（性格、外貌、武功、关系网）
- ✅ 剧情伏笔（埋下的线自动追踪）
- ✅ 世界观规则（不会突然改变设定）
让你可以安心连载几百章而不用担心前后矛盾。
技术架构
核心技术栈
- Claude Code：Anthropic 的官方 AI 编程助手，提供智能写作能力
- Python 3.10+：主要编程语言
- RAG 系统：检索增强生成，解决「遗忘」问题
- 嵌入模型：Qwen/Qwen3-Embedding-8B
- 重排序模型：jina-reranker-v3
- Story System：独创的「合同系统」，解决「幻觉」问题
Story System 主链架构
这是项目的核心创新点：
写作前 → 读取 MASTER_SETTING.json、volumes、chapters、reviews
写作中 → AI 基于合同和记忆生成内容
写作后 → 提交 CHAPTER_COMMIT → 更新投影
关键设计：
- .story-system/ 是真源（真正的数据源）
- .webnovel/* 是投影（读写模型）
- 合同种子 + 运行时合同 + 章节提交 + 事件审计
这套架构保证了：
1. AI 写每一章前都知道前面的设定
2. AI 不能随意「发明」新设定（必须符合合同）
3. 所有修改都有审计记录
核心功能
1. 自动记忆管理
系统会自动记住：
- 角色信息：主角、配角的名字、性格、武功、装备
- 剧情线索：埋下的伏笔、未解决的债务
- 世界设定：地理、历史、规则
长期记忆闭环：
- 写前注入：自动加载相关记忆
- 写后沉淀：新内容自动归档到记忆库
2. 追读力系统
这是一个很网文特色的功能，系统会分析：
- Hook（钩子）：章末的悬念点
- Cool-point（爽点）：读者的情绪高潮点
- 微兑现：小伏笔的快速解决
- 债务追踪：未兑现的大伏笔
帮助作者把控节奏，避免「挖坑不填」。
3. 37 个网文题材模板
内置了 37 个常见的网文题材模板：
- 玄幻、仙侠、都市、科幻、历史...
- 每个模板都有对应的套路、设定建议
4. 可视化 Dashboard
/webnovel-dashboard
提供只读面板，可以：
- 浏览项目状态
- 查看实体图谱（角色关系网）
- 阅读章节内容
- 分析追读力数据
5. 多 Agent 协作
系统内置多个专用 Agent：
- 规划 Agent：生成大纲
- 写作 Agent：撰写正文
- 审查 Agent：检查一致性
- 运维 Agent：管理记忆库
所有 Agent 默认继承当前会话模型，也可以单独指定。
快速开始
1. 安装插件
通过 Claude Code 官方 Marketplace 安装：
claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user
claude plugin install webnovel-writer@webnovel-writer-marketplace --scope user
如果只想在当前项目生效，把
--scope user改成--scope project
2. 安装 Python 依赖
python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txt
3. 初始化小说项目
在 Claude Code 中输入：
/webnovel-init
系统会引导你填写：
- 书名
- 题材（选择 37 个模板之一）
- 主角信息
- 世界观设定
然后在当前工作区下创建项目目录。
4. 配置 RAG（必做）
这是系统的核心，必须配置才能正常工作。
进入书项目根目录，复制配置模板：
cp .env.example .env
编辑 .env，填写 API Key：
# 嵌入模型配置（用于记忆检索）
EMBED_BASE_URL=https://api-inference.modelscope.cn/v1
EMBED_MODEL=Qwen/Qwen3-Embedding-8B
EMBED_API_KEY=your_embed_api_key# 重排序模型配置（提高检索精度）
RERANK_BASE_URL=https://api.jina.ai/v1
RERANK_MODEL=jina-reranker-v3
RERANK_API_KEY=your_rerank_api_key
为什么需要两个 API？
- 嵌入模型：把文字转为向量，用于相似度检索
- 重排序模型：对检索结果重新排序，提高相关性
5. 开始写作
核心命令：
# 规划大纲
/webnovel-plan 1 # 规划第 1 卷大纲# 撰写章节
/webnovel-write 1 # 写第 1 章# 审查一致性
/webnovel-review 1-5 # 审查第 1-5 章，检查前后矛盾
推荐流程：
1. 先规划整卷大纲（确定主线）
2. 按章节逐个写作（系统自动注入记忆）
3. 定期审查（发现并修复矛盾）
6. 启用可视化面板（可选）
/webnovel-dashboard
可以实时查看：
- 项目整体状态
- 角色关系图谱
- 各章节内容
- 追读力分析
技术亮点分析
1. 合同系统（Contract System）
这是最创新的部分。
传统 AI 写作的问题：
- AI 的「短期记忆」有限，写长篇会忘
- AI 没有「约束」，会随意发明设定
Webnovel Writer 的解决方案：
- 合同种子：初始化时定义核心设定（不可违背）
- 运行时合同：随剧情发展动态更新（需审批）
- 章节提交：每章写完提交到系统（自动归档）
- 事件审计：所有修改都有记录（可追溯）
这就像给 AI 定了一套「宪法」：
- 基础设定是宪法，不能违背
- 新内容是法律，需要符合宪法
- 所有立法过程都有记录
2. RAG 智能上下文
系统会智能检索相关内容：
写前注入：
- 自动加载相关角色的设定
- 自动加载相关剧情的伏笔
- 自动加载相关世界观规则
检索策略：
- auto：智能混合检索（推荐）
- graph_hybrid：图谱 + 向量混合检索
- BM25：传统关键词检索（备选）
保证 AI 写每一章时都「知道」前面的内容。
3. 记忆闭环
长期记忆管理流程：
写前 → 从记忆库注入相关上下文
写中 → AI 基于上下文生成内容
写后 → 新内容沉淀到记忆库
运维 → 定期整理、压缩、归档
/webnovel-memory 命令提供运维功能：
- 查看记忆状态
- 手动整理记忆
- 压缩旧记忆
- 恢复误删内容
4. 多模型支持
系统支持多种模型：
- Claude（推荐，效果最好）
- Gemini
- Codex
可以在不同 Agent 上使用不同模型：
- 规划 Agent 用 Claude（需要高质量推理）
- 写作 Agent 用 Gemini（速度快）
- 审查 Agent 用 Claude（需要细心）
适用场景
✅ 推荐使用
- 长篇网文连载（100+ 章）
- 复杂世界观的故事
- 多角色、多线索的剧情
- 需要埋伏笔、追读力的网文
❌ 不推荐使用
- 短篇小说（记忆系统优势不明显）
- 简单单线的剧情
- 不需要 Claude Code 的环境
实战案例
案例 1：玄幻小说连载
项目：《天道至尊》
章节数：200+ 章
字数：约 200 万字
题材：玄幻（使用模板）
使用效果：
- 主角的功法名称前后一致
- 配角的性格没有突变
- 前面埋的伏笔在后面都有兑现
- 追读力系统帮助把控节奏
案例 2：都市重生文
项目：《重生之商业帝国》
章节数：50+ 章
题材：都市重生（使用模板）
使用效果：
- 时间线清晰（没有时空错乱）
- 商业逻辑一致（没有突然开挂）
- 人物关系网自动管理
项目价值
对作者的价值
- 解放脑力：不用人工记几百章的设定
- 提高质量：自动检查前后矛盾
- 加速创作：AI 辅助，效率提升
- 学习参考：37 个题材模板，套路大全
对 AI 的价值
- 解决遗忘：RAG 让 AI 记住所有内容
- 解决幻觉：合同系统约束 AI 不乱编
- 结构化创作：从大纲到正文到审查，全流程
总结
Webnovel Writer 是一个非常创新的 AI 写作辅助系统，它用技术手段解决了 AI 写长篇内容的核心痛点：
- 遗忘问题 → RAG 检索增强
- 幻觉问题 → 合同系统约束
- 管理问题 → 记忆闭环 + 可视化面板
如果你：
- 正在写或计划写长篇网文
- 有 Claude Code 使用环境
- 想用 AI 辅助但担心质量失控
强烈推荐尝试这个项目。3470 Stars 的热度也证明了它的价值。
参考资料
- 项目地址：https://github.com/lingfengQAQ/webnovel-writer
- 详细文档：项目
docs/目录（架构、命令、RAG 配置等） - Claude Code：https://claude.ai/claude-code
- License：GPL v3
本文由 AI 辅助生成，基于项目 README 和 GitHub API 数据，经人工审核整理。
项目信息截至 2026-05-07，Stars 3470。