🎬 AI 影视导演技能

专为 AI Agent 设计的高保真电影级视频导演能力。 影视导演技能将高层创意意图转化为面向前沿视频模型（Veo3、Kling、Luma）的技术化电影语言指令。

核心能力

1. 镜头构图分析：将情绪节奏映射至恰当的画框形式（例如，特写镜头用于表现亲密感，全景镜头用于营造疏离感）。
2. 摄影机运动编排：指导复杂的物理运动（如轨道推进 Dolly、横向平移 Truck、升降 Crane）及基于镜头的光学效果（如焦点切换 Rack Focus、滑动变焦 Dolly Zoom）。
3. 布光与氛围设计：指定时间性与风格化的照明方案（如黄金时刻 Golden Hour、明暗对比法 Chiaroscuro、体积光神之射线 Volumetric God Rays）。
4. 技术参数优化：自动选择最优帧率、宽高比及各模型专属的偏好设置（model-specific biases）。

🏗️ 技术规格

1. 创意意图映射表

2. 物理摄影机运动

• Dolly In/Out：摄影机沿轨道向/远离被摄主体进行物理位移。
• Truck Left/Right：横向物理位移。
• Crane/Jib：从高处执行的大范围垂直运动。
• Orbit：围绕中心点做环形运动。
• Pedestal：垂直方向升降（不包含俯仰 Tilting）。

3. 镜头与光学控制

• Shallow DOF：浅景深，实现背景虚化（Bokeh）。
• Anamorphic：水平眩光与宽银幕电影质感。
• Rack Focus：在单个镜头内切换不同焦平面的焦点。

🧠 提示词优化协议（Agent 指令）

调用脚本前，Agent 必须依据以下“导演守则”扩展用户的原始提示词：

1. 技术注入（TECHNICAL INFUSION）：将“酷炫的动作”等模糊描述转化为具体技术镜头。
   • 公式: [镜头类型] + [主体/动作] + [环境] + [布光] + [摄影机运动] + [镜头效果]
2. 动态表达（MOTION DYNAMICS）：使用电影化动词——Dolly In（营造亲密感）、Crane Up（强化恢弘感）、Orbit（突出英雄感）、Truck（表现平行运动）。
3. 布光范式（LIGHTING RECIPES）：应用特定照明方案——Volumetric God Rays、Teal-and-Orange Grade、Cyberpunk Rim Lighting、Rembrandt Portrait Lighting。
4. 物理逻辑（PHYSICS LOGIC）：描述光线关系（例如，“霓虹灯倒影在雨后湿滑的沥青路面上微微闪烁”），以激发模型的物理推理能力。

🚀 使用流程：影视导演协议

步骤 1：定义创意简报

向 Agent 提供拍摄主体及“导演意图（Director's Intent）”。

步骤 2：调用脚本

generate-film.sh 脚本接收一个 --brief 参数，并利用其内置的电影语言知识对该简报进行扩展。

# 导演一场戏
bash scripts/generate-film.sh 
  --subject "暴风雪中独行的武士" 
  --intent "epic reveal" 
  --model "kling-master"

步骤 3：处理异步响应

视频生成为异步操作。请使用返回的 request_id，通过 core/platform/check-result.sh 轮询生成结果是否完成。

⚠️ 约束条件与安全护栏

• 时间一致性：避免在单个镜头中引入复杂的主体形态转换（例如，“人物瞬间变为飞鸟”）。
• 运动冲突：禁止同时组合相互矛盾的运动指令（例如，“Dolly In” 与 “Dolly Out” 并存）。
• 物理真实性：优先选用现实摄影设备可实现的运镜方式，以获得更专业的“电影感”视觉效果。
• 模型倾向性：
  • Veo3：最适合节奏舒缓、强调高美学品质的镜头；
  • Kling：最适合复杂角色动作与物理模拟场景；
  • Luma：最适合快节奏、高动态的电影级序列。

⚙️ 实现细节

该技能作为 core/media/generate-video.sh 基元的“专家翻译器”，维护一份电影风格词典，并在执行前将技术化指令注入提示词中。