# MangaGenerator

**Repository Path**: ai-project_9/manga-generator

## Basic Information

- **Project Name**: MangaGenerator
- **Description**: 七牛云秋招产研第二批议题一：漫画生成器
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-01-15
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小说转漫画生成器

一个基于AI技术的小说转漫画生成应用，能够将文字内容自动转化为精美的漫画作品。
演示详情请看demo演示.mp4
或点击链接：[https://www.bilibili.com/video/BV1hfszzkEjb/?vd_source=6248b48a07f8ecf26e1a1e44f281336d](https://www.bilibili.com/video/BV1hfszzkEjb/?vd_source=6248b48a07f8ecf26e1a1e44f281336d)

## 团队分工

- **AI生成**: 前端开发 (React + TypeScript)
- **聂武洲**: Node.js后端 (Express.js)
- **利文婷**: PHP后端 (Volcengine + Doubao API)

## 功能特点

- **智能文本分析**：使用AI技术深度理解小说情节、人物关系和场景描述
- **自动分镜生成**：智能生成符合漫画创作规律的分镜设计
- **多风格支持**：支持日式、美式、中式、网络漫画等多种风格
- **高质量图像生成**：基于AI生成专业级漫画图像
- **语音合成**：支持将对话内容转换为语音（可选）
- **作品管理**：保存、查看、删除生成的漫画作品

## 快速开始

### 环境要求

- Node.js 16.0.0 或更高版本
- PHP 8.0 或更高版本
- npm 或 yarn 包管理器
- Composer (PHP包管理器)

### 安装步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd novel-to-manga-generator
```

2. **安装Node.js后端依赖**
```bash
npm install
```

3. **安装前端依赖**
```bash
cd client
npm install
cd ..
```

4. **安装PHP后端依赖**
```bash
cd php-backend
composer install
cd ..
```

5. **配置环境变量**
```bash
# 复制Node.js环境变量模板
cp env.example .env

# 复制PHP环境变量模板
cp php-backend/env.example php-backend/.env

# 编辑 .env 文件，填入您的API密钥
# 需要配置的API：
# - 火山引擎API (用于图像生成)
# - 豆包API (用于文本分析和组合漫画)
# - OpenAI API Key (用于文本分析，可选)
# - Stability AI API Key (用于图像生成，可选)
```

6. **启动应用**
```bash
# 启动PHP后端 (利文婷负责)
cd php-backend
php -S localhost:80 -t public

# 启动Node.js后端 (聂武洲负责)
npm start

# 启动前端 (AI生成负责)
cd client
npm start
```

7. **访问应用**
打开浏览器访问 `http://localhost:3000`

## API配置

### 必需的API服务

1. **火山引擎API** (利文婷负责)
   - 用于图像生成
   - 获取地址：https://console.volcengine.com/ark
   - 需要Access Key ID和Secret Access Key

2. **豆包API** (利文婷负责)
   - 用于文本分析和组合漫画生成
   - 获取地址：https://console.volcengine.com/ark
   - 需要API Key

### 可选的API服务

3. **OpenAI API** (聂武洲负责)
   - 用于文本分析
   - 获取地址：https://platform.openai.com/api-keys
   - 需要GPT-4访问权限

4. **Stability AI API** (聂武洲负责)
   - 用于图像生成
   - 获取地址：https://platform.stability.ai/account/keys
   - 需要Stable Diffusion访问权限

## 项目结构

```
MangaGenerator/
├── client/                 # React前端应用 (AI生成负责)
│   ├── public/            # 静态资源
│   ├── src/               # 源代码
│   │   ├── App.tsx        # 主应用组件
│   │   ├── index.tsx      # 入口文件
│   │   └── index.css      # 样式文件
│   └── package.json       # 前端依赖
├── php-backend/           # PHP后端 (利文婷负责)
│   ├── public/            # Web根目录
│   │   └── index.php      # 入口文件
│   ├── src/               # 源代码
│   │   ├── Controllers/   # 控制器
│   │   └── Services/      # 服务层
│   └── composer.json      # PHP依赖
├── routes/                # Node.js后端路由 (聂武洲负责)
│   ├── textAnalysis-doubao.js    # 文本分析API
│   ├── imageGeneration.js        # 图像生成API
│   ├── mangaGeneration.js         # 漫画生成API
│   └── tts.js                    # 语音合成API
├── uploads/               # 上传文件目录
├── outputs/               # 生成文件目录
├── server.js              # Node.js服务器入口
├── package.json           # Node.js依赖
├── env.example            # 环境变量模板
└── README.md              # 项目说明
```

## 使用方法

1. **输入小说文本**
   - 在文本框中输入您的小说内容
   - 可以点击"使用示例文本"查看示例

2. **选择漫画风格**
   - 日式漫画：传统日式风格，线条清晰
   - 美式漫画：超级英雄风格，线条粗犷
   - 中式漫画：传统中式艺术风格
   - 网络漫画：现代数字艺术风格

3. **生成漫画**
   - **生成漫画**：使用Node.js后端，支持完整的分镜生成 (聂武洲负责)
   - **生成组合漫画**：使用PHP后端，直接生成连贯的漫画 (利文婷负责)
   - 等待AI处理完成（通常需要1-3分钟）

4. **查看结果**
   - 查看生成的分镜和图像
   - 可以保存到"我的作品"中

## API接口

### 文本分析 (聂武洲负责)
```
POST /api/text-analysis/analyze
Content-Type: application/json

{
  "text": "小说文本内容",
  "options": {}
}
```

### 图像生成 (聂武洲负责)
```
POST /api/image-generation/generate
Content-Type: application/json

{
  "prompt": "图像描述",
  "style": "japanese",
  "width": 1024,
  "height": 1024
}
```

### 漫画生成 (聂武洲负责)
```
POST /api/manga-generation/generate
Content-Type: application/json

{
  "text": "小说文本",
  "style": "japanese",
  "options": {
    "title": "漫画标题"
  }
}
```

### 组合漫画生成 (利文婷负责)
```
POST /api/manga-generation/generate-combo
Content-Type: application/json

{
  "text": "小说文本",
  "style": "japanese",
  "options": {
    "title": "组合漫画标题"
  }
}
```

## 开发说明

### 团队分工
- **AI生成 (前端)**: React + TypeScript开发，负责用户界面、交互逻辑、状态管理
- **聂武洲 (Node.js后端)**: Express.js框架开发，负责文本分析、分镜生成、Stability AI集成
- **利文婷 (PHP后端)**: PHP开发，负责火山引擎集成、豆包API集成、组合漫画生成

### 后端开发
- **Node.js后端**: 使用Express.js框架，支持CORS跨域请求
- **PHP后端**: 使用原生PHP，集成Volcengine SDK
- **文件处理**: 支持文件上传和静态文件服务
- **错误处理**: 完善的错误处理和日志记录

### 前端开发
- **React + TypeScript**: 类型安全的现代前端开发
- **响应式设计**: 支持移动端和桌面端
- **状态管理**: 使用React Hooks进行状态管理
- **API调用**: 使用fetch API进行HTTP请求

### 部署建议
- **生产环境**: 建议使用PM2管理Node.js进程
- **前端构建**: 使用`npm run build`构建生产版本
- **反向代理**: 建议使用Nginx作为反向代理
- **文件存储**: 建议使用云存储服务存储生成的文件

## 性能优化

- **图像生成**: 使用异步处理，支持批量操作
- **文件缓存**: 实现文件缓存机制
- **错误重试**: 支持API调用重试机制
- **资源优化**: 前端资源压缩和懒加载

## 安全考虑

- **API密钥**: 安全存储API密钥，不在代码中硬编码
- **文件上传**: 实现文件上传安全检查
- **输入验证**: 对所有用户输入进行验证
- **错误信息**: 过滤敏感错误信息

## 常见问题

### Q: 生成速度很慢怎么办？
A: 图像生成需要调用外部API，通常需要1-3分钟。可以尝试减少文本长度或使用组合漫画生成功能。

### Q: 生成的图像质量不满意？
A: 可以尝试不同的漫画风格，或者调整输入文本的描述详细程度。

### Q: API调用失败？
A: 请检查API密钥是否正确配置，以及是否有足够的API配额。

### Q: 支持哪些文件格式？
A: 目前支持文本输入，生成的图像为PNG格式。

### Q: 如何切换后端？
A: 项目支持Node.js和PHP两种后端，可以根据需要选择使用。

## 技术支持

如有问题，请检查：
1. 环境变量配置是否正确
2. API密钥是否有效
3. 网络连接是否正常
4. 查看控制台错误日志

---

**注意**: 使用本应用需要有效的API密钥，请确保您有足够的API配额。生成的内容仅供学习和研究使用。