AIxiezuo：基于LangChain的开源AI小说生成系统，支持多模型交互与全流程创作管理

原创 发布日期：
6

一、AIxiezuo是什么？

AIxiezuo一款开源的AI小说生成系统，基于LangChain框架构建，核心定位为“专业化AI辅助小说创作工具”。该系统支持DeepSeek、OpenAI（GPT-3.5/4）、Claude、Gemini等主流大语言模型，同时兼容第三方API接入；具备章节状态跟踪（主角属性、物品清单、剧情摘要）、世界设定保存、多小说项目隔离、多版本内容比较等核心功能，并提供直观的Web操作界面，降低技术门槛。用户通过“安装依赖→配置API密钥→启动Web服务”三步即可上手，可用于个人小说创作、写作辅助、内容团队批量产出等场景。

AIxiezuo并非简单的“文本生成工具”，而是针对小说创作全流程设计的“AI辅助创作平台”——它以LangChain为技术底座，将大语言模型的文本生成能力与小说创作的专业化需求（如剧情连贯性、角色一致性、世界设定统一性）结合，解决传统AI生成小说时“剧情断层、角色人设崩塌、设定混乱”等问题。

从项目定位来看，AIxiezuo有三个核心属性：

  1. 开源工具属性：项目代码完全开源（仓库地址：https://github.com/yefeng2renxing/AIxiezuo），遵循MIT许可证，用户可自由下载、修改、二次开发，无商业使用限制（需遵守开源协议）；

  2. 专业化创作属性：区别于通用AI聊天工具（如ChatGPT），它内置“小说项目管理”“章节状态跟踪”“世界设定存储”等专属功能，比如生成第二章时会自动读取第一章的角色状态（如主角年龄、能力变化），确保剧情逻辑连贯；

  3. 低门槛交互属性：提供Web界面（推荐使用）与命令行两种启动方式，其中Web界面无需代码基础，通过可视化操作即可完成“创建项目→设定世界观→生成章节→修改内容”全流程，降低非技术用户的使用门槛。

项目的核心目标是“让AI成为小说创作者的‘辅助笔’，而非‘替代者’”——用户负责核心创意（如世界观设定、章节大纲），AI负责将创意转化为具体文本，并通过状态管理确保创作过程的连贯性，同时支持用户手动修改内容、调整设定，保留创作主导权。

二、功能特色：针对性解决小说创作痛点

AIxiezuo的功能设计完全围绕小说创作的实际需求展开，每个功能均对应一个创作痛点，下表清晰展示其核心功能、具体表现与用户价值：

