AI_NovelGenerator本地部署与快速上手完整指南：4步跑通AI长篇小说生成器

AI_NovelGenerator本地部署与快速上手完整指南：4步跑通AI长篇小说生成器

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

写长篇写到十几章，剧情断裂、设定打架？AI_NovelGenerator 是一款基于大语言模型的长篇小说生成工具，能自动衔接上下文、管理伏笔。这篇本地部署教程带你完成安装、配置到首次生成，全程照着操作即可出稿。

🧭 AI_NovelGenerator 是什么：长篇小说生成的四段式工作流

先花一分钟搞清楚它怎么干活，后面配置才不会填错。

它解决的是长篇创作里最头疼的两件事：上下文断裂和设定前后矛盾。整体流程分四段，每段产出对应文件：

1. 生成架构：根据主题和类型，产出世界观、角色、伏笔线（Novel_architecture.txt）；
2. 生成目录：基于架构为全部章节生成标题与简要提示（Novel_directory.txt）；
3. 生成草稿：逐章产出大纲与正文（outline_X.txt、chapter_X.txt），并用向量检索召回前文关键信息；
4. 定稿章节：更新全局摘要、角色状态、剧情要点（global_summary.txt、character_state.txt、plot_arcs.txt）并写入向量库，供后续章节调用。

每一章定稿前还可以点击「一致性审校」，自动扫描人名、剧情矛盾并在日志区提示。适合三类人：需要批量产出长篇的作者、希望文本与向量数据全部留在本地的写作者、以及只用 Ollama 等本地模型不想买云 API 的开发者。

📋 AI_NovelGenerator 本地部署环境自查：Python 版本与依赖安装

部署前先对照下表确认机器满足条件，缺哪补哪。

确认无误后，执行这条命令克隆代码并安装全部依赖：

git clone https://gitcode.com/GitHub_Trending/ai/AI_NovelGenerator cd AI_NovelGenerator pip install -r requirements.txt

[!TIP] 安装中途报编译错误，基本就是缺 C++ 构建工具：Windows 安装 Visual Studio Build Tools 并勾选「C++ 桌面开发」，Linux 先装build-essential，然后重跑上面的安装命令即可。个别依赖缺失时，用pip install 包名单独补装。

⚙️ AI_NovelGenerator 配置教程：config.json 四组关键参数速查

配置按「用途」拆成四块，对着填就行，不必把每个预设都填满。先复制一份模板作为实际配置文件：

cp config.example.json config.json

用途一：生成模型（llm_configs）。挑一个你手头能用的预设，填好api_key、base_url、model_name、interface_format四项。云端服务直接填官方地址；用 Ollama 时base_url填http://localhost:11434/v1，model_name填本地已部署的模型名。

用途二：向量化模型（embedding_configs）。负责把前文切成向量供检索，填api_key、base_url、model_name（如text-embedding-3-small或 Ollama 的nomic-embed-text）和retrieval_k。

用途三：作品参数（other_params）。填topic（主题）、genre（类型）、num_chapters（总章数）、word_number（单章字数）、filepath（生成文件保存路径）。

用途四：任务分配（choose_configs）。五个键对应五类任务——architecture_llm（设定）、chapter_outline_llm（目录）、prompt_draft_llm（草稿）、final_chapter_llm（定稿）、consistency_review_llm（审校），各填一个模型预设名，也可以全填同一个。

最容易填错的参数集中在下表：

[!WARNING] 切换 embedding 模型后一定要清空vectorstore/目录再重新定稿，否则旧模型产生的向量会混进新检索，导致召回不准。用 Ollama 做 embedding 时，先启动服务并拉取模型：

ollama serve ollama pull nomic-embed-text

所有参数之后都能在图形界面设置区改，配置文件里只需保证一个 LLM 预设和一个 Embedding 预设完整可用。更多字段含义见 config.example.json，参数解析逻辑在 config_manager.py。

🚀 AI_NovelGenerator 快速上手：python main.py 启动命令与 3 个验证检查点

配置存好后，执行这条命令启动主程序：

python main.py

窗口弹出只代表环境通了，按下面 3 个检查点逐项核对，全过才算部署成功：

1. 界面响应：GUI 正常打开，包含设定、目录、章节编辑等分区，设置区能回显你填的模型名、主题、章节数；
2. 模型链路打通：保存路径指向一个空目录，点击「Step1. 生成架构」，日志区走完后无连接错误；
3. 产物落盘：保存路径下出现Novel_architecture.txt，打开确认里面有世界观、角色与伏笔线内容。

第 2 项卡住时，看日志区报什么错，直接翻下一节的排障表处理。

🔍 AI_NovelGenerator 质量调优与故障排查：部署后常见问题处理

质量调优：三个高频现象的对症调整

• 现象：章节文字重复、剧情跑偏 →调整：草稿步骤的「本章指导」输入框里写具体情节点和人物动作 →效果：本章围绕指定指导展开，跑题明显减少

• 现象：文本僵硬、句式单调 →调整：temperature从 0.5 提到 0.7–0.8 →效果：表达更多样，开始出现创造性描写

• 现象：中后期章节出现人名、剧情前后矛盾 →调整：retrieval_k从 4 提到 6–8，并在每章定稿前点「一致性审校」 →效果：召回更多前文，冲突点在日志区被自动指出

故障排查：按报错信息对照处理

更多模块细节可参考 中文文档、核心生成逻辑 novel_generator/ 与界面代码 ui/。

至此，AI_NovelGenerator 的本地部署与验证已全部完成。下一步：在界面里用 10 章的短篇把「生成架构→生成目录→章节草稿→定稿」完整跑一遍，并在定稿前启用一致性审校，体会自动查错的效果。

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