Webnovel Writer - 让 AI 写长篇小说不再「乱编」和「忘事」

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+ 章

**题材**：都市重生（使用模板）

**使用效果**：

时间线清晰（没有时空错乱）

商业逻辑一致（没有突然开挂）

人物关系网自动管理

---

项目价值

对作者的价值

1. **解放脑力**：不用人工记几百章的设定

2. **提高质量**：自动检查前后矛盾

3. **加速创作**：AI 辅助，效率提升

4. **学习参考**：37 个题材模板，套路大全

对 AI 的价值

1. **解决遗忘**：RAG 让 AI 记住所有内容

2. **解决幻觉**：合同系统约束 AI 不乱编

3. **结构化创作**：从大纲到正文到审查，全流程

---

总结

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。