功能分类 具体表现 用户价值
多模型灵活支持 1. 原生支持4类主流模型：DeepSeek（deepseekchat/deepseekreasoner）、OpenAI（GPT-3.5/4）、Anthropic（Claude）、Google（Gemini）；
2. 支持第三方API接入：通过.env文件配置DSFAPIMODEL/KEY/URL，可对接自定义模型；
3. 模型切换便捷：Web界面下拉选择或命令行指定model_name参数。		 1. 避免单一模型依赖，可根据需求选择“性价比高”（如DeepSeek）或“创作能力强”（如GPT-4）的模型；
2. 支持第三方模型扩展，满足特殊创作场景（如特定风格模型）；
3. 无需修改代码，非技术用户也能切换模型。
全维度状态管理 1. 角色状态跟踪：存储主角姓名、年龄、等级、能力、性格、目标等信息（如“练气一层”“坚韧不拔”）；
2. 剧情关联数据：记录物品清单（如“铁剑-普通铁制长剑”）、人物关系（如“师父-师徒-友好”）；
3. 自动状态更新：生成章节后，可基于内容自动更新角色状态（如主角获得新能力）。		 1. 解决“人设崩塌”问题：AI生成后续章节时会参考历史状态，避免主角性格、能力突然变化；
2. 减少手动记录成本：无需单独文档记录角色关系、物品，系统自动存储；
3. 剧情连贯性提升：状态文件相当于“创作备忘录”，确保前后章节逻辑一致。
可视化Web界面 1. 核心操作入口：包含“小说项目列表”“世界设定编辑”“章节大纲输入”“模型选择”“生成结果预览”模块；
2. 即时交互反馈：生成章节时显示进度，生成后支持在线编辑、保存、对比版本；
3. 无需代码基础：所有操作通过鼠标点击完成，替代复杂的命令行调用。		 1. 降低使用门槛：非技术用户（如纯文学创作者）无需学习Python命令，直接通过浏览器操作；
2. 提升创作效率：一站式完成“设定→生成→修改”，无需切换多个工具；
3. 即时反馈减少等待焦虑：清晰显示生成进度，避免“不知道是否在运行”的问题。
多项目隔离管理 1. 唯一标识：每个小说项目对应一个“novelid”（如“myxianxianovel”）；
2. 数据隔离：所有数据（状态文件、章节内容、世界设定）按novelid分类存储（如data/myxianxianovelchapter1_state.json）；
3. 项目切换：Web界面“小说列表”模块一键切换不同项目。		 1. 支持同时创作多部小说：比如同时写修仙、都市两类题材，数据互不干扰；
2. 便于项目管理：按ID快速定位某部小说的所有文件，避免数据混乱；
3. 备份便捷：只需复制对应novel_id的文件夹，即可备份整个项目。
多版本对比与管理 1. 版本存储：生成章节时自动记录版本号（如chapter1v1、chapter1v2）；
2. 对比功能：支持同一章节不同版本的文本对比，高亮差异内容；
3. 版本选择：可指定某一版本为“正式版”，后续章节基于该版本生成。		 1. 保留创作迭代痕迹：避免“生成新版本后丢失旧版本”的问题，便于回溯修改；
2. 优化内容质量：对比不同模型、不同大纲生成的版本，选择最优文本；
3. 降低试错成本：可大胆尝试不同生成参数，不满意可随时切换回旧版本。

AIxiezuo：基于LangChain的开源AI小说生成系统，支持多模型交互与全流程创作管理

三、技术细节：从架构到存储的完整解析

要理解AIxiezuo的运行逻辑，需从技术架构、文件结构、数据存储、API设计四个维度展开，这部分内容既适合开发者二次开发，也能帮助普通用户理解“系统如何工作”，避免使用中出现操作失误。

3.1 技术架构：基于LangChain的模块化设计

AIxiezuo采用“核心层+模块层+交互层”的三层架构，依赖LangChain框架实现“模型调用、记忆管理、流程控制”的解耦，具体架构如下：

  • 核心层：以main.py为入口，封装NovelGenerator核心类，负责协调各模块工作，提供“生成章节”“更新状态”“交互聊天”三大核心能力；

  • 模块层：包含4个核心功能模块，均位于modules/目录下：

  • llm_module.py：模型调用模块，统一封装不同模型的API接口（如DeepSeek的调用函数、OpenAI的请求格式），实现“模型切换不修改业务逻辑”；

  • memory_module.py：记忆管理模块，负责读取/写入章节状态文件、压缩历史剧情（避免上下文过长）、提取关键信息（如角色能力变化）；

  • setting_module.py：设定管理模块，处理世界设定文件的创建、版本控制、参数传递（如将“修仙世界-练气→筑基→金丹”的设定传给模型）；

  • workflow.py：工作流模块，定义“生成章节”的标准化流程（接收大纲→调用记忆模块获取历史状态→传给llm模块生成文本→调用setting模块更新设定→保存结果）；

  • 交互层：包含Web交互（web_server.py+web/目录）与命令行交互（main.py直接调用），负责接收用户输入（如大纲、模型选择）并返回结果。

这种模块化设计的优势在于：若需新增功能（如支持新模型），只需修改llm_module.py；若需优化状态管理，只需调整memory_module.py，无需改动整个系统，便于二次开发。

3.2 文件结构：清晰的目录划分

项目文件按“功能用途”分类存储，用户无需深入代码，只需了解关键文件的作用，即可完成基础配置与使用，下表为核心文件/目录说明：

