AI_NovelGenerator

使用ai生成多章节的长篇小说，自动衔接上下文、伏笔

项目简介

AI_NovelGenerator 是一款基于大语言模型（LLM）的多功能长篇小说自动生成工具，旨在帮助作者和创作者高效地构建具有连贯情节、统一世界观和严谨逻辑的长篇故事。该项目目前已在 GitHub 获得超过 5,100 颗星标和 930 多次 Fork，展现出相当不错的社区认可度。

对于有小说创作经验的朋友来说，写作长篇作品往往面临一个核心挑战：如何在动辄数十万字的故事中保持人物性格的一致性、情节发展的连贯性，以及前文埋下的伏笔能够合理回收。许多作者在创作中途会陷入「前后矛盾」「设定打架」的困境，不得不回头大段修改。AI_NovelGenerator 正是为了解决这些问题而诞生的——它通过向量检索技术维护长期上下文一致性，通过状态追踪系统管理角色发展轨迹和伏笔埋设，通过自动校对模块检测情节矛盾和逻辑冲突。

值得期待的是，根据项目最近的更新日志（2026年3月25日），作者已经完成了使用新技术栈重构的新版本初版开发，新版本即将上传至 dev 分支，届时会为用户带来更现代化的实现和全新的创作体验。

核心功能与架构

🎨 小说设定工坊

在开始正式创作之前，你需要为整个故事搭建一个坚实的世界观基础。小说设定工坊是 AI_NovelGenerator 的第一步，它会根据你提供的主题、类型和章节数量，自动生成一份完整的小说设定文档。这份文档通常包含以下核心内容：

• 世界观构建：故事发生的时空背景、社会结构、魔法或科技体系等基础设定
• 角色设计：主要人物的外貌特征、性格特点、背景故事、人际关系网络
• 触发点规划：故事中的关键事件节点，如主角相遇、反派登场、重大转折等
• 伏笔埋设：为后续情节发展预先设计的悬念和线索

这套设定文档将成为后续所有章节生成的基础参考，确保整个故事在宏观层面保持一致性。

📖 智能章节生成

传统的 AI 续写工具往往存在「上下文丢失」的问题——每生成一段新内容，AI 就会逐渐遗忘之前写过什么，导致情节前后脱节。AI_NovelGenerator 采用多阶段生成策略来解决这一难题：

1. 章节大纲生成：根据目录规划，为每个章节生成详细的写作提纲
2. 章节正文生成：基于提纲和上下文约束，生成符合人物性格和剧情发展的章节内容
3. 一致性校验：自动检查新章节与已有内容是否存在逻辑矛盾

这种分层递进的生成方式，能够在保证创作效率的同时，最大程度地维护故事的连贯性。

🧠 状态追踪系统

状态追踪系统是这款工具的「记忆中枢」。它会持续追踪：

• 角色发展轨迹：记录每个角色在不同阶段的能力成长、性格变化、人际关系演变
• 伏笔管理：标记已埋设的伏笔、预期回收伏笔的时机、实际回收情况
• 时间线维护：记录故事内的时间流逝、重要事件的发生顺序

通过这套系统，AI 在生成新章节时能够准确「回忆」起之前的情节细节，避免出现「角色死亡后又复活」「某个物品凭空消失」等低级 bug。

🔍 语义检索引擎

为了在长篇创作中快速定位相关内容，AI_NovelGenerator 集成了基于向量的语义搜索能力。当你需要查看某个特定情节或角色设定时，只需输入关键词，系统就能从数十万字的内容中找到语义最相关的段落。这项功能不仅方便你回顾前文，也为 AI 在生成新内容时提供了精准的上下文召回能力。

📚 知识库集成

系统支持接入本地文档作为参考资料。你可以将自己收集的世界观设定、角色原型、参考素材等文档导入知识库，AI 在生成内容时会结合这些参考资料进行创作。这对于希望将 AI 能力与自身创作风格融合的作者来说尤为实用。

✅ 自动校对模块

校对模块会自动检测生成内容中的潜在问题：

• 情节矛盾：检测新章节与前文设定不一致的地方
• 逻辑冲突：识别故事逻辑上的漏洞或不合理之处
• 伏笔遗漏：提醒哪些已埋设的伏笔尚未回收

这相当于为你的小说配备了一位不知疲倦的编辑，帮助你在发布前发现并修复问题。

🖥 可视化工作台

整个创作流程都通过直观的图形界面完成。你可以在工作台上一站式完成配置设置、设定生成、目录规划、章节生成和内容校对所有操作，无需记忆复杂的命令行参数。

快速上手

环境准备

在开始之前，请确认你的开发环境满足以下要求：

• Python 3.9+（推荐 3.10–3.12 版本）
• pip 包管理器
• 有效的 API 密钥（支持 OpenAI、DeepSeek 等云端服务，或 Ollama 等本地部署方案）

安装步骤

首先，克隆项目仓库到本地：

git clone https://github.com/YILING0013/AI_NovelGenerator
cd AI_NovelGenerator

为了隔离项目依赖，建议创建虚拟环境：

# 创建虚拟环境
python -m venv .venv

# Windows 系统激活
.venv\Scripts\activate

# Linux/Mac 系统激活
source .venv/bin/activate

然后安装项目依赖：

pip install -r requirements.txt

如果某些依赖安装失败（通常是缺少 C++ 编译工具），需要额外安装 Visual Studio Build Tools，并在安装时勾选「C++ 桌面开发」工作负载。

配置说明

