aigc-director

Files (130)

• .gitignore
• CLAUDE.md
• README.md
• SKILL.md
• .gitignore · aigc-claw/backend/
• __init__.py · aigc-claw/backend/
• api_server.py · aigc-claw/backend/
• config.py · aigc-claw/backend/
• config_model.json · aigc-claw/backend/
• config_model.py · aigc-claw/backend/
• __init__.py · aigc-claw/backend/core/
• __init__.py · aigc-claw/backend/core/agents/
• base_agent.py · aigc-claw/backend/core/agents/
• character_agent.py · aigc-claw/backend/core/agents/
• editor_agent.py · aigc-claw/backend/core/agents/
• reference_agent.py · aigc-claw/backend/core/agents/
• script_agent.py · aigc-claw/backend/core/agents/
• storyboard_agent.py · aigc-claw/backend/core/agents/
• video_agent.py · aigc-claw/backend/core/agents/
• orchestrator.py · aigc-claw/backend/core/
• api.md · aigc-claw/backend/docs/
• session_format.md · aigc-claw/backend/docs/
• character_styles.txt · aigc-claw/backend/prompts/character/
• character_zh.txt · aigc-claw/backend/prompts/character/
• eval_character_zh.txt · aigc-claw/backend/prompts/character/
• eval_select_best_zh.txt · aigc-claw/backend/prompts/character/
• loader.py · aigc-claw/backend/prompts/
• check_en.txt · aigc-claw/backend/prompts/logline/
• check_zh.txt · aigc-claw/backend/prompts/logline/
• extract_zh.txt · aigc-claw/backend/prompts/logline/
• generate_en.txt · aigc-claw/backend/prompts/logline/
• generate_zh.txt · aigc-claw/backend/prompts/logline/
• eval_first_frame_zh.txt · aigc-claw/backend/prompts/reference/
• eval_select_best_zh.txt · aigc-claw/backend/prompts/reference/
• first_frame_en.txt · aigc-claw/backend/prompts/reference/
• first_frame_zh.txt · aigc-claw/backend/prompts/reference/
• beat_sheet_en.txt · aigc-claw/backend/prompts/script/
• beat_sheet_zh.txt · aigc-claw/backend/prompts/script/
• micro_beat_sheet_en.txt · aigc-claw/backend/prompts/script/
• micro_beat_sheet_zh.txt · aigc-claw/backend/prompts/script/
• micro_step_outline_zh.txt · aigc-claw/backend/prompts/script/
• step_outline_en.txt · aigc-claw/backend/prompts/script/
• step_outline_zh.txt · aigc-claw/backend/prompts/script/
• validate_characters_zh.txt · aigc-claw/backend/prompts/script/
• validate_settings_zh.txt · aigc-claw/backend/prompts/script/
• eval_select_best_zh.txt · aigc-claw/backend/prompts/setting/
• eval_setting_zh.txt · aigc-claw/backend/prompts/setting/
• setting_styles.txt · aigc-claw/backend/prompts/setting/
• setting_zh.txt · aigc-claw/backend/prompts/setting/
• continue_zh.txt · aigc-claw/backend/prompts/storyboard/
• shot_zh.txt · aigc-claw/backend/prompts/storyboard/
• enhance.txt · aigc-claw/backend/prompts/video/
• requirements.txt · aigc-claw/backend/
• session.py · aigc-claw/backend/
• image_client.py · aigc-claw/backend/tool/
• image_dashscope.py · aigc-claw/backend/tool/
• image_gpt.py · aigc-claw/backend/tool/
• image_jimeng.py · aigc-claw/backend/tool/
• image_processor.py · aigc-claw/backend/tool/
• image_seedream.py · aigc-claw/backend/tool/
• …and 70 more

SKILL.md (first lines)

# AIGC-Director Agent Skill

> **本地运行**：这是一个**本地部署**的视频生成项目，**前后端都运行在本机**：
> - 后端：`http://localhost:8000`
> - 前端：`http://localhost:3000`
> - 所有 API 调用都请求本地服务器，不要请求其他地址！
> - 确保在调用任何 API 之前，后端和前端服务都已经启动并运行正常！

> **核心理念**：Agent 应该像"持续陪伴的智能视频制作助理"，每完成一个用户可感知的重要任务，都应立即给用户一条简报，并等待用户确认。

> **核心原则**：每个阶段的产物都必须展示给用户，必须停下来等待用户确认后才能继续下一阶段。

> **防止遗忘**：在整个流程中，Agent 可能会忘记之前的用户输入或之前阶段的产物内容。**每当进入一个新的阶段时，Agent 都必须重新加载这篇SKILL文档，确保不会忘记任何细节**。

---

## 项目结构

