OmniFlow Studio 代理技能 是做什麼的？
此技能賦予 AI 編碼與協調代理直接控制 OmniFlow Studio 的能力——這是一個自主橋接器，可將本地 AI 代理連接到 Google Chrome 中的高保真生成式媒體畫布。
何時使用此技能
在以下情況下使用此技能：
- 使用者要求生成電影級 AI 影片、B-roll 素材、概念藝術或分鏡圖。
- 正在建立或導演一部自主式多鏡頭短片或廣告創意內容。
- 在多個影片場景中生成角色參考表（轉向一致性）。
- 自動化批次圖像/影片生成佇列，而無需支付每次分鐘的 API 費用。
- 查詢目前 OmniFlow 橋接狀態、生成配額或活躍佇列進度。
🚀 代理快速執行協定
在分派媒體作業之前，每個代理必須遵循此 3 步驟驗證迴圈：
步驟 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、參考素材 token |
flow-create-character | 生成面部一致性的 4 角度轉向表 | 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 以取得可立即執行的多場景範本。