# AI智能小说生成器 – 项目文档

## 【一】项目简介
AI智能小说生成器是一款基于 Electron 开发的桌面级AI辅助创作工具，深度集成多款主流大语言模型（LLM），构建从故事构思、章节大纲到正文生成的全流程智能化创作链路，为小说创作提供全方位AI支持，大幅降低创作门槛、提升创作效率。

### 开发者信息
– 版本：v1.0.0
– 开源协议：MIT License

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 【二】核心功能特性

### 1. 多模型灵活支持
兼容四款主流大语言模型，适配不同创作需求与场景：
– DeepSeek：国产高性价比模型，响应高效，适配大规模创作与试错场景
– OpenAI：GPT系列旗舰模型，生成质量卓越，适合精品内容打磨与最终成稿
– Ollama：本地部署模型，支持完全离线运行，隐私性拉满，无需依赖网络
– OpenAI兼容：适配所有兼容OpenAI API的第三方服务，拓展性极强

### 2. 全流程智能创作
构建闭环创作链路，实现从创意到完稿的无缝衔接：
“`
故事创意 → AI生成大纲 → AI生成章节 → 状态管理 → 持续创作
“`
– 章节大纲生成：基于故事创意自动拆解章节结构，搭建创作框架
– 小说内容生成：依托大纲智能创作正文，单章字数稳定在2500-3000字
– 状态管理：自动追踪角色属性变化、世界设定更新，保持逻辑连贯
– 多章节连续生成：支持批量生成后续章节，确保剧情衔接自然
– 智能扩写：实时检测字数，不足时自动调用AI补充内容，保证文本充实度

### 3. 17种小说分类全覆盖
涵盖网文主流题材，每类配备专属创作模板体系：
– 核心分类：玄幻、都市、仙侠、历史、科幻、武侠、言情、悬疑、游戏、奇幻、军事、现实、二次元、体育、灵异、同人、短篇小说
– 专属模板包含：
– 定制化提示词模板
– 角色状态预设模板
– 世界设定框架模板
– 分类专属创作规则指南

### 4. 灵活的提示词管理系统
支持个性化定制，适配不同写作风格：
– 分类模板：17种题材默认提示词开箱即用，快速启动创作
– 自定义编辑：可修改作者角色设定、创作规则，贴合个人写作习惯
– 项目独立存储：每个小说项目配置单独保存，互不干扰
– 实时生效：修改后即时应用于生成流程，无需重启

### 5. 精细化设定管理系统
全维度管控故事要素，确保设定一致性：
– 角色状态追踪：记录主角、配角的等级、技能、装备、性格等属性变化
– 世界设定管理：统一管理世界观、势力分布、规则体系等核心设定
– AI智能建议：基于最新章节内容，自动生成设定更新优化建议
– 版本管理：支持设定多版本保存与历史回溯，灵活调整创作方向

### 6. 智能优化功能
提升内容质量与创作体验：
– 字数精准控制：自动检测章节字数，低于2500字时智能扩写补全
– 去AI味优化：内置10条专业润色规则，让生成内容更自然、更贴近人工写作风格
– 多轮上下文连贯：支持基于前文内容创作，确保章节间逻辑通顺、衔接流畅
– 创作进度自动保存：实时记录创作状态，随时可接续创作，避免内容丢失

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 【三】快速开始

### 环境要求
– Node.js：v24.11.0 及以上版本
– 操作系统：Windows 10 及以上
– 网络：需访问LLM API（使用本地Ollama模型可离线运行）

### 安装步骤
1. 克隆项目仓库或直接下载源码包至本地
2. 打开命令行工具，进入项目根目录，执行依赖安装命令：
“`bash
npm install
“`
3. 依赖安装完成后，启动应用：
“`bash
npm start
“`
4. 如需打包为独立桌面应用，执行：
“`bash
npm run build
“`
打包后的安装程序位于 `dist` 目录，可直接双击安装使用。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 【四】详细使用指南

### 第一步：配置LLM模型
1. 打开应用，点击左侧菜单栏「LLM配置」
2. 选择目标LLM提供商（DeepSeek/OpenAI/Ollama/OpenAI兼容）
3. 填写对应配置信息：
– DeepSeek：API Key + Base URL
– OpenAI：API Key + 模型名称（如gpt-4）
– Ollama：Base URL（默认：http://localhost:11434），自动获取本地模型列表
– OpenAI兼容：API Key + Base URL + 模型名称
4. 点击「测试连接」验证配置有效性
5. 验证通过后，点击「保存配置」完成设置