```
aigc-director/                    ← OpenClaw 调用的 skill 根目录
├── aigc-claw/                    ← 前后端项目代码
│   ├── backend/                  ← FastAPI 后端（端口 8000）
│   │   └── code/result/          ← 模型生成产物存放目录
│   │            ├── script/      ← 剧本产物
│   │            ├── image/       ← 图片产物（角色、场景、参考图）
│   │            └── video/       ← 视频产物
│   └── frontend/                 ← Next.js 前端（端口 3000）
├── references/                   ← OpenClaw 调用时的参考文档
│   ├── init_project/             ← 项目初始化
│   ├── run_project/              ← 服务启动
│   ├── workflow/                 ← 六阶段工作流 API
│   ├── sandbox/                  ← 临时工作台 API
│   └── send_message/             ← 消息发送
└── SKILL.md                      ← skill 正文
```

> **产物存放目录**：`aigc-claw/backend/code/result/`
> - `script/` - 剧本产物
> - `image/` - 图片产物（角色、场景、参考图）
> - `video/` - 视频产物

---

## 阶段与停点（共9个）

| 停点 | 阶段 | phase 值 | 描述 | 操作 |
|------|------|----------|------|------|
| 1 | 项目配置 | - | 确认配置选项 | 展示配置 → 用户确认 |
| 2 | 剧本生成 | suggest_expand | 建议扩写 | 等待用户确认 |
| 3 | 剧本生成 | logline_selection | 选择情节 | 从3个候选中选择 |
| 4 | 剧本生成 | mode_selection | 选择模式 | 电影(4幕) / 微电影(1幕) |
| 5 | 剧本生成 | script_generation | 确认剧本 | 确认后继续 |
| 6 | 角色/场景设计 | - | 确认角色/场景图片 | 确认后继续 |
| 7 | 分镜设计 | - | 确认分镜列表 | 确认后继续 |
| 8 | 参考图生成 | - | 确认参考图 | 确认后继续 |
| 9 | 视频生成 | - | 确认视频片段 | 确认后继续 |

> **注意**：`suggest_expand` 和 `logline_selection` 可能根据输入质量被跳过。

---

## 工作流程

### 1. 本地部署(仅初始化时执行)

当用户要求"初始化项目"、"配置项目"、"部署项目"时，需要先进行项目初始化：参考 [init_all.md](references/init_project/init_all.md) 执行完整初始化流程。

> **注意**：仅在用户首次下载项目或需要重新配置环境时使用。项目已初始化过则跳过此步骤，直接检查服务运行状态。

### 2. 检查本地服务

参考 [start_backend.md](references/run_project/start_backend.md) 和 [start_frontend.md](references/run_project/start_frontend.md) 检查服务是否运行。

> **⚠️ 强制要求**：如果服务未运行，必须先启动服务再继续！

### 2. 路由判断

| 用户说 | 处理 |
|--------|------|
| "生成图片" | 临时工作台 (sandbox) |
| "生成视频" | 必须先询问：长视频(工作流) 还是 短视频(工作台)？ |
| "分析图片" | 临时工作台 (sandbox) |
| "问 LLM 问题" | 临时工作台 (sandbox) |
| "照片转动漫" | 临时工作台 (sandbox) |

### 3. 执行流程

```
1. 检查后端运行状态 → 未运行则参考 start_backend.md 启动 → 等待3秒 → 再次检查
2. 检查前端运行状态 → 未运行则参考 start_frontend.md 启动 → 等待5秒 → 再次检查
3. 检查 API Key 配置 → 读取 .env 文件，确认所需 API Key 已配置
4. 参考 create_project.md 询问用户项目配置 → 停点1（配置确认）→ 创建项目
5. 参考 create_script.md 执行剧本生成 → 停点2-5
6. 参考 create_character.md 执行角色设计 → 停点6
7. 参考 create_storyboard.md 执行分镜设计 → 停点7
8. 参考 create_reference.md 执行参考图生成 → 停点8
9. 参考 create_video.md 执行视频生成 → 停点9
10. 参考 create_post.md 执行后期剪辑
11. 完成 → 发送最终视频给用户
```

> **注意**：一定要参考 `references/` 目录下的具体文档执行每一步操作，不要凭记忆或想当然去调用 API！

#### 检查 API Key 配置

在创建项目前，必须检查用户选择的模型对应的 API Key 是否已配置：

```bash
# 读取 .env 文件检查配置
cat aigc-claw/backend/.env | grep -E "API_KEY|KEY"

# 必需的配置（根据选择的模型）
# LLM: DASHSCOPE_API_KEY / DEEPSEEK_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY
# 图片: ARK_API_KEY / DASHSCOPE_API_KEY
# 视频: DASHSCOPE_API_KEY / VOLC_ACCESS_KEY / KLING_ACCESS_KEY
```

如果 API Key 未配置，需要提醒用户：
1. 告知缺少哪个平台的 API Key

From aAAaqwq/AGI-Super-Team, MIT.

More from aAAaqwq/AGI-Super-Team