# director_ai

**Repository Path**: ailearn_1/director_ai

## Basic Information

- **Project Name**: director_ai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎬 AI漫导 (DirectorAI)

> AI 漫剧制作 APP，能一键生成剧本、分镜及合成视频，让你在手机上也能快速制作漫剧

<p align="center">
  <img src="https://img.shields.io/badge/Flutter-3.0+-02569B?logo=flutter" alt="Flutter">
  <img src="https://img.shields.io/badge/Dart-3.0+-0175C2?logo=dart" alt="Dart">
  <img src="https://img.shields.io/badge/Platform-Android-3DDC84?logo=android" alt="Android">
  <img src="https://img.shields.io/badge/AI-GLM--4.7-FF6B9D" alt="GLM-4.7">
</p>

## ✨ 项目简介

AI漫导是一款基于 Flutter 开发的移动应用，采用 **AI 智能体架构**，能够理解用户的文字描述，并自动编排多个 AI 模型协作，最终生成完整的AI 漫剧视频内容。

只需简单描述你的创意，AI漫导就能帮你实现！

```
用户: "制作一个雪地里的冒险故事"
     ↓
🤖 AI 理解需求 → 🔥 生成剧本 → 🖼️ 生成分镜图片和视频 → 🎬 转换合成视频
     ↓
✅ 完成！
```

![](/images/d82ef8a6d34fa0bcd71636ae2e931e28.jpg)


我总结了一下大概的流程是这样子的：

![](images/AI漫剧APP-4.gif)


其中，我比较关心的是人物一致性解决方案：

![](images/20260105115408.png)

在对应场景的配置默认是给了 7 个，角色是给了 2 个，然后这些我都设置成可配置的了。

![](images/AI漫剧APP-5.png)

能够生成角色三视图：

![](images/AI漫剧APP-15.png)

剧本场景：

![](https://cdn.canghecode.com/blog/AI%20%E6%BC%AB%E5%89%A7APP-17.png)

场景规划：

![](images/AI漫剧APP-18.png)

场景执行：

![](images/AI漫剧APP-19.png)

场景分镜规划：

![](images/AI漫剧APP-19.png)


## 🛠️ 技术架构

### 核心技术栈

| 技术 | 用途 |
|------|------|
| **Flutter 3.0+** | 跨平台 UI 框架 |
| **Dart 3.0+** | 编程语言 |
| **Provider** | 状态管理 |
| **Dio** | HTTP 网络请求 |
| **flutter_markdown** | Markdown 渲染 |

### AI 模型集成

| 模型 | 提供商 | 功能 |
|------|--------|------|
| **GLM-4.7** | 智谱 AI | 智能编排与决策 |
| **Gemini-3-Pro-Image-Preview** | Google | 文本生成图片 |
| **Veo3.1** | Google | 图片生成视频 |

### 智能体架构

项目采用 **ReAct (Reasoning + Acting)** 循环架构：

```
┌─────────────────────────────────────────────────────┐
│                    ReAct 循环                        │
├─────────────────────────────────────────────────────┤
│  1. 用户输入 → GLM-4.7 理解意图                      │
│  2. GLM 返回下一步操作 (JSON 命令)                   │
│  3. 执行工具调用 (图片生成 / 视频生成)               │
│  4. 将结果反馈给 GLM                                 │
│  5. 重复直到任务完成                                 │
└─────────────────────────────────────────────────────┘
```

## 📁 项目结构

```
lib/
├── main.dart                 # 应用入口，主题配置
├── controllers/
│   └── agent_controller.dart # ReAct 智能体控制器
├── models/
│   ├── agent_command.dart    # 智能体命令/响应模型
│   └── chat_message.dart     # 聊天消息模型
├── providers/
│   └── chat_provider.dart    # 聊天状态管理
├── screens/
│   └── chat_screen.dart      # 主聊天界面
└── services/
    └── api_service.dart      # API 服务层
```

## 🚀 快速开始

### 环境要求

- Flutter SDK >= 3.0.0
- Dart SDK >= 3.0.0
- Android Studio / VS Code
- Android 设备或模拟器

### 安装步骤

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd director_ai
   ```

2. **安装依赖**
   ```bash
   flutter pub get
   ```

3. **配置 API Token**
   
   在 `lib/services/api_service.dart` 中配置你的智谱 AI API Token：
   ```dart
   static String bearerToken = 'YOUR_API_TOKEN';
   ```
   
   或在应用设置中动态配置。

4. **运行应用**
   ```bash
   flutter run
   ```

## 📦 依赖说明

```yaml
dependencies:
  flutter: sdk
  cupertino_icons: ^1.0.6    # iOS 风格图标
  dio: ^5.4.0                # HTTP 客户端
  provider: ^6.1.1           # 状态管理
  path_provider: ^2.1.5      # 文件路径访问
  flutter_markdown: ^0.6.18+3 # Markdown 渲染
  http_parser: ^4.0.2        # HTTP 解析工具
```

## 🎨 UI 特点

- 🌸 **二次元粉色主题** - 可爱清新的视觉风格
- 💬 **聊天界面** - 自然的对话交互体验
- 🎭 **Material Design 3** - 现代化设计语言
- 📱 **响应式布局** - 适配不同屏幕尺寸

## 🔧 可用工具

智能体可调用以下工具：

| 工具名称 | 参数 | 功能描述 |
|----------|------|----------|
| `generate_image` | `prompt` | 根据文字描述生成图片 |
| `generate_video` | `image_url`, `prompt`, `seconds` | 将图片转换为视频 |
| `complete` | `message` | 完成任务并回复用户 |

## 📝 使用示例

**示例 1: 创建简单视频**
```
你: 做一个日落的视频
AI: 正在生成日落图片...
AI: 图片生成成功！
AI: 正在将图片转换为视频...
AI: 你的视频已准备好了！
```

**示例 2: 详细描述**
```
你: 制作一个樱花树下，女孩在读书的唯美视频，10秒
AI: 正在生成唯美场景图片...
AI: 正在创建10秒视频...
AI: 完成！希望你喜欢这个视频！
```

## ⚙️ 配置选项

### API 配置

在 `ApiConfig` 类中可配置：

```dart
class ApiConfig {
  static const String baseUrl = 'https://open.bigmodel.cn/api/paas/v4';
  static String bearerToken = 'YOUR_TOKEN';
}
```

### 智能体配置

在 `AgentController` 中可调整：

```dart
// 最大迭代次数，防止无限循环
static const int _maxIterations = 10;
```

## 🔒 安全提示

⚠️ **重要**：不要将 API Token 提交到版本控制系统！

建议：
- 使用环境变量存储敏感信息
- 在生产环境中使用后端代理 API 调用
- 考虑使用 Flutter secure storage 存储 token

## 🤝 贡献指南

欢迎提交 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

## star 趋势图

[![Star History Chart](https://api.star-history.com/svg?repos=freestylefly/director_ai&type=Date)](https://star-history.com/#freestylefly/director_ai&Date)

## 公众号

微信搜 **苍何** 或扫描下方二维码关注苍何的原创公众号，回复 **AI** 即可和 18000+ 好友一同探讨AI，一同学习 AI Coding。

![苍何微信公众号](images/扫码_搜索联合传播样式-标准色版.bmp)


## 📄 许可证

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

---

<p align="center">
  Made with ❤️ and Flutter
</p>