### 第二步：创建小说项目
1. 点击左侧菜单栏「提示词管理」
2. 在分类下拉框中选择目标小说题材（如：玄幻小说）
3. 查看系统默认提示词模板，可根据写作风格自定义编辑（可选操作）
4. 在「小说名称」输入框中填写项目名称
5. 点击「保存提示词」，完成小说项目创建

### 第三步：生成章节大纲
1. 点击左侧菜单栏「小说生成」
2. 找到「章节大纲生成」功能区
3. 在「小说名称」下拉框中选择已创建的项目
4. 在「故事创意/主题」文本框中输入核心构思（示例：”一个现代程序员意外穿越到修仙世界，利用编程思维修炼功法，最终成为一代宗师的故事”）
5. 设置生成数量（建议单次生成1章，规避Token限制）
6. 点击「开始生成大纲」，等待AI完成创作
7. 生成完成后，可通过「查看大纲列表」查阅详细内容

### 第四步：生成小说正文
1. 在「小说生成」功能区（大纲生成模块下方）
2. 选择目标小说名称
3. 设置生成章节数（建议单次生成1章，保证内容质量）
4. 勾选推荐配置项：
– ✅ 使用角色状态（推荐）
– ✅ 使用世界设定（推荐）
– ✅ 读取前面章节（从第二章开始勾选，确保剧情连贯）
5. 选择状态更新模式：
– 手动：不自动更新设定，完全由用户控制
– 半自动：AI生成设定更新建议，需用户确认后保存（推荐）
– 全自动：AI自动更新设定，无需用户干预
6. 点击「开始生成」，通过日志输出和进度条查看创作进度
7. 生成完成后，章节内容将自动保存至项目目录

### 第五步：管理角色状态与世界设定
1. 点击左侧菜单栏「设定管理」
2. 选择目标小说名称
3. 查看当前角色状态与世界设定详情
4. 支持以下操作：
– 手动编辑JSON内容，修改角色属性、世界规则等
– 点击「生成状态建议」，AI将基于最新章节自动生成设定更新方案
– 分别点击「保存角色状态」「保存世界设定」，确认修改内容

### 第六步：持续创作
重复「第三步：生成章节大纲」与「第四步：生成小说正文」，即可接续创作后续章节。应用将自动实现：
– 跳过已生成的大纲与章节，避免重复创作
– 自动参考前文内容，保持剧情连贯性
– 基于剧情发展动态更新角色状态与世界设定
– 实时保存创作进度，支持断点续写

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 【五】项目文件结构
应用将在项目根目录自动创建 `userdata` 文件夹，集中存储所有小说项目数据，结构如下：
“`
userdata/
└── projects/ # 所有小说项目总目录
└── [你的小说名]/ # 单个小说项目目录
├── configs/ # 项目配置文件目录
│ ├── prompts.json # 提示词配置文件
│ ├── story-idea.json# 故事创意存储文件
│ └── progress.json # 创作进度记录文件
├── storylines/ # 章节大纲存储目录
│ ├── 第1章大纲.json
│ └── 第2章大纲.json
├── chapters/ # 小说正文存储目录
│ ├── [小说名]第1章.txt
│ └── [小说名]第2章.txt
└── data/ # 设定数据存储目录
├── chapter_001_state.json # 第1章角色状态文件
├── chapter_002_state.json # 第2章角色状态文件
└── world_bible_00.json # 世界设定文件
“`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 【六】常见问题解答

### Q1：如何选择合适的LLM模型？
– DeepSeek：性价比首选，计费低廉且响应迅速，适合大规模创作、题材试错等场景
– OpenAI：质量标杆，文笔细腻、逻辑严谨，适合精品内容打磨、最终成稿优化
– Ollama：隐私优先，完全本地运行无需网络，适合对数据隐私要求高的创作场景

### Q2：生成内容字数不足怎么办？
应用会自动检测字数，低于2500字时触发一次智能扩写。若仍未达标，可能原因及解决方案：
– 模型输出长度限制：调整模型参数（如Max Tokens）
– 提示词优化：在提示词中明确要求「详细描写场景、心理活动，确保内容充实」
– 大纲细节不足：补充大纲的情节节点、场景描述，为AI提供更丰富的创作依据

