神眸 (Cinmoore) 技能指南
智能摄像头控制、媒体采集、AI视觉分析与飞书消息推送一体化解决方案。
核心能力
- 📷 相机控制：PTZ云台控制、视频录制、图像抓取
- 🎨 媒体分析：图像/视频AI分析、智能寻物定位、图像编辑转换
- 📬 飞书推送：图片/视频卡片消息、自动GIF预览
- 🎬 Vlog生成：自动视频剪辑与合成
- ⚠️ 事件检测：自定义事件监控与告警
配置说明
⚠️ 重要：首次使用前必须在cinmoore-skill目录下配置 cinmoore_config.yaml 文件， 同时所有命令需要在cinmoore-skill目录下执行，以确保配置文件准确加载，数据统一保存在该目录下。
使用提醒
⚠️ 重要：PowerShell 不支持 && 连接多条命令。如需顺序执行多条命令：
- 使用分号
; 分隔：cmd1; cmd2
- 或使用管道
| 传递输出：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
# 添加检测事件
python -m cinmoore_skill.commands.test_event_reporter set --add "检测有人闯入"
# 删除检测事件
python -m cinmoore_skill.commands.test_event_reporter set --delete "检测有人闯入"
# 运行事件检测
python -m cinmoore_skill.commands.test_event_reporter run --txt_file analysis.txt
5. Vlog生成
# 基础生成（默认主题：日常生活）
python -m cinmoore_skill.commands.test_generate_vlog video_folder\
# 指定主题
python -m cinmoore_skill.commands.test_generate_vlog video_folder\ --user_input "乒乓球比赛"
# 指定时间范围
python -m cinmoore_skill.commands.test_generate_vlog video_folder\ --user_input "乒乓球比赛" --start_time 20260311000000 --end_time 20260311235959
输入说明：
程序会自动检查指定文件夹是否存在匹配的视频和描述文件，无需手动创建
- 需要有已分析的视频文件（
.mp4）和对应的分析文本文件（analysis_视频文件名.txt）
- 程序会自动查找匹配的文件进行vlog生成
输出文件：
vlog_{时间戳}.mp4: 合成视频vlog_{时间戳}_cover.jpg: 封面图片
输出路径管理
所有输出文件保存在 temp\ 目录，按日期分目录：
temp\
├── 20260317\
│ ├── image_设备ID_时间.jpg # 抓取图像
│ ├── video_设备ID_时间.mp4 # 录制视频
│ ├── analysis_时间.txt # AI分析结果
│ ├── grounded_时间.jpg # 寻物标注
│ ├── edited_时间.jpg # 图像编辑
│ ├── gif_时间.gif # GIF预览
│ └── vlog_时间.mp4 # Vlog视频
├── custom_event.json # 事件定义
获取最新文件：
$IMAGE = Get-ChildItem -Path "temp\*\image_*.jpg" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | ForEach-Object { $_.FullName }
$VIDEO = Get-ChildItem -Path "temp\*\video_*.mp4" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | ForEach-Object { $_.FullName }
$ANALYSIS = Get-ChildItem -Path "temp\*\analysis_*.txt" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | ForEach-Object { $_.FullName }
工作流示例
安全巡检工作流
Write-Host "=== 安全巡检工作流 ==="
# 步骤1：抓取巡检图像
python -m cinmoore_skill.commands.test_camera_controller --capture --capture-duration 3
$IMAGE_FILE = Get-ChildItem -Path "temp\*\image_*.jpg" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | ForEach-Object { $_.FullName }
Write-Host "✓ 图像已保存: $IMAGE_FILE"
# 步骤2：AI分析图像内容
python -m cinmoore_skill.commands.test_media_analysis --analyze "分析巡检情况，识别异常" $IMAGE_FILE
$ANALYSIS_FILE = Get-ChildItem -Path "temp\*\analysis_*.txt" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | ForEach-Object { $_.FullName }
Write-Host "✓ 分析报告已保存: $ANALYSIS_FILE"
# 步骤3：读取分析结果并推送到飞书
$ANALYSIS_CONTENT = Get-Content $ANALYSIS_FILE
python -m cinmoore_skill.commands.test_feishu_controller --image $IMAGE_FILE --title "安全巡检报告" --analysis $ANALYSIS_CONTENT
Write-Host "✓ 已推送到飞书"
Write-Host "=== 工作流完成 ==="
智能寻物工作流
Write-Host "=== 智能寻物工作流 ==="
# 步骤1：抓取图像
python -m cinmoore_skill.commands.test_camera_controller --capture
$IMAGE_FILE = Get-ChildItem -Path "temp\*\image_*.jpg" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | ForEach-Object { $_.FullName }
# 步骤2：定位并标注目标
python -m cinmoore_skill.commands.test_media_analysis --ground "找到红色背包" $IMAGE_FILE
$GROUNDED_FILE = Get-ChildItem -Path "temp\*\grounded_*.jpg" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | ForEach-Object { $_.FullName }
# 步骤3：发送标注结果
python -m cinmoore_skill.commands.test_feishu_controller --image $GROUNDED_FILE --title "寻物结果"
Write-Host "=== 工作流完成 ==="
事件监控工作流
Write-Host "=== 事件监控工作流 ==="
# 步骤1：设置检测事件（首次运行）
python -m cinmoore_skill.commands.test_event_reporter set --add "检测有人闯入" --add "检测到烟雾"
# 步骤2：抓取并分析
python -m cinmoore_skill.commands.test_camera_controller --capture
$IMAGE_FILE = Get-ChildItem -Path "temp\*\image_*.jpg" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | ForEach-Object { $_.FullName }
python -m cinmoore_skill.commands.test_media_analysis --analyze "分析场景中的异常情况" $IMAGE_FILE
$ANALYSIS_FILE = Get-ChildItem -Path "temp\*\analysis_*.txt" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | ForEach-Object { $_.FullName }
# 步骤3：运行事件检测（自动推送告警）
python -m cinmoore_skill.commands.test_event_reporter run --txt_file $ANALYSIS_FILE
Write-Host "=== 工作流完成 ==="
