📦 Tracked Video Analysis — 视频结构化速览

# 跟踪式视频分析 当信任与可见度与最终摘要同等重要时，对冗长、嘈杂或操作不便的视频使用本技能。核心思想很简单： 1. 先提取内容 2. 再结构化 3. 两阶段均显式跟踪 除非有正在运行的 OS 进程或最新的状态文件证明，否则不得声称后台进程仍在运行。 ## 核心工作流 ### 1) 可靠获取视频 优先顺序： 1. 直接本地文件 2. 直接可下载链接 3. 文档上传 4. 外部文件托管作为兜底 若聊天媒体无法访问，请索要直链，而非无限重试模糊的媒体访问。 工作目录使用 tmp/video_analysis/。 ### 2) 无需 root 准备本地工具 优先使用工作区本地包，而非系统级安装。常用本地工具： - ffmpeg-static - ffprobe-static - @xenova/transformers - wavefile 若 root/提权安装被阻止，不要卡住任务——可在工作区内本地安装。 ### 3) 执行跟踪式提取 提取阶段应生成： - tmp/video_analysis/status.json - tmp/video_analysis/progress.log - tmp/video_analysis/transcript.jsonl - tmp/video_analysis/analysis.md 规则： - 优先分块而非一次性整视频 ASR。 - 优先轻量 ASR 保证稳定。 - 每块完成后更新状态。 - 若运行中断，尽量从文件恢复，而非自动从零开始。 ### 4) 执行跟踪式最终结构化 结构化阶段应生成： - tmp/video_analysis/final_status.json - tmp/video_analysis/final_progress.log - tmp/video_analysis/final_analysis.md 本阶段需： - 清理填充词与重复短语 - 将相关块归组 - 推断类别 - 统一措辞 - 将原始转录转换为用户要求的格式 ### 5) 如实报告状态 遵循以下规则： - 提取进行中 → 读取 status.json 报告 - 提取完成且无最终进程运行 → 明确说明 - 最终结构化进行中 → 读取 final_status.json 报告 - 最终结果就绪 → 读取 final_analysis.md 并正常回答 ## 标准输出格式 常见目标： - 类别 → 功能 → 描述 → 收益 - 类别 → 功能 → 简短描述 - 功能列表 + 时间戳 - 带置信度说明的简洁摘要 对于嘈杂 ASR，优先可读归一化，而非虚假精度。 ## 状态纪律 不得说“进程正在运行”，除非满足以下至少一条： - OS 进程存活 - 相关状态文件正在更新 若提取已结束，明确说明： - 提取已完成 - 无存活提取进程 - 仅余结构化（若属实） ## 需要时读取这些文件 - 读取 references/pipeline.md 获取规范跟踪工作流与故障处理。 - 提取起点使用 scripts/transcribe_tracked_light.mjs。 - 结构化起点使用 scripts/final_structurer.py。 ## 交付风格 优先简洁、可读的分段。当用户需要精美交付物时： 1. 创建干净的 .md 文件 2. 保持结构视觉友好 3. 若要求则作为文档/文件发送 ## 实用提醒 本技能优化的是操作可靠性，而非完美转录保真度。若 ASR 混乱，生成有用的结构化摘要并标明不确定性，而非假装原始转录完全准确。