local-mini-drama

name	local-mini-drama
version	1.1.0
description	LocalMiniDrama 本地短剧助手 — 通过自然语言控制短剧项目全流程：创建剧本、生成角色/场景/道具、生成分镜、批量出图、出视频、合成完整剧集、支持小说导入和工程导入导出
trigger	生成短剧|创建短剧|制作短剧|短剧创作|生成分镜|生成视频|生成图片|生成角色|生成场景|生成道具|导出工程|导入工程|导入小说|合成视频|短剧项目|短剧助手|帮我写剧本|写一个短剧|我要拍短剧|生成本集|继续制作|查看项目|查看剧本|查看分镜|角色库|场景库|道具库|AI配置|配置密钥|配置API
config	{"base_url":{"type":"string","description":"LocalMiniDrama 后端地址，如 http://localhost:5679 或 http://你的服务器IP:5679","default":"http://localhost:5679"},"default_aspect_ratio":{"type":"string","description":"默认画面比例","default":"16:9"},"default_video_duration":{"type":"number","description":"默认单个视频片段时长（秒）","default":5}}
tools	["http","memory"]
requiredContext	["drama_id","episode_id"]
author	xuanyustudio
homepage	https://github.com/xuanyustudio/LocalMiniDrama

LocalMiniDrama 本地短剧助手

通过自然语言控制 LocalMiniDrama 后端，完成从零到短剧成片的全流程 AI 生成。

核心概念

• Drama（剧集）：一个短剧项目，包含多集（Episode）
• Episode（集数）：单集内容，包含剧本（story）和分镜（Storyboard）
• Storyboard（分镜）：单个镜头，含台词、动作、画面描述、图片、视频
• Character（角色）：剧集中的角色，支持全局角色库复用
• Scene（场景）：剧集中的场景，支持全局场景库
• Prop（道具）：剧集中的道具，支持全局道具库

触发条件

用户想要创建、管理、生成短剧相关内容时使用此技能。

---

⚡ 快速开始

1. 获取后端地址

const baseUrl = config.base_url || "http://localhost:5679";

2. 列出已有项目（判断是否需要新建）

GET {baseUrl}/api/v1/dramas?page=1&page_size=20

3. 创建新剧集项目

POST {baseUrl}/api/v1/dramas
Content-Type: application/json

{
  "title": "少年修仙传",
  "style": "古风仙侠",
  "type": "short_drama",
  "metadata": {
    "aspect_ratio": "16:9",
    "video_duration": 5
  }
}

metadata.aspect_ratio 支持 16:9（横屏）、9:16（竖屏）、1:1（方形）

4. 生成剧本（支持流式）

流式（推荐）：实时接收 AI 生成的剧本内容

POST {baseUrl}/api/v1/generation/story/stream
Content-Type: application/json

{
  "premise": "一个少年意外获得上古修仙传承...",
  "style": "古风仙侠",
  "episode_count": 3,
  "genre": "仙侠"
}

非流式：等待完整结果后一次性返回

POST {baseUrl}/api/v1/generation/story
Content-Type: application/json

{
  "premise": "...",
  "style": "古风仙侠",
  "episode_count": 3
}

流式响应格式（SSE）：

• { "type": "start" } — 开始
• { "type": "progress", "text": "已生成的文字..." } — 增量文本
• { "type": "done", "result": { "episodes": [...] } } — 完成，附结构化集数
• { "type": "error", "message": "..." } — 错误

将生成的剧本保存到项目集数：

字段名：script_content（不是 content），title（集标题），episode_number

PUT {baseUrl}/api/v1/dramas/{drama_id}/episodes
Content-Type: application/json

{
  "episodes": [
    {
      "episode_number": 1,
      "title": "山涧奇遇，石中传承",
      "script_content": "第一集剧本完整正文..."
    }
  ]
}