目录/文件名称 位置 核心作用
main.py 根目录 核心类NovelGenerator的定义文件，提供generate_chapter()等核心方法，命令行调用入口；
start_web.py 根目录 Web服务启动脚本，运行后启动Flask服务器（默认端口5001），推荐用户使用；
web_server.py 根目录 Web服务核心逻辑，处理“生成章节”“获取小说列表”等HTTP请求，对接前端页面；
.env 根目录 环境配置文件，存储API密钥（如DEEPSEEKAPIKEY）、第三方模型参数（如DSFAPIURL）；
requirements.txt 根目录 依赖清单，包含LangChain、Flask、requests等所有需安装的Python库；
DEV_DOC.md 根目录 开发文档，记录“记忆获取逻辑”“代码冗余删除”等开发细节，供二次开发参考；
TEMPLATE_GUIDE.md 根目录 模板指南，说明prompts/目录下提示词模板的修改方法（如调整写作规则）；
WEB_USAGE.md 根目录 Web界面使用说明，包含“创建项目”“生成章节”等操作步骤的图文指导；
data/ 根目录 存储状态文件与世界设定文件（如novel1_chapter_1_state.json）；
xiaoshuo/ 根目录 存储生成的章节内容，纯文本格式（如novel1_chapter_1.txt）；
prompts/ 根目录 提示词模板目录，包含writer_role.txt（作者角色定义）、writing_rules.txt（写作规则）；
templates/ 根目录 小说模板目录，按类型分类（如爽文模板），通过template_index.json管理索引；
web/ 根目录 Web前端文件，包含index.html（页面结构）、app.js（交互逻辑）、style.css（样式）；

3.3 数据存储：结构化与非结构化结合

AIxiezuo的数据存储分为“结构化数据”（状态、设定，JSON格式）与“非结构化数据”（章节内容，TXT格式），两种格式各有分工，确保数据可管理、可复用，具体如下：

（1）结构化数据：JSON格式，便于机器读取

  • 章节状态文件：

  • 存储位置：data/{novel_id}_chapter_{章节号}_state.json（如data/my_novel_chapter_1_state.json）；

  • 格式示例： json { "chapter_index": 1, "protagonist": { "name": "李青云", "age": 18, "level": "练气一层", "status": "健康", "personality": "坚韧不拔", "abilities": ["基础剑法"], "goal": "成为青云宗首席弟子" }, "inventory": [ { "item_name": "铁剑", "description": "普通的铁制长剑，剑身有轻微锈迹" } ], "relationships": [ { "name": "王长老", "relation": "师徒", "status": "友好，对主角寄予厚望" } ], "current_plot_summary": "李青云通过青云宗入门考核，拜王长老为师，获得第一把修炼用铁剑，开始练气一层的修炼" }

  • 核心作用：记录当前章节的“关键信息快照”，后续章节生成时，模型会读取该文件，确保角色、剧情连贯。

  • 世界设定文件：

  • 存储位置：data/{novel_id}_world_bible_{版本号}.json（如data/my_novel_world_bible_v1.json）；

  • 格式示例： json { "world_name": "青云修仙界", "setting": "古代修仙背景，天下分五大宗门，青云宗以剑法闻名，存在“邪修”与“正道”的对立", "power_system": "练气→筑基→金丹→元婴→化神，每阶分初期/中期/后期/巅峰", "locations": ["青云宗（主峰：通天峰）", "黑风谷（邪修聚集地）", "迷雾森林（资源点）"], "important_items": ["青云剑诀（宗门核心功法）", "聚气丹（练气期常用丹药）"], "key_npcs": ["青云宗掌门（元婴期）", "黑风谷谷主（金丹后期邪修）", "药堂刘长老（筑基期，擅长炼丹）"] }

  • 核心作用：定义小说的“世界观基础”，模型生成内容时会遵循设定（如不出现“现代科技”元素），避免设定混乱。

