神眸 (Cinmoore) 技能指南

智能摄像头控制、媒体采集、AI视觉分析与飞书消息推送一体化解决方案。

核心能力

• 📷 相机控制：PTZ云台控制、视频录制、图像抓取
• 🎨 媒体分析：图像/视频AI分析、智能寻物定位、图像编辑转换
• 📬 飞书推送：图片/视频卡片消息、自动GIF预览
• 🎬 Vlog生成：自动视频剪辑与合成
• ⚠️ 事件检测：自定义事件监控与告警

配置说明

⚠️ 重要：首次使用前必须在cinmoore-skill目录下配置 cinmoore_config.yaml 文件， 同时所有命令需要在cinmoore-skill目录下执行，以确保配置文件准确加载，数据统一保存在该目录下。

使用提醒

⚠️ 重要：PowerShell 不支持 && 连接多条命令。如需顺序执行多条命令：

1. 使用分号 ; 分隔：cmd1; cmd2
2. 或使用管道 | 传递输出：cmd1 | cmd2

初始化配置文件：

# 在cinmoore-skill目录下执行，然后提示用户提供必要配置项
python -m cinmoore_skill.commands.init

Windows编码设置（避免中文乱码）：

chcp 65001
$env:PYTHONIOENCODING="utf-8"

必需配置项：

server:
  device_id: "YOUR_DEVICE_ID"  # 相机设备ID

feishu:
  app_id: "YOUR_APP_ID"
  app_secret: "YOUR_APP_SECRET"
  receive_id: "YOUR_RECEIVE_ID"

models:
  api_key: "YOUR_API_KEY"  # 阿里云 DashScope API Key

快速开始

1. 相机控制

# 抓取图像（录制2秒视频并提取中间帧，不会引起云台转动）
python -m cinmoore_skill.commands.test_camera_controller --capture

# 录制5秒视频（默认不转动云台）
python -m cinmoore_skill.commands.test_camera_controller --record-duration 5.0

# 只转动云台不录制视频（向右移动）
python -m cinmoore_skill.commands.test_camera_controller --ptz-only --ptz-direction 1 --ptz-speed 0 --ptz-duration 3.0

# 转动云台并向右移动（会自动录制视频）
python -m cinmoore_skill.commands.test_camera_controller --ptz --ptz-direction 1 --ptz-speed 0 --ptz-duration 3.0

参数说明：

• --capture: 抓取单张图像（默认录制2秒视频提取中间帧）
• --capture-duration: 抓图时录制视频时长（秒）
• --record-duration: 录制视频时长（秒），默认不转动云台
• --ptz: 启用PTZ云台转动并录制视频（转动+录制）
• --ptz-only: 只转动PTZ云台不录制视频（仅转动）
• --ptz-direction: 运动方向（0:左, 1:右, 2:上, 3:下）
• --ptz-speed: 运动速度（0:慢, 1:中, 2:快）
• --ptz-duration: 运动持续时间（秒）

✅ 逻辑说明：

• 仅使用 --record-duration：只录制视频，云台不转动
• 使用 --ptz-only：只转动云台，不录制视频
• 使用 --ptz：转动云台并自动录制视频

2. 媒体分析

# 分析图片内容
python -m cinmoore_skill.commands.test_media_analysis --analyze "描述图片中的场景和人物" image.jpg

# 智能寻物：定位并标注图片中的对象
python -m cinmoore_skill.commands.test_media_analysis --ground "找到所有人像和车辆" image.jpg

# 图像编辑：风格转换、内容修改
python -m cinmoore_skill.commands.test_media_analysis --edit "将背景换成海滩" image.jpg

# 分析视频内容
python -m cinmoore_skill.commands.test_media_analysis --video-analyze "分析视频中的主要事件" video.mp4

参数说明：

• --analyze: 分析图像内容，支持场景描述、人物识别、异常检测
• --ground: 智能寻物定位，返回带标注的图像
• --edit: 图像编辑，支持风格转换、背景替换、内容修改
• --video-analyze: 视频内容分析，提取关键帧并分析事件

3. 飞书推送

# 发送图片消息
python -m cinmoore_skill.commands.test_feishu_controller --image "path\to\image.jpg" --title "巡检截图"

# 发送视频消息（自动生成GIF预览）
python -m cinmoore_skill.commands.test_feishu_controller --video "path\to\video.mp4" --title "巡检录像"

# 发送消息并附带AI分析结果
python -m cinmoore_skill.commands.test_feishu_controller --image "path\to\image.jpg" --title "安全巡检" --analysis "检测到有人员闯入"

回复准则： 发送成功后，根据内容简洁回答或询问，像家人一样，不超过100字。

4. 事件检测

# 查看当前事件列表
python -m cinmoore_skill.commands.test_event_reporter set --list