# AI-generation-novel

**Repository Path**: Gaokkk/ai-generation-novel

## Basic Information

- **Project Name**: AI-generation-novel
- **Description**: AI-generation-novel：专注于利用AI技术创作小说的开源项目，旨在为创作者提供灵感与工具，支持多种风格与类型的小说生成。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-09-25
- **Last Updated**: 2025-09-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 爱生文 - AI小说生成器

一个基于人工智能的网络小说生成工具，帮助作者快速创作精彩小说。通过AI技术辅助创作，提高小说创作效率和质量。

![Python](https://img.shields.io/badge/Python-3.x-blue.svg)
![Flask](https://img.shields.io/badge/Flask-2.3.3-green.svg)
![License](https://img.shields.io/badge/License-MIT-yellow.svg)

## 🚀 主要特性

### 📖 小说创作功能
- **智能大纲生成**：根据主题、类型、章节数自动生成详细的小说大纲
- **章节内容生成**：基于大纲生成具体的章节内容，支持丰富的情节描写
- **多种小说类型支持**：玄幻、都市、历史、科幻、武侠、言情、悬疑等
- **角色与世界观构建**：AI辅助构建人物设定和故事背景

### ⚙️ 配置管理
- **大模型配置**：支持多种AI模型的灵活配置
- **参数调节**：温度值、最大Token数等参数可调
- **环境变量管理**：通过.env文件管理配置信息
- **连接测试**：一键测试AI API连接状态

### 💻 用户体验
- **现代化界面**：响应式设计，支持移动端访问
- **实时生成**：流畅的内容生成体验
- **错误处理**：完善的错误处理和重试机制
- **会话管理**：支持多个小说项目的会话管理

## 📋 系统要求

- Python 3.x
- Flask 2.3.3
- 具备API访问能力的大语言模型（如Qwen、GPT等）

## 🛠️ 快速开始

### 1. 克隆项目

```bash
git clone https://github.com/your-username/ai-generation-novel.git
cd ai-generation-novel
```

### 2. 安装依赖

```bash
pip install -r requirements.txt
```

### 3. 配置环境变量

复制并编辑`.env`文件：

```bash
# 大模型配置
LLM_API_KEY=your_api_key_here
LLM_API_URL=https://api.example.com/v1/chat/completions
LLM_MODEL_NAME=your_model_name
LLM_TEMPERATURE=0.7
LLM_MAX_TOKENS=1000
LLM_PROMPT=你是一名专业的小说家，根据用户需求创作精彩的小说内容。
LLM_ROLE=user

# 其他配置
DEBUG=True

# 小说配置
NOVEL_NAME=小说名称
NOVEL_GENRE=小说类型
NOVEL_THEME=小说主题
NOVEL_TOTAL_NUMBER_OF_CHAPTERS=5
```

### 4. 运行应用

```bash
python app.py
```

访问 http://localhost:5000 开始使用。

## 📖 使用指南

### 第一步：配置大模型

1. 点击页面右上角的「大模型设定」按钮
2. 填写您的API密钥、API地址和模型名称
3. 根据需要调整温度值和最大Token数
4. 点击「测试API连接」确保配置正确
5. 保存配置

### 第二步：创建小说项目

1. 填写小说基本信息：
   - **小说名称**：为您的小说起一个吸引人的名字
   - **小说类型**：选择合适的小说类型（玄幻、都市、科幻等）
   - **小说主题**：描述小说的主要内容或关键词
   - **章节数量**：设置小说的总章节数

2. 点击「生成小说大纲」按钮

### 第三步：生成章节内容

1. 大纲生成完成后，可以查看详细的故事结构
2. 点击「提取章节信息」获取各章节概要
3. 选择需要生成的章节，填写章节标题和概要
4. 点击「生成章节内容」获取具体的章节文本

## 🏗️ 项目结构

```
ai-generation-novel/
├── app.py                 # 主应用程序
├── requirements.txt       # 依赖包列表
├── .env                   # 环境变量配置
├── generate_favicon.py    # 图标生成工具
├── static/               # 静态资源
│   ├── css/
│   │   └── style.css     # 样式文件
│   ├── js/
│   │   └── main.js       # JavaScript脚本
│   └── favicon-generator.html
├── templates/            # HTML模板
│   ├── index.html       # 主页模板
│   ├── 404.html         # 404错误页面
│   └── 500.html         # 500错误页面
└── docs/                # 文档目录
    ├── API_TROUBLESHOOTING.md
    ├── CHAPTER_GENERATION_IMPROVEMENTS.md
    ├── ELEVATOR_NAVIGATION.md
    ├── FAVICON_IMPLEMENTATION.md
    ├── LARGE_SCALE_GENERATION_OPTIMIZATION.md
    ├── LLM_CONFIG_FEATURE.md
    └── OUTLINE_EDITING_IMPROVEMENTS.md
```

## 🔧 API接口

### 生成小说大纲
```http
POST /api/generate_outline
Content-Type: application/json

{
    "name": "小说名称",
    "genre": "小说类型",
    "theme": "小说主题",
    "chapters": 5
}
```

### 生成章节内容
```http
POST /api/generate_chapter
Content-Type: application/json

{
    "title": "章节标题",
    "summary": "章节概要"
}
```

### 配置管理
```http
# 获取配置
GET /api/llm_config

# 更新配置
POST /api/llm_config
Content-Type: application/json

{
    "api_key": "your_api_key",
    "api_url": "https://api.example.com/v1/chat/completions",
    "model_name": "model_name",
    "temperature": 0.7,
    "max_tokens": 1000
}
```

## 🎨 技术栈

- **后端框架**：Flask 2.3.3
- **模板引擎**：Jinja2 3.1.2
- **HTTP客户端**：requests 2.31.0
- **环境管理**：python-dotenv 1.0.0
- **前端技术**：HTML5, CSS3, JavaScript
- **样式框架**：自定义CSS + Font Awesome图标
- **字体**：Inter字体家族

## 🚨 故障排除

### 常见问题

1. **API连接失败**
   - 检查API密钥是否正确
   - 确认API地址格式正确
   - 检查网络连接状态
   - 查看错误日志获取详细信息

2. **生成内容质量问题**
   - 调整温度值（0.1-0.9为创意性内容推荐范围）
   - 增加最大Token数以获得更详细的内容
   - 优化提示词设置

3. **性能问题**
   - 对于大规模生成，建议分批处理
   - 适当调整超时设置
   - 考虑使用更强大的模型

更多详细的故障排除信息，请参考：
- [API故障排除指南](API_TROUBLESHOOTING.md)
- [大规模生成优化](LARGE_SCALE_GENERATION_OPTIMIZATION.md)
- [LLM配置功能](LLM_CONFIG_FEATURE.md)

## 📝 开发计划

- [ ] 支持更多AI模型接入
- [ ] 添加小说导出功能（PDF、EPUB等格式）
- [ ] 实现小说项目管理功能
- [ ] 添加多用户支持
- [ ] 集成更多创作辅助工具
- [ ] 支持小说风格模仿
- [ ] 添加创作历史记录

## 🤝 贡献指南

欢迎提交Issue和Pull Request来帮助改进这个项目！

1. Fork本项目
2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开一个Pull Request

## 📄 许可证

本项目采用MIT许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 👥 作者

- **项目维护者** - 爱生文团队

## 🙏 致谢

- 感谢所有的贡献者
- 感谢开源社区提供的优秀工具和库
- 特别感谢AI技术的发展为创作带来的新可能

---

**如果这个项目对您有帮助，请给我们一个⭐️！**