（2）非结构化数据：TXT格式，便于人类阅读

  • 章节内容文件：

  • 存储位置：xiaoshuo/{novel_id}_chapter_{章节号}.txt（如xiaoshuo/my_novel_chapter_1.txt）；

  • 格式特点：纯文本，无复杂格式，仅包含章节标题与正文（如“第一章：青云入门\n晨曦微露，青云宗山门前早已挤满了前来参加入门考核的少年……”）；

  • 核心作用：保存最终生成的章节文本，支持用户用记事本、Word等工具打开修改，也可直接复制到其他平台发布。

3.4 API接口设计：兼顾易用性与扩展性

AIxiezuo提供“核心方法API”（供开发者调用）与“Web API端点”（供前端界面调用），两种接口均遵循“简单参数、明确返回”的设计原则：

（1）核心方法API（NovelGenerator类方法）

  • 生成章节：generate_chapter(chapter_outline, model_name, novel_id, use_state=True, update_state=True)

  • 参数说明：

    • chapter_outline：必填，章节大纲（如“第二章：李青云参加宗门小比，遇到邪修偷袭”）；

    • model_name：必填，模型名称（如“deepseekchat”“openaigpt4”）；

    • novel_id：必填，小说项目ID（如“my_novel”）；

    • use_state：可选，是否使用历史状态（默认True，推荐开启，确保连贯）；

    • update_state：可选，是否自动更新状态（默认True，生成后更新角色信息）；

  • 返回值：生成的章节文本（字符串）。

  • 交互聊天：chat(user_input, session_id, model_name)

  • 用途：命令行下的交互式创作（如“让主角遇到一个神秘老人”），支持多轮对话；

  • 参数：user_input（用户指令）、session_id（会话ID，区分不同对话）、model_name（模型名称）；

  • 注意：项目文档明确“命令行使用麻烦，不推荐”，建议优先用Web界面。

  • 更新状态：update_state(chapter_content, current_state, novel_id)

  • 用途：手动更新章节状态（如自动更新不符合预期时，用户修改后调用）；

  • 参数：chapter_content（章节文本）、current_state（当前状态JSON）、novel_id（小说ID）；

  • 返回值：更新后的状态JSON。

（2）Web API端点

Web界面的所有操作均通过以下端点实现，普通用户无需手动调用，但了解后可排查网络问题：

  • GET /：返回Web界面首页（index.html），用户的核心操作入口；

  • POST /generate：接收“novelid、chapteroutline、model_name”等参数，触发章节生成，返回生成结果；

  • GET /novels：返回所有小说项目列表（JSON格式，包含novel_id、项目名称、创建时间）；

  • GET /novel/{novel_id}/info：返回指定小说的详细信息（包含已生成章节列表、世界设定版本、最新状态）。

四、应用场景：谁适合用AIxiezuo？

AIxiezuo的应用场景覆盖“个人创作”“团队协作”“教育辅助”等多个领域，不同用户群体可根据自身需求灵活使用，具体场景如下：

4.1 个人小说创作者（核心场景）

  • 适用人群：想写小说但缺乏时间、担心剧情断层的个人作者（如兼职创作者、文学爱好者）；

  • 核心需求：快速生成章节初稿、避免人设崩塌、管理多本小说项目；

  • 使用方式：

  1. 启动Web服务，创建小说项目（如“都市异能小说”，novelid设为“citysuperpower”）；

  2. 在“世界设定”模块填写异能体系（如“异能分S/A/B/C级，主角初始为B级速度异能”）、关键NPC（如“主角好友-警察-异能A级力量”）；

  3. 输入章节大纲（如“第三章：主角在超市遇到抢劫，首次使用异能救人，被警察好友发现”）；

  4. 选择模型（如“deepseek_chat”，性价比高），点击“生成章节”；

  5. 生成后在线修改细节（如调整对话语气），保存到xiaoshuo/目录，系统自动更新状态（主角异能熟练度提升）；

  • 价值：原本需要2小时写的章节初稿，现在3-5分钟生成，同时避免“写了10章后忘记主角能力”的问题，创作效率提升60%以上。

