如何快速上手AI_NovelGenerator：面向新手的完整指南

如何快速上手AI_NovelGenerator：面向新手的完整指南

【免费下载链接】AI_NovelGenerator使用ai生成多章节的长篇小说，自动衔接上下文、伏笔项目地址: https://gitcode.com/GitHub_Trending/ai/AI_NovelGenerator

写长篇小说，你是不是也常在第十章之后丢掉前后设定？AI_NovelGenerator 是一款 AI 小说生成工具，能自动衔接上下文、管理伏笔，一口气写出多章节的长篇小说。没写过代码的你，看完这篇也能在 10 分钟内生成第一个章节。

📌 核心功能速览

• 世界观设定工坊：根据主题先产出世界观、角色与剧情蓝图，跳过最难的开篇章
• 智能章节生成：设定、目录、草稿、定稿四步走，剧情不容易跑偏
• 语义检索引擎：向量检索回看前文伏笔，长篇也能前后自洽
• 一致性审校：自动检测角色逻辑和剧情矛盾，问题直接列在日志里
• 全程图形界面：配置、生成、审校都是点按钮，不用写代码

📋 部署前准备清单

1. Python 3.9 以上，推荐 3.10–3.12
2. pip 包管理器可用
3. 至少一个可用的 API 密钥：OpenAI、DeepSeek 等云端服务，或本地 Ollama（兼容 OpenAI 接口）
4. 若要启用云端向量检索，确认对应 API 的 Embedding 权限已开通

🚀 快速部署

1. 把项目拉到本地：

git clone https://gitcode.com/GitHub_Trending/ai/AI_NovelGenerator

2. 进入项目目录：

cd AI_NovelGenerator

3. 安装依赖，一次装齐所有组件：

pip install -r requirements.txt

4. 想用文件方式管理配置，就把示例配置复制一份再改：

cp config.example.json config.json

⚙️ 核心配置讲解

参数按"模型预设 + 任务分配"分组，在图形界面或 config.json 里改都可以。常用参数如下：

参数	作用	建议值或原因
api_key	大模型服务鉴权密钥	填对应服务商的密钥
base_url	API 地址	本地部署就填 Ollama 地址
model_name	主生成模型	如 deepseek-v4-flash、gpt-5.5
temperature	创意度，0–1	0.7 稳妥，调高更天马行空
max_tokens	单次回复最大长度	按章节长度取 8192–32768
retrieval_k	向量检索邻居数	4，性能与质量平衡点
num_chapters / word_number	总章数 / 每章字数	例如 10 章 × 3000 字
choose_configs	每个环节各用一个模型	草稿配快模型，定稿配强模型

🎬 首次运行体验

启动界面并填参数

运行python main.py打开图形界面。先填 API Key、Base URL、模型名称，再填主题（例如"废土世界的 AI 叛乱"）、类型、章节数、每章字数和保存路径。

生成世界设定

点击「Step1. 生成设定」。系统基于你的参数产出 Novel_setting.txt，包含世界观、角色信息与伏笔暗线，先通读一遍再改，后面少走弯路。

生成章节目录

点击「Step2. 生成目录」，得到 Novel_directory.txt，列出每章标题和简要提示。目录在这里定好，后面写章才有依据。

写第一章

填入章节号，在"本章指导"里给一句方向，点「Step3. 生成章节草稿」。系统会读取前文设定和已定稿章节，用向量检索调回相关剧情，产出 outline_X.txt 大纲和 chapter_X.txt 正文。

定稿并审校

点「Step4. 定稿当前章节」，全局摘要、角色状态和向量库都会更新，供后续章节调用。想挑毛病时点「一致性审校」，冲突会输出到日志区。之后重复"草稿 + 定稿"两件事，直到全书写完。

🔧 进阶技巧

• 想换模型服务：llm_adapters.py 封装了各家接口，切换成本低
• 想看审校怎么挑错：consistency_checker.py 里就是一致性检查的全部逻辑
• 章节生成、状态追踪等核心逻辑在 novel_generator/，调生成行为先翻这里
• 换本地 Ollama 做 Embedding 时，先执行ollama serve再拉取nomic-embed-text模型；换过 Embedding 模型后记得清空 vectorstore 目录

❓ 常见问题

报 "Expecting value: line 1 column 1" 怎么办？

多半是 API 没有返回有效 JSON，比如吐了个错误页面。检查密钥、base_url 是否填对，接口格式是否匹配。

遇到 504 Gateway Timeout 怎么处理？

先确认接口是否稳定、网络能否连通，也可以适当调大超时值。

想用本地 Ollama 怎么配？

base_url 填 Ollama 地址即可；如果用本地 Embedding，务必显式指定接口和模型名称。

Embedding 提供商怎么切换？

在界面对应输入框里直接填新服务商的参数就行，不用动代码。

写在最后

到这里，AI_NovelGenerator 已经搭好了。下次卡文时，先让它把第一章草稿跑出来，你只负责润色。它适合想提速的职业写手，也适合第一次尝试 AI 辅助写作的新手。

【免费下载链接】AI_NovelGenerator使用ai生成多章节的长篇小说，自动衔接上下文、伏笔项目地址: https://gitcode.com/GitHub_Trending/ai/AI_NovelGenerator