# ai-novel-generator

**Repository Path**: example-codes/ai-novel-generator

## Basic Information

- **Project Name**: ai-novel-generator
- **Description**: AI 小说生成器 - 基于 Tauri 2.0 + Vue 3 + TypeScript 的智能小说创作工具，支持多种 AI 服务（OpenAI、Claude、DeepSeek、智谱、通义千问等），多语言界面，跨平台支持
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 25
- **Created**: 2026-01-29
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 小说生成器

![AI Novel Generator Logo](public/logo.svg)

**基于 Tauri 2.0 + Vue 3 + TypeScript 的智能小说创作工具**

[功能特性](#功能特性) • [快速开始](#快速开始) • [使用指南](#使用指南) • [技术栈](#技术栈) • [开发文档](#开发文档)

---

## 软件截图

![工作台](docs/screenshots/1.png)

![项目中心](docs/screenshots/2.png)

![世界观设定](docs/screenshots/3.png)

![创作中心](docs/screenshots/4.png)

![爆款开头](docs/screenshots/5.png)

![AI 配置](docs/screenshots/6.png)

![关于页面](docs/screenshots/7.png)

---

## 功能特性

### 🤖 多 AI 服务支持
- **国际服务**: OpenAI (GPT-4/3.5)、Claude、Gemini
- **国内服务**: DeepSeek、智谱GLM、通义千问、Kimi、豆包、讯飞星火、腾讯混元、文心一言
- **本地部署**: Ollama 本地模型支持

### ✍️ 智能创作流程
- **灵感激发**: AI 辅助生成小说创意和题材
- **大纲生成**: 自动生成章节大纲和故事结构
- **内容创作**: 智能续写、扩写、润色
- **世界观设定**: 完整的角色、场景、设定管理

### 🌍 多语言界面
- 简体中文 (zh-CN)
- 繁体中文 (zh-TW/zh-HK)
- English (en-US)
- 日本語 (ja)

### 💻 跨平台支持
- Windows 10/11
- macOS 10.13+
- Linux (AppImage/deb/rpm)

### 🎨 其他特性
- 深色/浅色主题切换
- 多种布局模式
- 项目数据本地存储
- 系统托盘支持
- 新手引导教程

---

## 快速开始

### 下载安装

#### 方式一：网盘下载（推荐国内用户）

通过网盘分享的文件：**AI 小说生成器_1.0.1_x64-setup.exe**

- 链接: https://pan.baidu.com/s/1w2e6JZuoBBm777YYmrJagQ?pwd=52pj
- 提取码: **52pj**

#### 方式二：Gitee Releases

从 [Releases](https://gitee.com/dabaiyun/ai-novel-generator/releases) 页面下载对应平台的安装包：

| 平台 | 文件格式 |
|------|----------|
| Windows | `.msi` / `.exe` |
| macOS | `.dmg` |
| Linux | `.AppImage` / `.deb` / `.rpm` |

### 首次使用

1. **配置 AI 服务**
   - 打开应用后，进入「AI 配置」页面
   - 选择你要使用的 AI 服务提供商
   - 填入对应的 API Key
   - 测试连接确保配置正确

2. **创建项目**
   - 在「仪表板」点击「新建项目」
   - 填写小说基本信息（标题、类型、简介等）

3. **开始创作**
   - 使用「创作中心」进行 AI 辅助写作
   - 在「世界观设定」管理角色和场景
   - 通过「日志」查看创作历史

---

## 使用指南

### 创作流程

```
项目中心 → 世界观设定 → 爆款开头 → 创作中心 → 导出成品
```

### 1. 项目中心

项目中心是创作的起点，所有信息会被其他模块引用：

- **创建项目**：选择小说类型（支持18种：玄幻、科幻、都市、言情等）
- **基本信息**：填写作品名称、简介、标签，AI 会根据这些信息辅助创作
- **封面生成**：AI 根据作品信息自动生成符合类型风格的封面
- **提示词配置**：自定义 AI 作者角色和创作规则，可使用 AI 优化

### 2. 世界观设定

世界观设定会自动适配小说类型：

- **角色管理**：添加角色的身份、状态、能力等信息
- **世界设定**：配置世界名称、背景、力量体系、地点、势力等
- **AI 完善**：点击「AI 完善」可智能补充细节，会参考项目基本信息
- **类型适配**：不同小说类型显示不同的字段标签（如玄幻显示"境界"，都市显示"职位"）

### 3. 爆款开头

快速生成吸引读者的小说开头：

- **关联项目**：选择项目后自动加载作品信息和角色设定
- **大神模板**：24种热门开局套路（重生复仇、系统流、赘婿逆袭等）
- **角色设定**：支持11种角色类型（男主、女主、导师、对手等）
- **保存到项目**：生成的开头可直接保存为项目第1章

### 4. 创作中心

基于大纲进行章节创作：

- **Step 1 大纲生成**：输入故事创意，AI 生成章节大纲
- **Step 2 章节创作**：基于大纲生成正文，可选择是否使用角色状态和世界设定
- **Step 3 章节管理**：查看、编辑、导出已生成的章节
- **状态更新**：支持自动/半自动/手动三种角色状态更新模式

### 5. 调试工具

右下角悬浮按钮提供开发调试功能：

- **基本信息**：应用版本、平台、内存使用等
- **控制台**：查看应用日志，支持按类型筛选
- **网络请求**：监控 API 请求，查看请求/响应详情
- **存储信息**：查看和清理本地存储

### AI 配置说明

#### DeepSeek（推荐国内用户）
1. 访问 [DeepSeek 开放平台](https://platform.deepseek.com/)
2. 注册账号并创建 API Key
3. 在应用中填入 API Key，Base URL 使用默认值

#### OpenAI
1. 访问 [OpenAI Platform](https://platform.openai.com/)
2. 创建 API Key
3. 国内用户可能需要配置代理 Base URL

#### 本地 Ollama
1. 安装 [Ollama](https://ollama.ai/)
2. 下载模型：`ollama pull llama2` 或其他模型
3. 在应用中配置 Base URL 为 `http://localhost:11434`

### 快捷键

| 功能 | Windows/Linux | macOS |
|------|---------------|-------|
| 保存 | `Ctrl + S` | `Cmd + S` |
| 生成 | `Ctrl + Enter` | `Cmd + Enter` |
| 切换主题 | `Ctrl + D` | `Cmd + D` |

---

## 技术栈

- **前端框架**: Vue 3 + TypeScript
- **UI 组件**: Ant Design Vue 4.x
- **状态管理**: Pinia
- **国际化**: Vue I18n
- **样式方案**: UnoCSS + SCSS
- **桌面框架**: Tauri 2.0
- **后端语言**: Rust

---

## 开发文档

详细开发文档请查看 [DEVELOPMENT.md](./DEVELOPMENT.md)

### 快速开发

```bash
# 克隆项目
git clone https://gitee.com/dabaiyun/ai-novel-generator.git
cd ai-novel-generator

# 安装依赖
pnpm install

# 启动开发服务
pnpm tauri dev

# 构建生产版本
pnpm tauri build
```

---

## 许可证

本项目基于 [Apache License 2.0](./LICENSE) 开源。

---

## 作者

**宝宝丷** - [Gitee](https://gitee.com/dabaiyun)

---

如果这个项目对你有帮助，欢迎 ⭐ Star 支持！