4.2 新媒体内容团队（批量创作场景）

  • 适用人群：需要批量产出小说类内容的新媒体团队（如网文平台、短视频文案团队）；

  • 核心需求：多项目并行管理、快速试错不同题材、统一内容风格；

  • 使用方式：

  1. 团队成员分工：一人负责“设定编写”（填写世界设定、角色信息），多人负责“章节生成”（各自处理不同项目）；

  2. 通过novel_id隔离项目（如“修仙001”“都市002”），避免数据混乱；

  3. 统一提示词模板：在prompts/writing_rules.txt中添加团队风格要求（如“语言简洁，每段不超过3行，适合手机阅读”）；

  4. 生成后通过“多版本比较”功能，选择符合平台风格的章节，批量导出到发布系统；

  • 价值：支持5-10个项目同时推进，团队人均日产出章节从2-3章提升到5-8章，同时通过统一模板确保内容风格一致，减少后期修改成本。

4.3 文学教育辅助（学习场景）

  • 适用人群：中小学语文老师、创意写作培训机构（教学生理解小说结构、剧情逻辑）；

  • 核心需求：直观展示“设定如何影响剧情”“角色状态如何推动故事”；

  • 使用方式：

  1. 老师在课堂上启动Web界面，创建“示例项目”（如“童话小说”）；

  2. 先让学生集体讨论世界设定（如“动物王国，狮子是国王，兔子是信使”）和角色状态（“兔子-12岁-擅长奔跑-目标：传递重要信件”）；

  3. 输入简单大纲（如“兔子送信途中遇到河流，无法过河”），生成章节；

  4. 修改角色状态（如给兔子添加“会游泳”的能力），重新生成章节，让学生对比“有游泳能力”和“无游泳能力”的剧情差异；

  • 价值：将抽象的“小说创作逻辑”转化为可视化操作，学生更容易理解“设定与剧情的关联”，提升创意写作兴趣。

4.4 小说IP孵化（试错场景）

  • 适用人群：IP孵化公司、独立创作者（想快速测试不同题材的市场潜力）；

  • 核心需求：短时间内产出多题材故事雏形、保留优质创意的迭代痕迹；

  • 使用方式：

  1. 针对同一核心创意（如“时间循环”），创建多个小说项目（“时间循环-校园”“时间循环-职场”“时间循环-悬疑”）；

  2. 为每个项目编写基础设定，生成1-3章内容，形成“故事雏形”；

  3. 通过“多版本比较”保存每个项目的不同迭代（如“校园版v1”“校园版v2”）；

  4. 基于雏形评估市场潜力（如用户反馈、阅读数据），选择优质项目深入创作；

  • 价值：原本需要1个月才能完成的“多题材试错”，现在1周内即可完成，大幅降低IP孵化的时间成本和风险。

AIxiezuo：基于LangChain的开源AI小说生成系统，支持多模型交互与全流程创作管理

五、安装使用方法

AIxiezuo的使用流程分为“环境准备→配置→启动→创作”四步，操作难度低，即使是非技术用户也能在10分钟内完成上手，以下为详细步骤（以Windows系统为例，Mac/Linux流程类似）：

5.1 第一步：环境准备（安装基础工具）

  1. 安装Python：

  • 下载地址：https://www.python.org/downloads/（推荐Python 3.9-3.11版本，避免版本兼容问题）；

  • 安装注意：勾选“Add Python to PATH”（添加到环境变量），否则后续无法在命令行调用Python；

  • 验证：打开“命令提示符”（Win+R，输入cmd），输入python --version，显示“Python 3.10.0”等版本信息即安装成功。

  1. 下载项目代码：

  • 方式1（推荐，需Git）：安装Git后，打开命令提示符，输入git clone https://github.com/yefeng2renxing/AIxiezuo.git，项目会下载到当前目录的“AIxiezuo”文件夹；

  • 方式2（无需Git）：访问项目仓库（https://github.com/yefeng2renxing/AIxiezuo），点击右上角“Code”→“Download ZIP”，下载后解压到电脑（如“D:\AIxiezuo”）。

  1. 安装依赖库：

  • 打开命令提示符，进入项目目录：输入cd D:\AIxiezuo（根据实际解压路径调整）；

  • 执行安装命令：输入pip install -r requirements.txt，等待安装完成（约1-3分钟，取决于网络速度）；

  • 注意：若出现“pip不是内部命令”，需重新安装Python并勾选“Add Python to PATH”；若安装失败，可尝试pip install --upgrade pip更新pip后再重新安装。

