# comic

**Repository Path**: sub_callow/comic

## Basic Information

- **Project Name**: comic
- **Description**: Ai漫画生成器
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/sub_callow
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-12-10
- **Last Updated**: 2026-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Comic Generator (AI 漫画生成器)

一个基于 Next.js 和 AI 技术的智能漫画生成工具。通过简单的故事大纲，自动生成分镜脚本、角色设计，并绘制出精美的漫画页面。

## ✨ 核心功能

- **智能脚本生成**：基于 GLM-4 模型，将一句话大纲扩展为详细的漫画分镜脚本。
- **角色一致性**：独创的角色卡系统，确保同一角色在不同分镜中外观高度统一。
- **拟真阅读体验**：提供 3D 翻页效果的虚拟漫画书阅读模式，全出血布局，沉浸感极强。
- **漫画风格化**：自动合成漫画对话框，支持多种气泡样式，所见即所得。
- **专业导出**：支持导出为高清 PDF 电子书或图片序列，排版精美。

## ✅ 已完成的功能更新 (Phase 1)

### 1. 脚本编辑器升级
- **剧本模式**：新增纯文本批量编辑功能，支持将生成的脚本一键转换为文本格式，方便复制到外部 LLM 进行润色后再贴回。
- **智能解析**：优化了剧本解析引擎，支持非严格换行格式，防止内容错位。
- **健壮性修复**：修复了因字段缺失导致的数据解析错误。

### 2. 对话框系统重构
- **多人对话支持**：自动识别多人对白（如 `A：“...” B：“...”`），并智能拆分为独立气泡。
- **智能布局**：采用“顶部平铺”策略（左上+右上），彻底解决气泡遮挡画面人物主体的问题。
- **极简风格**：统一所有对话框样式为**白底黑边**，去除多余配色，回归经典漫画视觉。

### 3. 导出与排版优化
- **内容修正**：导出图片下方优先展示**旁白 (Narration)**，而非画面指令，提升阅读流畅度。
- **排版升级**：显著增大了导出文字的字号和行高，适应移动端阅读。
- **流程优化**：修复了预览页“返回编辑”的逻辑，支持保留状态回退修改。

## 🔜 后续待完成功能 (Roadmap)

- [ ] **更强的角色一致性**: 引入 LoRA 或 Reference Only 控制网，实现像素级的人物特征固定。
- [ ] **多风格支持**: 增加美漫、韩漫、水墨风、像素风等多种绘画风格选择。
- [ ] **分镜编辑器**: 允许用户在前端手动拖拽调整对话框位置、大小和指向。
- [ ] **局部重绘**: 支持对画面中的特定区域（如手部、脸部）进行修复重绘。
- [ ] **账号系统**: 支持用户注册登录，云端保存历史作品库。
- [ ] **社区分享**: 构建作品广场，支持一键分享和点赞他人作品。

## 📸 界面预览

### 1. 故事创作与角色设定
> 结构化的角色卡片输入，确保人物形象高度一致。

![img_3.png](img_3.png)

### 2. 沉浸式阅读体验 (虚拟翻页书)
> 拟真的 3D 翻页效果，左图右文的经典画册排版。

![img_1.png](img_1.png)

### 3. 所见即所得的对话框
> 自动合成漫画气泡，无需后期处理。

![img.png](img.png)

## 🛠️ 技术栈

- **前端框架**：Next.js 14 (App Router)
- **UI 组件**：Tailwind CSS + Lucide React
- **大语言模型**：智谱 AI (GLM-4) - 用于生成脚本和提取角色
- **图像生成**：火山引擎 (Volcengine) - 用于绘制漫画画面

## 🚀 快速开始

### 1. 克隆项目

```bash
git clone https://github.com/your-repo/ai-comic-generator.git
cd ai-comic-generator
```

### 2. 安装依赖

```bash
npm install
# 或
yarn install
```

### 3. 配置环境变量

复制 `.env.example` 文件为 `.env.local`，并填入您的 API 密钥：

```bash
cp .env.example .env.local
```

`.env.local` 文件内容示例：

```env
# 智谱 AI (用于生成脚本)
OPENAI_API_KEY=your_glm_api_key
OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4

# 火山引擎 (用于生成图片)
VOLC_ACCESS_KEY_ID=your_volc_ak
VOLC_SECRET_ACCESS_KEY=your_volc_sk
VOLC_REGION=cn-north-1
```

### 4. 运行开发服务器

```bash
npm run dev
```

打开浏览器访问 [http://localhost:3000](http://localhost:3000) 即可开始创作！

---

## 🔑 火山引擎 API 配置指南 (保姆级教程)

本项目使用火山引擎的**视觉智能 (Visual Intelligence)** 服务来生成漫画图片。请按照以下步骤获取 API 密钥：

### 第一步：注册与开通

1.  访问 [火山引擎官网](https://www.volcengine.com/) 并注册账号。
2.  完成**实名认证**（这是使用 API 的前提）。
3.  进入控制台，在左侧导航栏找到或搜索 **"视觉智能"** (Visual Intelligence)。
4.  点击 **"开通服务"**。通常会有免费试用额度。
5.  确保开通了 **"文生图"** 相关能力（通用文生图）。

### 第二步：获取访问密钥 (AK/SK)

1.  在火山引擎控制台右上角，鼠标悬停在头像上，点击 **"API访问密钥"**（或直接访问 [密钥管理页面](https://console.volcengine.com/iam/keymanage/)）。
2.  点击 **"新建密钥"**。
3.  您将获得一对密钥：
    *   **Access Key ID (AK)**：以 `AK` 开头的字符串。
    *   **Secret Access Key (SK)**：一长串加密字符。
4.  ⚠️ **注意**：请妥善保存 SK，不要泄露给他人。

### 第三步：填入项目配置

打开项目根目录下的 `.env.local` 文件，填入刚才获取的密钥：

```env
VOLC_ACCESS_KEY_ID=AKLT... (填入您的 Access Key ID)
VOLC_SECRET_ACCESS_KEY=T0R... (填入您的 Secret Access Key)
```

`VOLC_REGION` 默认为 `cn-north-1`，通常不需要修改。

---

## 📝 使用指南

1.  **输入故事**：
    *   点击"快速开始"中的示例，或者手动输入。
    *   推荐在 **"角色描述"** 框中详细定义角色的发型、发色、服装等，这能极大提升角色一致性。
2.  **生成漫画**：
    *   点击生成按钮，系统会自动解析角色、生成分镜脚本，并逐一开始绘图。
    *   您可以实时看到生成进度。
3.  **阅读与导出**：
    *   生成完成后进入预览界面。
    *   点击左右翻页按钮体验 3D 翻书效果。
    *   点击右上角的下载按钮，导出 PDF 或图片序列分享给朋友。

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

MIT License