Communitygithub.com

闪电君主:CG与实拍合成工作流

一套用于将CG(Blender/Cycles)与实拍画面合成的工具和工作流,尤其擅长替换蓝幕或绿幕。涵盖相机匹配(镜头、传感器、两种方式测量的主体距离)、真实光照匹配、抠像与去溢色、标记点跟踪、演员在CG上的阴影、颗粒匹配以及线性光合成。

闪电君主:CG与实拍合成工作流 是什么?

闪电君主(Lightning Emperor)是一个专门用于将CG合成到实拍画面中的专业工具集,目标用户是VFX艺术家和AI代理。它同时支持MCP服务器、CLI命令行和Blender插件三种形式,底层代码统一。该技能强调了在开始任何工作之前必须先测量实拍画面,并通过两种独立方式(已知物体像素尺寸和镜头对焦距离)验证绝对比例尺,以避免灾难性错误。工作流按照严格顺序进行:文件探测与相机元数据读取 → 通过已知尺寸计算相机距离并要求两种方法一致 → 光照规划(从演员面部线性光对比确定主光源) → 自动校准抠像 → 标记点跟踪(仅当相机运动且背景被替换时) → 阴影偏移计算 → 颗粒测量与匹配 → 线性光合成 → 最终交付。工具设计上偏好先验证单帧效果再批量渲染,所有输出都包含预览图以便检查。该技能还包含一组关键的规则性判断(如“修复可能比错误更糟”、“不能观看视频”),用于防止AI代理犯常见代价高昂的错误。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LucidMach/LightningEmperor/tree/HEAD/skill/lightning-emperor

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

闪电君主:CG与实拍合成工作流 是做什么的?

一套用于在实拍演员身后或周围放置CG的工作流和工具。这些工具以三种形式存在,均运行相同代码: MCP服务器(lightning-emperor-mcp)、CLI(lightning-emperor ...)和Blender插件。当MCP工具可用时优先使用;否则使用CLI。本文档是判断依据:应该测量什么、什么地方可能出错、如何检查自己的工作。

预防代价高昂错误的规则

  1. 在决定任何事情之前先测量实拍画面。 镜头、传感器、曝光、白平衡、屏幕颜色和强度、噪点、光线来源。十秒钟的测量胜过一小时的猜测。
  2. 首先通过两种方式获得绝对比例尺。 CG相对于演员的比例尺直接取决于相机到主体的距离。通过已知物体的像素大小(头部从头顶到下巴约0.24米)和镜头文件中的对焦距离分别测量距离。如果两者不一致,停下来解决。测量错误的距离会使整个CG场景在每一帧中大小都出错。永远不要添加修正因子来隐藏比例尺错误。
  3. 从演员身上找到主光,而不是从简介或场景照片中。 在线性光下比较脸部的两侧。场景照片显示有哪些灯具存在;实拍画面显示哪个占主导。
  4. 在线性光下合成,并说明实拍画面的色彩空间。 显示参考视频:线性化,混合,重新编码。不要因为图像看起来很平就假设是对数色彩空间。
  5. 以全尺寸和裁剪方式查看图像。 缩略图会隐藏溢出、空洞和边缘。在信任遮罩之前,始终打开工具写入的预览。
  6. 修复可能比错误更糟。 每次修复后,重新查看整个画面,并重新测量你本应保护的内容。
  7. 你不能观看视频。 用数字(步长、抖动)测量运动,并清楚说明哪些只能由用户的眼睛判断。
  8. 永远不要覆盖原始文件。 在长时间渲染前检查输入大小/持续时间;保持源文件不变。
  9. 对局限坦诚相告。 当用户说某处看起来不对时,他们几乎总是对的:调查,报告数值,说明你哪里做错了。

工作流

0. 素材导入。 探测每个文件。如果格式允许,读取相机元数据(read_camera_metadata / lightning-emperor metadata):焦距(是否变焦?)、对焦距离、ISO、白平衡。只询问那些会影响工作的问题:CG相对于演员的位置、相机高度、交付格式。