5.2 第二步：配置API密钥（核心步骤，必须完成）

AIxiezuo需要调用大语言模型API，因此必须配置至少一个模型的API密钥，步骤如下：

  1. 获取API密钥：

  • DeepSeek：访问https://www.deepseek.com/，注册账号后在“API密钥”页面生成；

  • OpenAI：访问https://platform.openai.com/，注册账号后在“API Keys”页面生成；

  • Claude：访问https://console.anthropic.com/，注册账号后在“API Keys”页面生成；

  • Gemini：访问https://ai.google.dev/，注册账号后在“API Keys”页面生成；

  • 注意：部分平台（如OpenAI）需要绑定银行卡，免费额度有限，建议优先选择有免费额度的平台（如DeepSeek）。

  1. 编辑.env文件：

  • 打开项目目录（如“D:\AIxiezuo”），找到.env文件（若没有，新建一个文本文件，重命名为“.env”，注意去掉“.txt”后缀）；

  • 用记事本或Notepad++打开.env，输入以下内容（至少保留一个模型的密钥，其他可删除或注释）：

     # DeepSeek API密钥（示例，需替换为自己的）
 DEEPSEEK_API_KEY=sk-1234567890abcdef1234567890abcdef

 # OpenAI API密钥（可选，不用则删除）
 # OPENAI_API_KEY=sk-proj-1234567890abcdef1234567890abcdef

 # 第三方API配置（可选，不用则删除）
 # DSF_API_MODEL="my_custom_model"
 # DSF_API_KEY="my_custom_key"
 # DSF_API_URL="https://api.example.com/generate"

  • 保存文件：确保密钥没有多余空格，否则会导致调用失败。

5.3 第三步：启动系统（推荐Web界面）

AIxiezuo提供两种启动方式，Web界面操作简单，是官方推荐的方式：

（1）Web界面启动（推荐）

  1. 启动服务：

  • 打开命令提示符，进入项目目录（cd D:\AIxiezuo）；

  • 输入启动命令：python start_web.py；

  • 成功标志：命令行显示“* Running on http://127.0.0.1:5001/ (Press CTRL+C to quit)”，表示Web服务已启动。

  1. 访问Web界面：

  • 打开浏览器（Chrome、Edge等），在地址栏输入http://127.0.0.1:5001，按回车；

  • 页面加载后，即可看到“AI小说生成系统”的Web界面，包含“小说列表”“创建项目”“生成章节”等模块。

（2）命令行启动（不推荐，适合开发者）

  1. 打开Python交互式环境：在项目目录下输入python；

  2. 输入以下代码（替换为自己的novel_id、大纲和模型）：

  # 导入核心类
  from main import NovelGenerator
  # 创建生成器实例
  generator = NovelGenerator()
  # 生成章节
  content = generator.generate_chapter(
    chapter_outline="第一章：主角李青云加入青云宗",
    model_name="deepseek_chat", # 与.env中配置的密钥对应
    novel_id="my_xianxia_novel" # 自定义小说ID
  )
  # 打印生成结果
  print(content)

  1. 注意：命令行方式无可视化界面，无法在线修改内容，且不支持多版本比较，仅推荐开发者测试功能时使用。

5.4 第四步：开始创作（Web界面操作流程）

