ipcam

IP Camera Skill 是一款面向专业用户的摄像头统一管控工具，基于业界标准的 ONVIF 协议与 RTSP 流媒体技术，提供从设备发现、云台控制到视频捕获的全链路解决方案。

核心用法
该 Skill 通过两个核心组件实现功能：camera.sh 负责 RTSP 流媒体操作，包括抓取即时快照、录制指定时长视频、获取流地址及测试连通性；ptz.py 则提供完整的 ONVIF PTZ（云台控制）能力，支持方向性移动（上下左右及组合方向）、绝对坐标定位、变焦控制、预设位管理与自动设备发现。用户可通过配置文件 ~/.config/ipcam/config.json 集中管理多摄像头，或使用环境变量进行临时覆盖，实现灵活的自动化脚本集成。

显著优点
兼容性是该 Skill 的突出优势，已验证支持 TP-Link Tapo/Vigi、Hikvision、Dahua、Reolink、Amcrest、Axis 等主流品牌，覆盖 ONVIF Profile S/T 标准设备。安装配置流程兼顾自动化与精细化：既支持网络自动扫描发现摄像头并一键添加配置，也允许手动精确配置端口与路径参数。命令行交互设计简洁高效，支持多摄像头切换操作，且依赖的 onvif-zeep 与 ffmpeg 均为成熟开源项目，技术栈可靠稳定。

潜在局限
作为命令行工具，其学习曲线较陡，需要用户具备一定的网络与 Linux 基础知识。RTSP 协议本身不提供传输层加密，视频流在局域网内以明文传输，存在被中间人窃听的风险。配置文件采用 JSON 格式明文存储摄像头密码，虽通过文件权限控制可缓解，但仍不如系统密钥管理安全。此外，Skill 依赖外部二进制工具（ffmpeg、python3、jq），在部分精简系统上可能存在部署障碍。

适用人群
本工具特别适合具备技术背景的智能家居爱好者、中小型企业安防系统管理员、需要进行摄像头自动化测试的开发者，以及负责多点位监控设备运维的 IT 人员。对于希望通过脚本实现监控联动（如定时抓拍、移动侦测后自动录制）的高级用户尤为适用。

使用风险
主要风险集中在网络安全层面：摄像头密码以明文形式存储于配置文件，若设备被入侵可能导致监控权限泄露；RTSP 流未加密传输可能被局域网内恶意节点截获；部分摄像头存在并发连接数限制，频繁操作可能导致服务暂时不可用。建议仅在受信任的局域网内部署，为摄像头配置强密码，并设置配置文件权限为 600 限制访问。