安装完成后，你需要对 config.json 文件进行配置。这是整个项目的核心配置文件，决定了 AI 如何与你的 API 服务通信，以及小说的基本参数。

{
   "api_key": "sk-your-api-key-here",
   "base_url": "https://api.openai.com/v1",
   "interface_format": "OpenAI",
   "model_name": "gpt-4o-mini",
   "temperature": 0.7,
   "max_tokens": 4096,
   "embedding_api_key": "sk-your-embedding-api-key",
   "embedding_interface_format": "OpenAI",
   "embedding_url": "https://api.openai.com/v1",
   "embedding_model_name": "text-embedding-ada-002",
   "embedding_retrieval_k": 4,
   "topic": "赛博朋克都市中，孤独的义体黑客揭开企业阴谋的故事",
   "genre": "科幻",
   "num_chapters": 120,
   "word_number": 4000,
   "filepath": "D:/AI_NovelGenerator/output"
}

配置项的详细说明如下：

启动程序

配置完成后，在终端中运行：

python main.py

程序将启动图形界面，你可以开始创作流程。

创作流程演示

启动后的完整创作流程分为三个步骤：

第一步：生成设定

在界面中填写主题、类型和章节数量后，点击「Step1. Generate Settings」按钮。系统会自动生成 Novel_setting.txt 文件，包含完整的世界观、角色和伏笔设定。你可以打开文件查看并根据需要手动调整。

第二步：生成目录

基于上一步的设定，点击「Step2. Generate Directory」生成章节目录 Novel_directory.txt。这份目录包含每个章节的标题和简短描述。你可以审阅并修改章节大纲，确保故事走向符合预期。

第三步：生成章节正文

选择要生成的章节编号（如输入 1 生成第一章），你还可以为当前章节添加特殊指导（如「本章重点描写主角的内心独白」）。点击生成后，系统会综合已有设定、目录和前文内容，生成符合上下文语境的章节正文。

生成过程中，你可以随时暂停或中断，生成的内容会自动保存。如果对某章节不满意，可以反复重新生成或手动编辑文件。

使用场景

个人小说创作

对于有创作欲望但缺乏系统写作经验的作者，AI_NovelGenerator 是一个很好的起点。你可以用它快速验证故事构思是否有趣，观察 AI 如何处理你设定的人物和世界观，从中获得灵感。即使最终不直接使用 AI 生成的内容，工具帮你梳理的设定文档和章节结构本身也具有很高的参考价值。

剧本和大纲规划

编剧或短视频创作者可以用它来快速构建故事骨架。传统的「大纲-正文」两阶段创作中，大纲阶段往往需要反复推敲。借助 AI 的快速生成能力，你可以在更短时间内尝试多种剧情走向，找到最优解。

世界观和角色设定生成

即使你不需要生成完整正文，项目的设定生成功能本身也很有价值。你可以让 AI 为你创建详细的世界观设定、丰富的角色背景故事、复杂的人物关系网络，然后将这些设定应用到自己的创作中。

跨平台世界观融合创作

项目 README 中的示例主题非常有趣——「星穹铁道的的主角穿越到原神的提瓦特大陆拯救世界」。这类跨 IP 的融合创作是 AI 工具的强项，因为它天然适合处理「需要大量背景知识但又要进行创意改编」的任务。

注意事项

API 成本控制

AI_NovelGenerator 需要调用大语言模型 API 来生成内容，而 API 调用是按 token 计费的。在配置 num_chapters 和 word_number 时需要考虑成本因素：

• 生成一部 120 章、每章 4000 字的长篇小说，Token 消耗相当可观
• 建议先用小规模配置（10-20 章）测试效果，确认满意后再逐步扩大规模
• 可以使用 temperature 参数控制创意程度，降低参数值可以减少无效生成，间接节省 Token

本地部署方案

如果你对隐私有要求或希望降低 API 调用成本，可以考虑使用 Ollama 等本地部署方案。Ollama 支持在本地运行开源大语言模型（如 Llama、Qwen 等），完全免费且无需联网。但需要注意，本地模型在生成质量和速度上可能不如商业云服务。

生成质量与后期编辑

尽管项目内置了多种一致性保障机制，AI 生成的内容仍可能存在情节生硬、对话不够自然、细节前后略有出入等问题。建议将 AI 生成视为「初稿」，经过人工审阅和编辑后再使用。校对模块的自动检测结果值得重视，但最终的文学质量仍需创作者把关。

新旧版本选择

根据项目动态，作者正在推进新版本的开发，预计会采用更现代化的技术栈。如果你追求稳定性，可以继续使用当前主分支版本；如果你对新技术感兴趣，可以关注 dev 分支的更新进展。

总结

AI_NovelGenerator 是一款将大语言模型能力与长篇小说创作流程深度结合的工具。它通过设定工坊、状态追踪、语义检索、自动校对等多项功能，解决了传统 AI 续写工具在长篇创作中的核心痛点——上下文丢失和情节不一致。对于想要探索 AI 辅助创作的作者来说，这是一款值得一试的入门级工具。

当然，任何 AI 写作工具都不能替代人类创作者的审美判断和情感表达。AI 更适合扮演「高效的助手」而非「创作的主体」，帮你处理繁琐的信息整理和初稿生成工作，而故事的灵魂——那些独特的思想、细腻的情感、深刻的洞察——始终需要人来赋予。希望你在使用这款工具的过程中，能够找到属于自己的 AI 辅助创作节奏。

项目信息

参考链接

• GitHub 仓库