技能介绍

要解决什么问题

IP 摄像头和 NVR 往往只暴露 rtsp:// 地址，而不是可直接在浏览器里打开的 HTTP 页面。工程师在排查监控、做临时取证或验证设备是否在线时，需要在 Agent 环境里拉流、看一帧、录一段，有时还要按间隔抓图或把多张截图合成 GIF，而不是手动开 VLC 或写一次性脚本。

技能如何工作

技能把常见 RTSP 操作收敛成可执行的 exec 路径，并约定实现优先级：

首选 python3 + opencv-python：通过 cv2.VideoCapture(rtsp_url) 读帧，用于播放预览（在无 GUI 时降级为截图）、单帧保存、定时连续截图（自然语言间隔会换算成 time.sleep 秒数），以及用 Pillow 将多张 JPG 合成 GIF（duration、loop 等参数）。
备选 ffmpeg / ffprobe：-rtsp_transport tcp 提高跨网稳定性；-vframes 1 截一帧；-t 限制录制时长，避免长时间阻塞；timeout 5 ffprobe 检测流是否可用。
参数与 URL：支持无鉴权与 user:pass@host 形式；路径因品牌而异（如 /live、/stream1）。跨网络场景建议始终用 TCP 传输。

适用边界与注意点

本地文件（.mp4 等）、格式转码、通用图像处理应交给 media-processing / image-processing 等技能；USB 本地摄像头不走 RTSP。
不要在回复中泄露或持久化用户提供的鉴权密码；不要用 browser/read 去「访问」RTSP URL。
不猜测地址：URL 不完整时要求用户补全端口与路径。定时任务若未指定张数，需设上限以防无限循环；单帧失败可跳过继续。OpenCV/ffmpeg 均不可用时，应明确降级并给出本地 VLC 等替代方案。