视频水印去除器

使用 ffmpeg 的 delogo 滤镜，移除视频中的水印/Logo/文字叠加层。

核心逻辑

步骤 1：提取采样帧
以每秒一帧的间隔提取视频帧，用于定位水印位置：

for t in 1 2 3 4 5; do
  ffmpeg -y -ss 00:00:0$t -i "$INPUT" -frames:v 1 "/tmp/wm_frame_$t.jpg" 2>/dev/null
done

步骤 2：使用视觉模型分析
调用 image 工具分析上述采样帧。需明确请求以下信息：

• 水印的确切位置（位于哪个角或哪条边）
• 像素级包围框：针对 W×H 分辨率的视频，给出 x、y、width、height 四个值
• 水印是否在所有帧中位置固定（静态），还是随时间变化（动态）

步骤 3：构建分段处理策略

静态水印（整段视频中位置不变）：

• 对整个视频执行一次 delogo 处理

动态水印（在特定时间点发生位置变化）：

• 识别各分段边界（例如：0–3.5s 位于右下角，3.5s 起移至左侧边缘）
• 对每个分段分别应用对应坐标的 delogo 处理
• 将处理后的各分段重新拼接为完整视频

步骤 4：处理与验证

# 单一分段
ffmpeg -y -i "$INPUT" -vf "delogo=x=$X:y=$Y:w=$W:h=$H" -c:a copy "$OUTPUT"

# 多分段
# 使用 -ss/-t 参数分别处理各段，再拼接

在最终交付前，须使用视觉模型逐段验证处理效果。

关键参数

获取精确坐标的方法：

• 视觉模型返回的是基于 0–1000 归一化尺度的坐标 —— 需转换为实际像素值
• 对于 720×1280 视频：actual_x = normalized_x * width / 1000
• 始终在检测到的区域基础上额外增加 5–10 像素的 padding，确保完全覆盖水印

动态水印分段处理

当水印在多个明显不同位置间移动时：

1. 识别切换时间点 —— 记录各帧中水印所处的具体位置
2. 划分分段 —— 每次位置变化即为一个新分段的起始边界
3. 分段处理 —— 对每个时间段应用对应的 delogo 坐标参数
4. 拼接输出 —— 使用 ffmpeg concat 模式配合清单文件：

   file 'seg1.mp4'
   file 'seg2.mp4'
   

   ffmpeg -y -f concat -safe 0 -i concat.txt -c copy output.mp4
   

示例分段方案：

多水印处理

若视频中同时存在多个水印（例如：角落 Logo + 用户名标识）：

• 需先明确用户希望移除哪些、保留哪些
• 可在同一 -vf 字符串中串联多个 delogo 滤镜：

  -vf "delogo=x=540:y=1195:w=165:h=55,delogo=x=30:y=480:w=160:h=210"
  

输出交付

• 保存至 /root/.openclaw/workspace/downloads/
• 通过 message 工具，使用 media 参数发送
• 最终交付前须向用户确认

限制说明

• delogo 采用模糊/均值填充方式覆盖水印区域 —— 在简单、静态背景上效果最佳
• 半透明水印、复杂 AI 生成水印，以及在纹理丰富背景上移动的水印，仍可能残留可见痕迹
• 如需 AI 图像修复（自然的内容感知填充），本技能无法实现 —— 若 delogo 结果不理想，应主动告知用户，并建议其使用图像修复流水线