快乐马工作室 / HappyHorse Studio · Cursor Skill Card
一线插件。阿里云百炼万相/千问图片 + HappyHorse 1.0 + 万相 2.6/2.7 + s2v + animate +
videoretalk + cosyvoice + qwen-vl 全链路。OSS 签名 URL 喂 DashScope。
1 · 何时触发我
代理在用户出现以下意图时优先调用 happyhorse-video 的工具：
- "生成一段视频 / 文生视频 / 图生视频 / 多角色互动视频 / 参考生视频"
- "生成图片 / 文生图 / 图像编辑 / 商品图 / 扩图 / 风格重绘 / 涂鸦成图"
- "视频编辑 / 风格替换 / 局部换装 / 视频里的物体改成..."
- "首尾帧视频 / 视频续写 / 视频接龙"
- "拍一段长视频 / 30 秒 / 1 分钟短片，自动分镜并拼接"
- "数字人 / 照片说话 / 视频换嘴 / 换人 / 图生动作"
- "估算一下视频生成要多少钱"
不应触发 happyhorse-video：
- 火山 Seedance 任务 → 调
seedance-video
- 单独图片任务可以优先用本插件内置
hh_image_*；若用户明确要求通义生图独立应用，再调 tongyi-image
- 仅做 TTS、不出视频 → 直接调
cosyvoice 工具或主端 TTS
2 · 工具清单
| 工具名 |
用途 |
关键参数 |
hh_image_create |
文生图片 |
prompt, model_id?, size?, n? |
hh_image_edit |
图像编辑/多图融合 |
prompt, images[] 或 from_asset_ids, model_id? |
hh_image_style_repaint |
风格重绘 |
images[] 或 from_asset_ids, style_index? |
hh_image_background |
背景生成 |
images[] 或 from_asset_ids, prompt/ref_prompt? |
hh_image_outpaint |
画面扩展 |
images[] 或 from_asset_ids, output_ratio? |
hh_image_sketch |
涂鸦作画 |
prompt, images[] 或 from_asset_ids, sketch_style? |
hh_image_ecommerce |
电商场景图 |
product_name, prompt, ecommerce_scenes[] |
hh_t2v |
文生视频 |
prompt, model?, duration?, resolution?, aspect_ratio? |
hh_i2v |
图生视频（首帧 / 首尾帧 / 续写） |
prompt, first_frame_url 或 from_asset_ids, last_frame_url?, task_type? |
hh_r2v |
参考生视频（多角色互动） |
prompt, reference_urls 或 from_asset_ids, shot_type? |
hh_video_edit |
视频编辑 |
prompt, source_video_url（兼容 video_url）, reference_urls? |
hh_photo_speak |
照片说话 |
image_url, text 或 audio_url, voice_id? |
hh_video_relip |
视频换嘴 |
source_video_url（兼容 video_url）, text 或 audio_url, voice_id? |
hh_video_reface |
视频换人 |
image_url, source_video_url（兼容 video_url）, mode_pro? |
hh_pose_drive |
图生动作 |
image_url, source_video_url（兼容 video_url）, mode_pro? |
hh_avatar_compose |
数字人合成 |
image_url + image_urls[]（兼容 ref_images_url[]）, prompt, text/audio_url |
hh_long_video_create |
长视频分镜拼接 |
story, total_duration, mode (serial/parallel) |
hh_cost_preview |
估算费用，不实际提交 |
各 mode 必需的素材或 text_chars/audio_duration_sec |
hh_status |
查询任务状态 |
task_id |
hh_list |
列最近任务 |
limit? |
工具返回 JSON 包含：ok, task_id, status, mode, model_id,
video_url, video_path, last_frame_url, last_frame_path,
image_urls, local_paths, asset_ids。失败时 ok=false + error_kind +
error_message + terminal=true。
3 · 工作台联动协议
每个 hh_* 创建工具的输入 schema 都接受 from_asset_ids: string[]，
runtime 把上游图片工作台（如 tongyi-image）产出的 asset_ids 透传过来：
| mode |
from_asset_ids 角色映射 |
i2v |
[0] → first_frame，[1+] → reference_image |
i2v_end |
[0] → first_frame，[1+] → last_frame |
r2v |
全数组 → reference_urls（按角色顺序） |
video_edit / video_extend / video_relip |
[0] → source_video_url，[1+] → reference_urls |
video_reface |
[0] → source_video_url，[1] → image_url |
pose_drive |
[0] → image_url，[1] → source_video_url |
avatar_compose |
[0] → image_url，[1+] → image_urls |
image_* |
全数组 → images，[0] → image_url |
工具返回的 asset_ids 是本插件登记到 Asset Bus 的图片/视频资产，下游可继续消费。
4 · 模型派发表（client 由 registry 驱动，无硬编码 if-else）
| 模型族 |
协议 |
关键参数 |
happyhorse-1.0-* |
新版 video-synthesis |
resolution: "720P" / "1080P"（P 大写）。禁用 with_audio / size / quality / fps / audio |
wan2.7-i2v |
新版 video-synthesis + 多模态 |
resolution, task_type (first-frame/first-and-last-frame/video-continuation) |
wan2.6-* |
旧版 video-synthesis |
size: "1280*720"（星号 W*H）, audio: true |
wan2.2-s2v / s2v-detect |
s2v 旧版 |
OSS 签名 URL 必填 |
wan2.2-animate-* |
animate 旧版 |
mode: "wan-std"|"wan-pro" |
videoretalk |
videoretalk 旧版 |
视频 + 音频 URL |
5 · 烟测脚本（≈¥0.50, < 5 分钟）
1. Settings 填 DashScope API Key + OSS 四件套
2. Create Tab → t2v → prompt: "海上日出，慢镜头，电影感"
3. duration=5, resolution=720P → 估算费用 ≈ ¥4.5（HappyHorse 1.0）
4. 「直接提交」→ Tasks Tab 看进度 → 60-180 秒后 done
5. 抽屉看视频，下载 mp4
6 · 已知陷阱
- DashScope 异步任务并发 = 1 / Key：本插件
Semaphore(1) 串行化。
- HappyHorse 1080P = 1.6 元/秒：5 秒 = ¥8，请先估价。
- OSS bucket 跨地域不可达：endpoint 区域必须和 API Key 区域一致。
- task_id 24 h 过期：超期
hh_status 返 not_found；本地 sqlite 仍存 metadata。
7 · 相关插件
1---2name: happyhorse-video3description: Bailian-powered unified creative studio — built-in Wan/Qwen image generation + HappyHorse 1.0 (text-to-video / image-to-video / reference-to-video / video-edit) + Wan 2.6/2.7 + 5 digital-human modes (photo speak / video relip / video reface / pose drive / avatar compose) + CosyVoice & Edge-TTS + storyboard long-video pipeline. Use when the user asks for AI image or video generation on Aliyun Bailian, keyframes, ecommerce images, multi-character video with audio sync, video editing/style transfer, talking-head, lip-sync, video reface, or storyboard-driven long video.4---5
6# 快乐马工作室 / HappyHorse Studio · Cursor Skill Card
7
8> 一线插件。阿里云百炼万相/千问图片 + HappyHorse 1.0 + 万相 2.6/2.7 + s2v + animate +
9> videoretalk + cosyvoice + qwen-vl 全链路。OSS 签名 URL 喂 DashScope。
10
11## 1 · 何时触发我
12
13代理在用户出现以下意图时**优先**调用 happyhorse-video 的工具：
14
15- "生成一段视频 / 文生视频 / 图生视频 / 多角色互动视频 / 参考生视频"
16- "生成图片 / 文生图 / 图像编辑 / 商品图 / 扩图 / 风格重绘 / 涂鸦成图"
17- "视频编辑 / 风格替换 / 局部换装 / 视频里的物体改成..."
18- "首尾帧视频 / 视频续写 / 视频接龙"
19- "拍一段长视频 / 30 秒 / 1 分钟短片，自动分镜并拼接"
20- "数字人 / 照片说话 / 视频换嘴 / 换人 / 图生动作"
21- "估算一下视频生成要多少钱"
22
23**不**应触发 happyhorse-video：
24
25- 火山 Seedance 任务 → 调 `seedance-video`
26- 单独图片任务可以优先用本插件内置 `hh_image_*`；若用户明确要求通义生图独立应用，再调 `tongyi-image`
27- 仅做 TTS、不出视频 → 直接调 `cosyvoice` 工具或主端 TTS
28
29## 2 · 工具清单
30
31| 工具名 | 用途 | 关键参数 |
32|---|---|---|
33| `hh_image_create` | 文生图片 | `prompt`, `model_id?`, `size?`, `n?` |
34| `hh_image_edit` | 图像编辑/多图融合 | `prompt`, `images[]` 或 `from_asset_ids`, `model_id?` |
35| `hh_image_style_repaint` | 风格重绘 | `images[]` 或 `from_asset_ids`, `style_index?` |
36| `hh_image_background` | 背景生成 | `images[]` 或 `from_asset_ids`, `prompt/ref_prompt?` |
37| `hh_image_outpaint` | 画面扩展 | `images[]` 或 `from_asset_ids`, `output_ratio?` |
38| `hh_image_sketch` | 涂鸦作画 | `prompt`, `images[]` 或 `from_asset_ids`, `sketch_style?` |
39| `hh_image_ecommerce` | 电商场景图 | `product_name`, `prompt`, `ecommerce_scenes[]` |
40| `hh_t2v` | 文生视频 | `prompt`, `model?`, `duration?`, `resolution?`, `aspect_ratio?` |
41| `hh_i2v` | 图生视频（首帧 / 首尾帧 / 续写） | `prompt`, `first_frame_url` 或 `from_asset_ids`, `last_frame_url?`, `task_type?` |
42| `hh_r2v` | 参考生视频（多角色互动） | `prompt`, `reference_urls` 或 `from_asset_ids`, `shot_type?` |
43| `hh_video_edit` | 视频编辑 | `prompt`, `source_video_url`（兼容 `video_url`）, `reference_urls?` |
44| `hh_photo_speak` | 照片说话 | `image_url`, `text` 或 `audio_url`, `voice_id?` |
45| `hh_video_relip` | 视频换嘴 | `source_video_url`（兼容 `video_url`）, `text` 或 `audio_url`, `voice_id?` |
46| `hh_video_reface` | 视频换人 | `image_url`, `source_video_url`（兼容 `video_url`）, `mode_pro?` |
47| `hh_pose_drive` | 图生动作 | `image_url`, `source_video_url`（兼容 `video_url`）, `mode_pro?` |
48| `hh_avatar_compose` | 数字人合成 | `image_url` + `image_urls[]`（兼容 `ref_images_url[]`）, `prompt`, `text`/`audio_url` |
49| `hh_long_video_create` | 长视频分镜拼接 | `story`, `total_duration`, `mode (serial/parallel)` |
50| `hh_cost_preview` | 估算费用，**不**实际提交 | 各 mode 必需的素材或 `text_chars`/`audio_duration_sec` |
51| `hh_status` | 查询任务状态 | `task_id` |
52| `hh_list` | 列最近任务 | `limit?` |
53
54工具返回 JSON 包含：`ok`, `task_id`, `status`, `mode`, `model_id`,
55`video_url`, `video_path`, `last_frame_url`, `last_frame_path`,
56`image_urls`, `local_paths`, `asset_ids`。失败时 `ok=false` + `error_kind` +
57`error_message` + `terminal=true`。
58
59## 3 · 工作台联动协议
60
61每个 `hh_*` 创建工具的输入 schema 都接受 `from_asset_ids: string[]`，
62runtime 把上游图片工作台（如 `tongyi-image`）产出的 asset_ids 透传过来：
63
64| mode | from_asset_ids 角色映射 |
65|---|---|
66| `i2v` | `[0]` → first_frame，`[1+]` → reference_image |
67| `i2v_end` | `[0]` → first_frame，`[1+]` → last_frame |
68| `r2v` | 全数组 → `reference_urls`（按角色顺序） |
69| `video_edit` / `video_extend` / `video_relip` | `[0]` → `source_video_url`，`[1+]` → `reference_urls` |
70| `video_reface` | `[0]` → `source_video_url`，`[1]` → `image_url` |
71| `pose_drive` | `[0]` → `image_url`，`[1]` → `source_video_url` |
72| `avatar_compose` | `[0]` → `image_url`，`[1+]` → `image_urls` |
73| `image_*` | 全数组 → `images`，`[0]` → `image_url` |
74
75工具返回的 `asset_ids` 是本插件登记到 Asset Bus 的图片/视频资产，下游可继续消费。
76
77## 4 · 模型派发表（client 由 registry 驱动，无硬编码 if-else）
78
79| 模型族 | 协议 | 关键参数 |
80|---|---|---|
81| `happyhorse-1.0-*` | 新版 video-synthesis | `resolution: "720P"` / `"1080P"`（**P 大写**）。**禁用** `with_audio` / `size` / `quality` / `fps` / `audio` |
82| `wan2.7-i2v` | 新版 video-synthesis + 多模态 | `resolution`, `task_type` (`first-frame`/`first-and-last-frame`/`video-continuation`) |
83| `wan2.6-*` | 旧版 video-synthesis | `size: "1280*720"`（**星号 W*H**）, `audio: true` |
84| `wan2.2-s2v` / `s2v-detect` | s2v 旧版 | OSS 签名 URL 必填 |
85| `wan2.2-animate-*` | animate 旧版 | `mode: "wan-std"\|"wan-pro"` |
86| `videoretalk` | videoretalk 旧版 | 视频 + 音频 URL |
87
88## 5 · 烟测脚本（≈¥0.50, < 5 分钟）
89
90```text
911. Settings 填 DashScope API Key + OSS 四件套
922. Create Tab → t2v → prompt: "海上日出，慢镜头，电影感"
933. duration=5, resolution=720P → 估算费用 ≈ ¥4.5（HappyHorse 1.0）
944. 「直接提交」→ Tasks Tab 看进度 → 60-180 秒后 done
955. 抽屉看视频，下载 mp4
96```
97
98## 6 · 已知陷阱
99
100- **DashScope 异步任务并发 = 1 / Key**：本插件 `Semaphore(1)` 串行化。
101- **HappyHorse 1080P = 1.6 元/秒**：5 秒 = ¥8，请先估价。
102- **OSS bucket 跨地域不可达**：endpoint 区域必须和 API Key 区域一致。
103- **task_id 24 h 过期**：超期 `hh_status` 返 `not_found`；本地 sqlite 仍存 metadata。
104
105## 7 · 相关插件
106
107- [`tongyi-image`](../tongyi-image/) — 上游分镜图工作台（asset_ids → from_asset_ids）
108- [`seedance-video`](../seedance-video/) — 火山版视频工作台（双轨并存，不替代）
109- [`avatar-studio`](../avatar-studio/) — 数字人专项（多 backend，不替代）
openakita