用途:在 Video Search & Summarization(VSS)应用的视频库中做自然语言检索。技能通过真实源文件驱动该应用,需先运行捆绑的 bootstrap 脚本定位或稀疏检出 VSS 源码,并打印应用根目录 APP_ROOT,后续命令均在该目录下执行。
主要能力:上传视频(POST /manager/videos,multipart 字段 video,可选逗号分隔 tags,仅接受可流式播放的 MP4);列出与查看视频;为视频生成搜索嵌入(POST /manager/videos/search-embeddings/<VIDEO_ID>,未生成嵌入前不可搜索);一次性查询(POST /manager/search/query,支持必填 query、可选 tags 与 timeFilter,相对或绝对时间);以及可选的持久化查询管理(创建、获取、refetch、watch、列出 watched、删除)。
使用方式:先设置 HOST=http://${HOST_IP:-localhost}:${APP_HOST_PORT:-12345},用 curl 探测 /manager/health 与 /manager/app/features 确认后端健康且搜索已启用,否则改用 vss-troubleshoot / vss-deploy。查询响应为包裹结构,命中片段位于 .results[].results[],元数据含 relevance_score、video_id、video_url、segment_start/segment_end、seek_timestamp、tags 与 video_metadata;结果不含文件名,需用 video_id 关联视频列表的 dataStore.fileName。
适用场景:对已入库视频按自然语言查找特定画面片段,并按标签或时间范围过滤。
限制:需 VSS 应用存在且后端健康、搜索功能启用;视频须为可流式 MP4;嵌入生成需等待完成;文件名需额外关联获取。其余细节暂未提供。