OmniFlow Studio 智能体技能 是做什么的？
此技能赋予 AI 编码和编排智能体对 OmniFlow Studio 的直接控制能力——这是一个自主桥接器，可将本地 AI 智能体连接到 Google Chrome 中的高保真生成式媒体画布。
何时使用此技能
在以下情况下使用此技能：
- 用户要求生成电影级 AI 视频、B-roll 素材、概念艺术或故事板。
- 正在构建或导演一部自主多镜头短片或广告创意。
- 在多个视频场景中生成角色参考表（转描一致性）。
- 自动化批量图像/视频生成队列，而无需支付每分钟的 API 费用。
- 查询当前 OmniFlow 桥接状态、生成配额或活跃队列进度。
🚀 智能体快速执行协议
在分发媒体作业之前，每个智能体必须遵循此三步验证循环：
第 1 步：健康与桥接检查
验证本地 OmniFlow 桥接守护进程正在 http://127.0.0.1:8792 上运行：
node scripts/check-bridge.js
# 或直接使用 curl：
curl -s http://127.0.0.1:8792/status
- 如果离线： 指示用户或运行：
omniflow bridge start（或启动桥接后台任务）。 - 如果在线： 检查
extensionConnected是否为true且tabVisible是否为true（表示 Chrome 已打开 Google Flow）。
第 2 步：提交生成作业
智能体可以通过 REST API 或提供的辅助脚本提交作业：
# 辅助脚本（最简单）：
node scripts/submit-shot.js --mode flow-text-to-video --prompt "Cinematic drone flyover neon cyberpunk Tokyo rain 8k" --aspectRatio 16:9 --duration 6s
# 或直接 HTTP POST：
curl -s -X POST http://127.0.0.1:8792/jobs \
-H "Content-Type: application/json" \
-d '{
"mode": "flow-text-to-video",
"prompt": "Cinematic drone flyover neon cyberpunk Tokyo rain 8k",
"params": {
"aspectRatio": "16:9",
"duration": "6s",
"videoModel": "veo-3.1-fast",
"downloadSubfolder": "MyProject"
}
}'
第 3 步：监控并检索已下载的媒体
轮询直到作业状态变为 completed：
node scripts/list-jobs.js
# 或：
curl -s http://127.0.0.1:8792/jobs
当 status === "completed" 时，从 files 数组中检索本地文件路径（例如 Downloads/MyProject/...mp4）。
🛠️ 支持的生成模式
| 模式 ID | 描述 | 关键参数 |
|---|---|---|
flow-text-to-video | 从文本描述生成运动视频 | prompt、aspectRatio（16:9、9:16、1:1）、duration（4s、6s、8s） |
flow-text-to-image | 生成逼真或风格化的静态图像 | prompt、aspectRatio、imageModel（nano-banana-pro） |
flow-frame-to-video | 将静态图像或关键帧扩展为连续视频 | prompt、duration、参考资产令牌 |
flow-create-character | 为面部一致性生成四角度转描表 | characterName、visualDescription、voicePreset |
🎛️ MCP 工具调用（如果 MCP 服务器已激活）
如果 OmniFlow 的 MCP 服务器已在您的智能体环境中连接，请直接调用以下原生工具：
omniflow_status：检查桥接和浏览器连接状态。omniflow_generate_shot：使用摄像机运动（drone-wide、close-up、tracking）排队单个镜头。omniflow_produce_movie：传递完整的剧本数组（有序镜头）以顺序生成整个短片。omniflow_create_character：锁定一个角色标签，实现正面和侧面转描一致性。omniflow_list_jobs：列出活跃、排队和已完成的生成作业及其磁盘下载路径。
💡 电影级提示词最佳实践
对于使用 Veo 3.1 的逼真视频输出：
- 指定摄像机运动：例如
[Camera: drone-wide]、[Camera: slow push-in]、[Camera: tracking shot]。 - 指定光照和氛围：例如
volumetric rim lighting、golden hour anamorphic haze、35mm film grain。 - 避免术语：Google Flow 对清晰的视觉叙事描述反应最佳，而不是软件标签。
有关现成的多场景模板，请参阅 references/api-reference.md 和 examples/cinematic-short-film.json。