mcpField
M
muapi-cinema-director

muapi-cinema-director

github.com/samuraigpt创意与媒体253.1k 次安装4 周前更新
代码仓库

关于 muapi-cinema-director

面向 AI Agent 的电影导演技能,将创作意图转化为视频模型可用的镜头、运镜、灯光和技术参数指令,并通过脚本生成视频。

主要功能

  1. 01创作意图映射为镜头构图
  2. 02编排实体运镜与镜头效果
  3. 03设计灯光与氛围
  4. 04优化帧率、画幅和模型参数
  5. 05扩展视频生成提示词

适用场景

  1. 01将情绪构思转换为电影镜头语言
  2. 02为 Veo3、Kling 或 Luma 撰写视频提示词
  3. 03提交生成任务并轮询异步结果

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-cinema-director

安装后在 Claude Code 中输入/muapi-cinema-director确认已加载。

详细介绍

🎬 AI 电影导演技能

专为 AI Agent 打造的技能,可执导高保真电影级视频。 电影导演技能可将高层次的创作意图转化为先进视频模型(Veo3、Kling、Luma)的专业电影摄影指令。

核心能力

  1. 镜头构图分析:将情绪节点映射到合适的取景方式(例如,用特写表现亲密感,用远景表现孤独感)。
  2. 摄影机运动编排:指导复杂的物理运动(推轨、横移、升降)和镜头效果(移焦、希区柯克变焦)。
  3. 灯光与氛围设计:指定具有时间感和风格化的灯光(黄金时刻、明暗对照法、体积光束)。
  4. 技术参数优化:自动选择最佳帧率、宽高比和特定模型的偏好参数。

🏗️ 技术规范

1. 意图映射表
创作意图取景运动灯光
英雄式登场低角度/远景升降/环绕轮廓光/高对比度
紧张/不安倾斜角度手持抖动低调照明/硬阴影
内省特写缓慢推进柔和伦勃朗光/窗光
壮丽/史诗感大远景无人机飞越黄金时刻/体积光
忧郁侧面/中景缓慢拉远蓝调时刻/低饱和度
2. 摄影机的物理运动
  • Dolly In/Out:摄影机沿轨道朝向主体或远离主体移动。
  • Truck Left/Right:摄影机进行横向物理移动。
  • Crane/Jib:摄影机从高处进行大幅垂直移动。
  • Orbit:摄影机围绕中心点环绕移动。
  • Pedestal:垂直升降(不进行倾斜)。
3. 镜头与光学控制
  • Shallow DOF:背景模糊(散景)。
  • Anamorphic:水平光斑和宽银幕电影质感。
  • Rack Focus:在镜头内不同景深平面之间切换焦点。

🧠 提示词优化协议(Agent 指令)

调用脚本前,Agent 必须使用以下导演规则扩展用户的原始提示词:

  1. 注入技术细节:将“酷炫动作”转化为专业镜头描述。
    • 公式:[镜头类型] + [主体/动作] + [环境] + [灯光] + [摄影机运动] + [镜头效果]
  2. 动态设计:使用电影化动词:Dolly In(营造亲密感)、Crane Up(营造壮丽感)、Orbit(营造英雄感)、Truck(平行移动)。
  3. 灯光方案:采用特定照明方式:Volumetric God Rays、Teal-and-Orange Grade、Cyberpunk Rim Lighting、Rembrandt Portrait Lighting。
  4. 物理逻辑:描述光线之间的关系(例如,“霓虹灯倒映在雨水浸湿的沥青路面上,闪烁不定”),以引导模型进行推理。

🚀 协议:使用电影导演

步骤 1:定义创作简报

向 Agent 提供一个主体和一份“导演意图”。

步骤 2:调用脚本

generate-film.sh 脚本接受 --brief 参数,并利用其内置的电影摄影知识扩展简报。

# Directing a scene
bash scripts/generate-film.sh 
  --subject "A lone samurai in a blizzard" 
  --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 基础功能的“专家翻译器”。它维护一份电影风格词典,并在执行前将技术指令注入提示词。

评论

支持 Markdown