用途：对已索引的视频库做自然语言搜索。需先确认后端健康且搜索功能已启用，否则可借助 vss-doctor / vss-up。接口统一走 nginx 的 /manager 前缀，基础地址设为 HOST=http://${HOST_IP:-localhost}:${APP_HOST_PORT:-12345}。
主要能力与用法：
- 上传视频：POST /manager/videos，multipart/form-data，字段名 video，可选逗号分隔 tags；文件须为可流式播放的 MP4，否则被拒。返回 videoId。可用 GET /manager/videos 列出（响应为对象 { "videos": [...] }），单条记录包裹在 .video 下；name 是生成的哈希，真实文件名看 url / dataStore.fileName。
- 生成嵌入：视频上传后须调用 POST /manager/videos/search-embeddings/<VIDEO_ID>，等待完成后再查询，否则不可搜索。
- 查询：POST /manager/search/query，JSON 体含必填 query（自然语言），可选 tags（逗号分隔，与查询取交集）和 timeFilter（相对 value+unit=minutes|hours|days|weeks，或绝对 start/end ISO-8601）。响应为 { "results": [ { "query_id", "results": [...] } ] }，排名片段在 .results[].results[]。每个片段 metadata 含 relevance_score（0..1）、video_id、video_url、segment_start/segment_end、seek_timestamp、tags、video_metadata（时长/帧率）；搜索模式下 page_content 是片段定位符而非字幕。结果不含文件名，需用 video_id 关联视频列表的 dataStore.fileName。
- 保存/管理查询（可选）：POST /manager/search 创建持久查询得 queryId；GET /manager/search/<QUERY_ID> 取结果；POST .../refetch 重跑；PATCH .../watch 设 {"watch":true} 自动刷新；GET /manager/search/watched 列出；DELETE 删除。
适用场景：对视频库按人物、物体、场景等自然语言描述检索片段，并按标签或时间范围过滤。
限制：需后端健康且搜索启用；视频须为可流式 MP4；未生成嵌入前无法搜索；结果不含文件名需自行关联；具体部署与鉴权细节资料未提供。