AI小说生成:7分钟装好本地长篇写作工具
【免费下载链接】AI_NovelGenerator使用ai生成多章节的长篇小说,自动衔接上下文、伏笔项目地址: https://gitcode.com/GitHub_Trending/ai/AI_NovelGenerator
AI小说生成工具里,AI_NovelGenerator 走的是完整长篇小说路线:你给一个主题,它按"架构→目录→草稿→定稿"四步产出多章正文,每章附伏笔与角色状态记录。手动写 20 章约 6 万字要几周,用这套流程,一章初稿以分钟计产出,你只负责改稿。
先看它最终产出什么
这一节先给你看产物清单,确认它是不是你要的东西。运行python main.py后你会看到主界面:左侧是 Step1. 生成架构、Step2. 生成目录、Step3. 生成草稿、Step4. 定稿章节四个顺序按钮加一个批量生成按钮,右侧是编辑器和输出日志。走一遍完整流程,保存目录里会陆续出现:
Novel_setting.txt:世界观、角色设定、触发点与伏笔Novel_directory.txt:每章标题加一句剧情提示outline_X.txt、chapter_X.txt:第 X 章的提纲和正文global_summary.txt、character_state.txt:前情摘要与角色状态,每定稿一章更新一次
核心生成逻辑在novel_generator/chapter.py:定稿时它把新章写入向量库,下一章生成时检索相关前文,这就是上下文衔接的实现方式。
📥 最小可行安装:一条命令级
目标:从零到能启动界面,要求 Python 3.9+(推荐 3.10–3.12)。
git clone https://gitcode.com/GitHub_Trending/ai/AI_NovelGenerator cd AI_NovelGenerator建虚拟环境并装依赖:
python -m venv .venv source .venv/bin/activate # Windows 用 .venv\Scripts\activate pip install -r requirements.txt依赖里包含 customtkinter(界面)、langchain 和 chromadb(向量检索),耗时约一两分钟。个别包编译失败时,按提示补装 C++ 构建工具后重跑最后一条命令即可。
⚙️ 配置 DeepSeek API 并启动界面
这一节解决"程序连哪里、用什么模型"的问题。本地部署小说写作工具,先复制仓库自带的完整模板作为你的配置:
cp config.example.json config.json打开 config.json,在llm_configs里填入api_key,其余字段(base_url、model_name、temperature 等)模板已带默认值,先不动。想完全免费,可把 base_url 指到本地 Ollama 的 OpenAI 兼容接口。然后启动:
python main.py界面打开后,在参数区填主题、题材、章节数(如 10 章 × 3000 字)和保存路径;API Key 也可以直接在界面上填。
📖 按四个按钮产出第一章
这一节是最小完整创作循环,跟着点一遍就能看到结果:
- Step1. 生成架构:产出
Novel_setting.txt,含世界观、角色与伏笔设计,可直接在编辑器里改。 - Step2. 生成目录:基于设定让 AI 自动生成章节大纲——每章标题加一句剧情提示,规划不满意就在这步改。
- Step3. 生成草稿:填章节号(如 1)和本章指导(如"主角在第三节亮出身份"),得到
outline_1.txt和chapter_1.txt。 - Step4. 定稿章节:把该章写入全局摘要、角色状态和向量库,供后续章节检索。
四步完成后,点"一致性校对"按钮,它由consistency_checker.py驱动,扫描最近一章的角色矛盾与剧情冲突,结果打在日志区。之后对第 2、3 章重复第 3、4 步,或直接用"批量生成"连跑多章。
🎚️ 三个值得动的参数
这一节只说值得改的三个参数,其余保持默认即可,它们直接影响 AI小说生成 的质量。
- temperature:0.7 是模板默认值,稳妥;想要更大胆的剧情走向,调到 0.9。
- retrieval_k:向量检索取回的最近邻数量,默认 4;长篇写到 20 章以后调到 6,能减少"忘记前情"。
- max_tokens:单章目标 3000 字以上时建议不低于 8192,否则正文可能被截断。
🐛 踩坑记录:两个高频报错
这两个报错占了官方 FAQ 的大多数,先认脸再排障。
API 没返回合法 JSON
日志出现Expecting value: line 1 column 1 (char 0),通常是接口返回了 HTML 错误页而非 JSON。先核对 api_key 和 base_url,再检查 config.json 里的proxy_setting代理设置。
504 Gateway Timeout
端点或网络抖动导致,重试即可;持续出现就在choose_configs里把对应任务换到更快的模型预设(五个任务各自独立指定模型,可单独替换)。另外注意:切换 embedding 模型后要清空vectorstore目录再生成,否则检索结果会串。
现在回到终端,确认 config.json 里已填好 api_key,执行python main.py打开界面,输入你的第一个主题,点 Step1 生成架构。
【免费下载链接】AI_NovelGenerator使用ai生成多章节的长篇小说,自动衔接上下文、伏笔项目地址: https://gitcode.com/GitHub_Trending/ai/AI_NovelGenerator
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考