以“创作修仙小说”为例，详细说明Web界面的创作步骤：

  1. 创建小说项目：

  • 在Web界面点击“创建新小说”按钮；

  • 输入“小说名称”（如“青云修仙录”）、“novelid”（如“qingyunxianxia”，只能包含字母、数字、下划线）；

  • 点击“创建”，系统会自动在data/和xiaoshuo/目录下创建该项目的相关文件夹。

  1. 编写世界设定：

  • 在项目列表中点击“青云修仙录”→“编辑世界设定”；

  • 填写“世界名称”“背景设定”“力量体系”“关键地点”“重要物品”“核心NPC”（参考前文世界设定文件示例）；

  • 点击“保存设定”，系统会在data/目录下生成qingyun_xianxia_world_bible_v1.json文件。

  1. 生成章节：

  • 点击“生成新章节”，输入“章节号”（如1）、“章节大纲”（如“李青云通过入门考核，拜王长老为师，获得铁剑”）；

  • 在“模型选择”下拉框中选择“deepseek_chat”（确保.env中已配置该模型密钥）；

  • 勾选“使用历史状态”（首次生成第一章可忽略，后续章节必选）和“自动更新状态”；

  • 点击“开始生成”，等待3-10秒（取决于网络速度和模型响应时间）；

  • 生成完成后，页面会显示章节内容，可直接在文本框中修改（如调整对话、补充细节）。

  1. 保存与管理：

  • 修改完成后，点击“保存章节”，系统会将内容保存到xiaoshuo/qingyun_xianxia_chapter_1.txt；

  • 点击“查看状态文件”，可查看自动生成的qingyun_xianxia_chapter_1_state.json（如主角“李青云”的年龄、能力等）；

  • 若想生成该章节的不同版本，只需修改大纲或模型，再次点击“生成”，系统会自动添加版本号（如chapter1v2）。

  1. 后续章节创作：

  • 生成第二章时，系统会自动读取第一章的状态文件，确保剧情连贯；

  • 若需调整角色状态（如主角升级到“练气二层”），可点击“编辑状态文件”，手动修改JSON内容后保存。

六、常见问题解答（FAQ）

6.1 启动Web服务后，访问http://127.0.0.1:5001显示“无法访问此网站”怎么办？

  • 可能原因1：端口被占用（5001端口被其他程序使用）；

  • 解决方案：修改start_web.py中的端口号，找到代码中“app.run(port=5001)”的部分，将5001改为其他未占用端口（如5002），重新执行python start_web.py，访问http://127.0.0.1:5002。

  • 可能原因2：依赖库未安装完整；

  • 解决方案：重新执行pip install -r requirements.txt，查看是否有“error”提示，若某库安装失败，可单独安装（如pip install flask安装Flask，pip install langchain安装LangChain）。

  • 可能原因3：Python版本不兼容（如使用Python 3.8以下或3.12以上版本）；

  • 解决方案：卸载当前Python，安装3.9-3.11版本，重新安装依赖并启动。

6.2 生成章节时提示“API key error”（API密钥错误），如何解决？

  • 可能原因1：.env文件中密钥填写错误（如多输空格、少输字符）；

  • 解决方案：打开.env文件，核对密钥与平台生成的是否一致，确保无多余空格（如“DEEPSEEKAPIKEY=sk-123”而非“DEEPSEEKAPIKEY= sk-123”）。

  • 可能原因2：模型名称与密钥不匹配（如用OpenAI的密钥，却选择“deepseek_chat”模型）；

  • 解决方案：确认模型名称与.env中的密钥对应（如选择“openaigpt35”需配置OPENAIAPIKEY，选择“deepseekchat”需配置DEEPSEEKAPIKEY）。

  • 可能原因3：API密钥已过期或余额不足；

  • 解决方案：登录对应平台（如DeepSeek官网），查看密钥状态和余额，若过期则重新生成密钥，若余额不足则充值或切换其他有额度的模型。

