用途：video-spotlight 是一项注意力剪辑技能，在短时间内对画面特定目标施加局部光照强调，随后恢复正常画面。它定位于“选择性聚光”而非全局暗角或永久调色，只有当某个具体对象或区域需要临时强调时才使用。
适用触发场景：产品被点名、图表数值被讲解、某个 UI 控件只对一条指令重要、面部反应是叙事节拍，或某个物理细节否则容易被错过。若整幅画面同等重要，或仅因镜头画面安静就保留效果，则不应使用。
主要能力与工作流：技能以归一化坐标定义目标，x、y 为中心，rx、ry 为水平与垂直半径，并设置起止时间、变暗程度（dim）与降饱和程度（desat）。示例配置为 start 4.2、end 6.0、target area、area x 0.50、y 0.45、rx 0.25、ry 0.20、dim 0.45、desat 0.60。随后用 python3 scripts/spotlight_plan.py 配合 --start --end --x --y --rx --ry --dim --desat --frame-width --frame-height 参数生成计划文件，计划中保留归一化目标几何、光照强度、帧尺寸、时间与生成的 ffmpeg_filter。
生成的滤镜完成四件事：保留未处理的底图副本；创建变暗且降饱和的副本；按配置目标构建椭圆灰度遮罩；在遮罩内恢复原始像素，并仅在指定时间窗内叠加效果。时间窗之外原始素材原样通过。目标区域因保留原始像素而保持明亮，并非整帧替换。使用时读取计划中的 ffmpeg_filter 作为视频滤镜图；除非创意要求音频点缀，源音频保持不变。若当前合成已在 HyperFrames 中运行，则用相同目标几何与时间在该环境中构建等效遮罩层，而不是增加第二条渲染路径。
强度与质量控制：从细微开始，正常强调节拍应保留足够周边细节以理解上下文，降低饱和度而非完全去色，避免压暗肤色或黑位，持续时间只与所讲或视觉概念所需一致。目标应因周围退后而吸引注意，而不是像效果演示那样发光。硬性失败条件包括：目标本身变暗、效果窗之外整帧持续变暗、遮罩指向空白区域、相关词语或动作结束后聚光仍保留、效果强于内容、肤色明显变化、重复聚光形成可预测的视觉套路。
限制与注意事项：内置区域计划是静态的；若目标在时间窗内明显移动，应缩短窗口、拆分为多个目标窗口，或使用当前运行时的主体跟踪或已有主体遮罩，不能任由主体走出静态聚光区。需保持交付色彩契约，普通网络视频应验证最终渲染文件的 BT.709 标签与范围，不要假定滤镜字符串正确就保证编码后颜色正确。资料未提供图形界面、收费、平台兼容范围或可直接用于非 ffmpeg 流程的细节。