| 1 | # 生成剧本 |
| 2 | |
| 3 | 执行第一阶段：剧本生成。 |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ## 请求 |
| 8 | |
| 9 | ```bash |
| 10 | curl -X POST "http://localhost:8000/api/project/{session_id}/execute/script_generation" \ |
| 11 | -H "Content-Type: application/json" \ |
| 12 | -d '{"session_id": "xxx", "style": "anime", "episodes": 4}' |
| 13 | ``` |
| 14 | |
| 15 | --- |
| 16 | |
| 17 | ## 停点流程 |
| 18 | |
| 19 | 现版本剧本生成阶段已精简，只有 1 个停点： |
| 20 | |
| 21 | | 停点 | phase 值 | 操作 | |
| 22 | |------|----------|------| |
| 23 | | 2 | script_generation | 等待剧本生成完成，用户确认全集剧本 | |
| 24 | |
| 25 | ## 处理停点 |
| 26 | |
| 27 | ### 停点2：剧本生成完成，等待用户确认后继续下一阶段 |
| 28 | |
| 29 | 获取 artifact 查看生成的剧本内容： |
| 30 | |
| 31 | ```bash |
| 32 | # 获取 artifact |
| 33 | curl "http://localhost:8000/api/project/{session_id}/artifact/script_generation" |
| 34 | ``` |
| 35 | |
| 36 | **必须向用户发送消息**，展示完整的剧本内容： |
| 37 | |
| 38 | - **标题**：`artifact.title` |
| 39 | - **故事梗概**：`artifact.logline` |
| 40 | - **人物列表**：`artifact.characters`（包含人物名称、描述、角色类型） |
| 41 | - **背景列表**：`artifact.settings`（包含背景名称、描述） |
| 42 | - **剧集列表**：`artifact.episodes`（包含各集的标题和内容） |
| 43 | |
| 44 | - **发送前端 URL**（获取本地 IPv4 地址，构造 `http://{local_ip}:3000/?session={session_id}&stage=script_generation`） |
| 45 | |
| 46 | 向用户展示剧本概览并询问确认后调用： |
| 47 | |
| 48 | ```bash |
| 49 | # 确认剧本，继续下一阶段 |
| 50 | curl -X POST "http://localhost:8000/api/project/{session_id}/continue" |
| 51 | ``` |
| 52 | |
| 53 | --- |
| 54 | |
| 55 | ## SSE 事件监听 |
| 56 | |
| 57 | - `progress`: 实时进度，可能包含进度百分比等信息 |
| 58 | - `stage_complete`: 阶段完成 |
| 59 | - `error`: 执行出错 |
| 60 | |
| 61 | --- |
| 62 | |
| 63 | ## 响应示例 |
| 64 | |
| 65 | ```json |
| 66 | { |
| 67 | "title": "剧本名称", |
| 68 | "logline": "详细故事梗概", |
| 69 | "characters": [ |
| 70 | { |
| 71 | "name": "角色名", |
| 72 | "character_id": "char_xxx", |
| 73 | "description": "角色描述", |
| 74 | "role": "主角" |
| 75 | } |
| 76 | ], |
| 77 | "settings": [ |
| 78 | { |
| 79 | "name": "场景名", |
| 80 | "setting_id": "set_xxx", |
| 81 | "description": "场景描述" |
| 82 | } |
| 83 | ], |
| 84 | "episodes": [ |
| 85 | { |
| 86 | "episode_number": 1, |
| 87 | "act_title": "第一集标题", |
| 88 | "content": "第一集的剧本正文内容" |
| 89 | } |
| 90 | ], |
| 91 | "phase": "script_generation" |
| 92 | } |
| 93 | ``` |
| 94 | |
| 95 | --- |
| 96 | |
| 97 | ## 常见问题 |
| 98 | |
| 99 | | 错误 | 原因 | 解决方法 | |
| 100 | |------|------|----------| |
| 101 | | `curl: (7) Failed to connect` | 后端未运行 | 启动后端服务 | |
| 102 | | `404 Not Found` | session_id 错误或 API 路径错误 | 确认 session_id 正确 | |
| 103 | | SSE 无响应 | 后端任务卡住 | 检查后端运行日志 | |
| 104 | | 用户不选择 | 用户仍在阅读剧本 | 耐心等待用户确认，不要自行决定点击下一步 | |
| 105 |