6.3 如何自定义小说的写作风格（如更简洁、更古风）？

  • 解决方案：修改prompts/目录下的提示词模板，具体步骤如下：

  1. 打开项目目录→prompts/文件夹，找到writing_rules.txt文件；

  2. 用记事本打开，添加风格要求（如“写作风格：古风文言文，用词简洁，避免现代词汇，对话用‘曰’‘道’等字”）；

  3. 保存文件，重新生成章节，模型会遵循新的写作规则生成内容；

  • 提示：也可修改writer_role.txt，定义“作者角色”（如“你是一位擅长古风修仙小说的作家，作品风格类似《诛仙》”），进一步强化风格。

6.4 多小说项目如何备份？是否支持迁移到其他电脑？

  • 备份方法：

  1. 找到项目目录下的data/和xiaoshuo/文件夹；

  2. 复制对应小说项目的文件（如data/qingyun_xianxia_*和xiaoshuo/qingyun_xianxia_*），粘贴到备份文件夹（如U盘、云盘）；

  • 迁移方法：

  1. 在新电脑上完成AIxiezuo的安装和API配置（参考“使用方法”前3步）；

  2. 将备份的data/和xiaoshuo/文件夹中的项目文件复制到新电脑的对应目录；

  3. 启动Web服务，即可在“小说列表”中看到迁移的项目，正常使用。

6.5 生成的章节内容太长/太短，如何调整字数？

  • 解决方案：在章节大纲中明确字数要求，或修改提示词模板，具体方式如下：

  1. 临时调整：在“章节大纲”中添加字数要求（如“第一章：李青云入门，字数控制在2000字左右，分5段”）；

  2. 永久调整：打开prompts/writing_rules.txt，添加“字数要求：每章字数控制在2000-3000字，段落数5-8段”，保存后所有章节生成都会遵循该要求；

  • 提示：不同模型对字数的控制精度不同，若效果不佳，可尝试切换模型（如GPT-4对字数的控制更精准）。

6.6 项目是否支持中文以外的语言（如英文、日文）小说生成？

  • 支持，操作步骤如下：

  1. 修改世界设定和章节大纲为目标语言（如英文大纲“Chapter 1: Li Qingyun joins Qingyun Sect”）；

  2. 修改prompts/目录下的模板文件为目标语言（如writing_rules.txt改为“Write in English, use simple sentences, suitable for fantasy novels”）；

  3. 选择支持多语言的模型（如OpenAI GPT-4、Gemini），生成章节即可；

  • 注意：部分模型（如DeepSeek的部分版本）对小语种支持较弱，建议优先选择OpenAI或Google的模型。

6.7 如何关闭“自动更新状态”功能？

  • Web界面：生成章节时，取消勾选“自动更新状态”选项，生成后系统不会修改状态文件；

  • 命令行：调用generate_chapter()方法时，设置update_state=False（如generator.generate_chapter(..., update_state=False)）；

  • 用途：当自动更新的状态不符合预期（如主角能力错误升级）时，可关闭该功能，手动修改状态文件后再继续创作。

七、相关链接

八、总结

AIxiezuo作为基于LangChain的开源AI小说生成系统，以“解决小说创作痛点”为核心，通过整合多类大语言模型、设计专业化的状态管理与项目隔离功能，同时提供低门槛的Web交互界面，平衡了“AI辅助效率”与“创作可控性”——既让非技术用户能快速生成章节初稿、管理多本小说，也让开发者可通过模块化设计进行二次开发。项目文档完善、安装步骤清晰，还提供用户交流群支持，降低了使用与扩展的门槛；遵循MIT许可证开源，确保商业与个人用户均可自由使用。无论是个人小说创作者、新媒体团队，还是文学教育者，都能根据自身需求灵活应用该系统，有效提升小说创作效率，同时保留核心创意的主导权，是一款兼具实用性与扩展性的AI辅助创作工具。

AI生成小说器 AI写小说 开源项目
打赏

版权及免责申明：本文由@AI工具集原创发布。该文章观点仅代表作者本人，不代表本站立场。本站不承担任何相关法律责任。

如若转载，请注明出处：https://www.aipuzi.cn/ai-news/aixiezuo.html

THE END
作者头像
AI工具集
工具不孤岛，AI集大成——这里有你要的一切智能解法