YILING0013/AI_NovelGenerator

AI 小说生成器 – 概述

AI 小说生成器 是一款自托管 Web 应用程序，帮助作家利用大语言模型规划和撰写小说。它结合了 Next.js 前端、FastAPI 后端和 MongoDB 存储。用户提供自己的 LLM API 密钥（OpenAI、Gemini、Claude、DeepSeek 等），应用程序构建提示词、发送给模型，并返回可编辑、保存和进行版本控制的生成文本。

核心功能（根据 README 描述）

领域	应用功能
小说管理	创建项目“书架”；存储标题、核心创意、情节、世界观、风格、视角、篇幅等。字段可手动编辑或由 AI 填充。
雪花式规划	引导作家从高层故事核心逐层细化：卷 → 幕 → 场景 → 章节计划 → 散文。每层都有可编辑字段（目标、节拍、角色等）。
章节编辑	集成编辑器，显示章节计划、手稿、修订历史，以及检查角色心理、关系、世界规则等的“章节记录”。
实体与关系管理	用于角色、派系、地点、物品、世界规则、伏笔线索的专用卡片，以及可视化关系图。
AI 工作流设计器	基于节点的画布，每个节点可读取数据、准备上下文、调用 LLM、合并结果或输出候选。内置工作流涵盖小说创建、角色生成、卷规划、场景/幕生成、散文起草和章节后检查。用户可复制、编辑和串联节点以构建自定义流水线。
模型集成	支持 OpenAI、DeepSeek、Gemini、Claude 及兼容端点的适配器。用户可在各节点配置 API 密钥、端点 URL、模型名称和生成参数。
响应式 UI	支持桌面和移动端，浅色/深色主题，以及英文/中文界面。

工作原理（高层流程）

在设置中配置模型（提供 API 密钥、端点、模型名称）。
创建小说项目 – 输入简要构思和目标篇幅。
运行内置雪花工作流 – 应用提示模型将核心创意扩展为完整的规划层（卷、幕、场景等）。
在每个规划层编辑/确认实体（角色、派系、地点）。
使用章节计划节点生成章节散文 – 模型接收计划、相关上下文以及您设置的约束条件。
编辑手稿，查看修订历史，并接受生成的文本。
章节后检查自动验证世界规则和角色状态的一致性。
对后续章节重复操作，直至小说完成。

安装与运行（摘要）

先决条件：Python 3.13/3.14、Node 20+、MongoDB 副本集（提供 Docker compose）、可选 Docker 用于数据库。
步骤：
1. 克隆仓库，设置 Python 虚拟环境，安装 requirements.txt。
2. cd frontend && npm ci 安装 UI。
3. 通过 docker compose -f compose.mongodb.yaml up -d 启动单节点 MongoDB 副本集，并运行 rs.initiate(...)。
4. 将 backend/config/config_default.yaml 复制为 config.yaml 并填写 MongoDB URL。
5. 启动服务 – 在 Windows 上双击 start.bat（桌面启动器），或运行后端 python main.py，前端 npm run start。
访问：UI 在 http://127.0.0.1:3300，API 文档在 http://127.0.0.1:8200/docs。

适用人群

作家：希望获得 AI 辅助头脑风暴和起草，同时将所有数据保持在本地。
独立开发者或爱好者：探索 LLM 驱动的内容生成流水线。
研究者：研究叙事创作中的人机协作工作流。

许可证

根据 GNU Affero 通用公共许可证 v3.0 分发。

结论

AI 小说生成器是一款全栈、本地托管的工具，可让您使用雪花法结构化小说、管理角色和世界观细节，并通过可配置的 LLM 工作流生成或修改散文。它是 AI 增强创意写作软件的具体实例，而非简单的演示或教程集。