### Q3：如何减少生成内容的「AI味」？
– 应用已内置10条「去AI味」规则，自动应用于生成流程
– 提示词优化：添加「口语化表达、自然流畅、避免生硬说教、增加细节描写」等要求
– 采用「半自动」状态更新模式，手动调整AI生成的内容与设定
– 生成后进行人工润色，优化语句节奏、补充个性化表达

### Q4：能否同时创作多部小说？
完全支持！每个小说项目独立存储配置、大纲、章节及设定数据，互不干扰。通过「小说名称」下拉框即可快速切换不同项目。

### Q5：生成的文件保存在哪里？
所有文件集中存储于 `userdata/projects/[小说名]/` 目录：
– 大纲：`storylines/第X章大纲.json`
– 正文：`chapters/[小说名]第X章.txt`
– 角色状态：`data/chapter_XXX_state.json`
– 世界设定：`data/world_bible_XX.json`

### Q6：如何备份小说项目？
直接复制 `userdata/projects/[小说名]/` 文件夹即可完成完整备份，建议定期备份至云盘或移动硬盘，避免数据丢失。

### Q7：应用支持哪些操作系统？
– 主力支持：Windows 10 及以上版本（适配性最佳）
– 兼容支持：macOS、Linux（需用户自行打包编译，可能存在部分功能适配差异）

### Q8：生成过程中可以中断吗？
可以随时关闭应用或停止生成操作。应用会自动保存已生成的内容与创作进度，下次启动后可接续创作，无需重新开始。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 【七】技术架构说明

### 核心技术栈
– Electron 28.1.0：跨平台桌面应用开发框架
– Node.js 24.11.0：JavaScript运行环境
– Axios 1.6.2：HTTP客户端，用于LLM API调用
– JavaScript Obfuscator 4.1.0：代码混淆工具

### 核心模块介绍
– LLM管理器：统一封装多模型API调用接口，处理模型连接、请求分发与响应解析
– 小说生成器：核心业务逻辑模块，负责章节生成、字数检测、智能扩写等功能
– 大纲生成器：基于故事创意与分类模板，拆解章节结构、生成情节框架
– 模板加载器：管理17种题材的提示词、角色设定、世界设定默认模板
– 全局状态管理：实现跨组件数据同步、事件通知，确保创作流程连贯

### 配置文件说明
– `prompt-templates.json`：17种小说分类的默认提示词模板
– `default-settings.json`：角色状态与世界设定默认模板
– `generation-prompts.json`：AI生成（正文、扩写、状态更新等）通用提示词
– `outline-templates.json`：分分类大纲生成提示词模板

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 【八】界面功能介绍

### 主界面布局
采用左右分栏设计，操作逻辑清晰：
– 左侧：功能菜单栏（提示词管理、设定管理、小说生成、LLM配置、关于）
– 右侧：内容操作区（显示当前功能的操作面板、日志输出、进度展示）

### 界面特色
– 现代化卡片式布局，视觉层次分明，操作直观
– 多彩主题设计，兼顾美观与视觉舒适度
– 实时日志输出，生成过程、错误信息一目了然
– 进度条动态反馈，创作状态实时可见
– 一键式核心操作，降低使用门槛，新手友好

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 【九】致谢
感谢以下开源项目与工具的支持，为本项目的开发提供了核心支撑：
– Electron：强大的跨平台桌面应用开发框架
– Axios：高效稳定的HTTP客户端工具
– DeepSeek：国产优秀大语言模型，提供高性价比AI能力
– Ollama：便捷的本地大语言模型运行工具
– 特别感谢开源社区中分享小说创作提示词模板的各位开发者

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 【十】总结
AI智能小说生成器是一款集「多模型适配、全流程辅助、高自由度定制」于一体的AI创作工具，无论是深耕网文领域的专业作者、热爱写作的文学爱好者，还是初次尝试小说创作的新手，都能通过这款工具快速启动创作、提升产出效率。

工具是创意落地的桥梁，而真正的故事灵魂源于创作者的想象力。愿这款工具成为你创作路上的得力助手，让创意高效落地，助力你实现文学梦想！