| name | hair-cam-anno |
| description | 安防摄像头视频 VL 模型微调数据集标注工具。用于从安防摄像头视频中提取关键帧、分析视频内容、生成结构化标注（含环境/人物/行为/风险描述），并输出符合 dataset.jsonl 格式的微调训练数据。Use when 用户需要对安防摄像头视频进行数据标注、生成 VL 模型训练数据集、处理 /root/hair-cam 目录下的视频数据，或提及 "hair-cam"、"数据标注"、"视频标注"、"VL模型微调"。 |
hair-cam-anno — 安防摄像头视频标注
对安防摄像头拍摄的视频进行帧提取、视觉分析、结构化标注，输出 dataset.jsonl 格式的 VL 模型微调数据集。
工作流程
第1步：提取视频帧
python3 <skill>/scripts/extract_frames.py \
--data-dir <视频目录> \
--output-dir <帧输出目录> \
--fps 0.5 \
--max-frames 4
- 从每个视频均匀提取 4 帧（每2秒一帧）
- 生成
manifest.json 记录每个视频的元信息和帧路径
第2步：逐视频分析标注
对每个视频：
- 查看提取的帧：用
read 工具读取帧图片（支持 jpg/png）
- 从文件名推断信息：文件名包含关键信息（如
海尔摄像头-1男1女-坐-2 → 品牌=海尔摄像头, 1男1女, 行为=坐）
- 生成标注 JSON：根据帧画面内容 + 文件名信息，生成结构化标注
标注 JSON 结构：
{
"title": "场景标题",
"subtitle": "场景副标题",
"description": "详细描述（≥50字，含环境、人物外貌、行为姿态）",
"labels": ["system_suggest_X", ...],
"risk": {
"level": "none|low|medium|high",
"description": "风险描述"
},
"simple_description": "简练描述（≤20汉字）"
}
第3步：汇总生成 dataset.jsonl
- 将所有标注结果收集到
annotations.json，格式：
[
{"video": "文件名.mp4", "annotation": { ...标注JSON... }},
...
]
- 运行构建脚本：
python3 <skill>/scripts/build_jsonl.py \
--annotations annotations.json \
--video-dir <视频目录> \
--output dataset.jsonl
- 脚本会自动验证标注数据并生成
dataset.jsonl
关键参考
- System prompt 模板:
references/system-prompt.md
- 标签范围:
references/labels-reference.md
标签选择规则
- 根据视频实际内容选择匹配标签
- 可多选，但不要选不匹配的标签
- 如果视频中有危险行为（儿童攀爬窗户、摔倒等），risk.level 应为 medium 或 high
- 文件名中的信息（人数、行为）必须与标注一致
