FilmMap 工作流

FilmMap 为 Agent 提供素材索引协议，不替代视觉模型或剪辑软件。一次可靠的整理流程是：确认素材范围 → 探测工具并声明 profile → 按任务规划能力 → 抽取有时间戳的证据 → 写入观察结果 → 校验索引 → 按内容和时间查询并交给剪辑。

filmmap init ./filmmap-project
filmmap profile detect --output ./filmmap-project/profile.json
filmmap artifact add ./filmmap-project/index.jsonl /media/clip.mp4
filmmap-scan.sh /media ./filmmap-project --frames 2
filmmap synthesize ./filmmap-project/index.jsonl --out ./filmmap-project/index.json
filmmap validate ./filmmap-project/index.json

filmmap install skill 安装 Agent 工作指引；filmmap install tools 安装可选 FFmpeg 辅助脚本。目录素材可通过 filmmap-scan.sh <素材目录> <工作区> [--frames] [间隔秒数] 批量登记和探测。脚本把 probe JSON 与抽帧登记为 evidence artifacts，并保留帧的源毫秒位置。内容观察可用 filmmap observe add 记录结构化 value、状态、区间和证据引用；synthesize 可生成剪辑段索引。缺少模型能力时先标为 unverified 或 unavailable，不把没有抽样到的内容写成事实。