1. 相机。 从实拍画面中的已知尺寸和镜头对焦距离计算相机距离(solve_camera_distance),要求一致性为真(agree: true)。然后规划相机(plan_camera)(姿态、过扫描尺寸、每米像素数)。使用过扫描渲染(约1.25倍),这样跟踪的运动永远不会暴露渲染边缘。

2. 光照。 从脸部确定主光源侧。plan_lights 提供起始位置和颜色(方位角0度=从相机方向,+90度=相机右侧,色温值)。通过实拍画面上的测量值(皮肤区域、背景)校准CG曝光,而不是凭眼睛判断。闪烁的实用灯:practical_states 给出需要渲染的帧(开/关)。

3. 抠像。 执行 key_frame 并打开 preview_on_grey.png。抠像会自动校准到屏幕,但请阅读 references/keying.md 了解要检查的内容(深色衣物中的空洞、溢色偏色、留下的孤立点)。

4. 跟踪(仅当相机移动且背景被替换时)。track_markers 使用每帧单应矩阵跟踪标记点星座。阅读 references/tracking.md:标记点少的帧噪声大,平坦背景是一个平面(单应矩阵是正确模型),没有可见标记点意味着正在保持或插值。

5. 阴影。 shadow_offset 根据光照几何和演员到墙壁的间隙计算演员阴影落在背景上的位置。参见 references/shadows-and-grain.md。

6. 颗粒。 从平坦屏幕区域测量颗粒(measure_grain);将其应用到CG上,使其看起来不像粘贴上去的。在最终分辨率下测量。

7. 合成。 首先在单帧上执行 composite_frame。检查墙壁尺寸与演员的比例、阴影侧、边缘、黑电平,然后放大。将长时间运行的渲染任务分块进行,并验证帧数。

8. 交付。 当跟踪在某个时间段内不可靠时,向艺术家提供分层渲染结果和诚实的逐帧质量标记,而不是一个假装完成的合成。

工具映射表

需求MCP工具CLI插件
从相机文件获取镜头/曝光read_camera_metadatametadata画面面板
将导出素材与相机文件对齐align_clipalign
主体距离solve_camera_distancedistance主体 + 相机
相机姿态、渲染尺寸plan_camera, build_shot_scene创建镜头相机
灯光布局plan_lights灯光
实用灯亮/灭帧practical_states闪烁
渲染CG各状态render_states渲染CG
遮罩 + 去溢色key_framekey画面工具
标记点跟踪track_markerstrack画面工具
阴影偏移shadow_offsetshadow-offset
颗粒measure_graingrain画面工具
单帧合成composite_framecomp

工具错误返回格式为 {"error": "..."} 及原因;修正输入后重试。 Blender以无头作业方式运行。切勿尝试打开一个在正在运行的Blender窗口中执行代码的套接字。

参考资料(在适用的阶段阅读)

  • references/failure-modes.md - 什么地方会出错、原因及修复方法。先快速浏览。
  • references/scale-and-distance.md - 相机距离错误及其防范规则。
  • references/lighting.md - 找到真实主光、构建和校准灯光布局。
  • references/compositing.md - 遮罩、四种溢色、基准电平、柔化度、光晕、检查项。
  • references/camera-metadata.md - 相机文件告诉你的信息,以及如何将导出素材与它们对齐。
  • references/review.md - 如何在不自欺的情况下使用评论代理。
  • references/keying.md - 遮罩、去溢色、边缘处理以及从真实素材中获得的经验。
  • references/tracking.md - 标记点跟踪、稳定化、间隙处理。
  • references/shadows-and-grain.md - 阴影几何、颗粒测量与匹配。
  • references/blender-notes.md - Blender 4.2-5.x 用于无头工作的脚本编写笔记。

相关技能