VSS 归档视频搜索
通过自然语言搜索归档视频，并摄取文件或 RTSP 流建立可检索索引。
技能明确要求用户提供 HOST_IP，并在部署前请求确认；说明了视频、RTSP、VIOS、RTVI、Elasticsearch 和 NGC 凭据的数据流，也避免直接打印令牌。扣分原因是搜索、上传和删除均会产生外部副作用，删除流程没有明确的二次确认或恢复方案，视频隐私/敏感数据处理未说明，且凭据和远程服务依赖的最小权限边界不完整。
步骤、接口和若干异常路径较为具体，包含服务探测、来源校验、回滚说明和故障排查反馈。扣分原因是静态审查无法复现关键路径，测试覆盖很薄，基准仅包含一个评估任务；部分服务依赖、接口版本和跨组件失败语义仍需运行环境验证。
适用场景、输入来源、搜索模式以及不适用的问答、字幕和摘要场景描述清楚，且要求来源存在后再搜索。扣分原因是没有中文查询行为或中文输出示例，对网络可达性、部署区域和非 NVIDIA 环境的边界说明有限；核心功能依赖用户可达的 VSS、NGC 和相关服务。
文档包含 frontmatter、前置条件、工作流、示例、限制、故障排查和引用资料，并标注版本 3.2.0、作者和 Apache-2.0。扣分原因是缺少明确 changelog、维护责任人和更新流程；skill-card 声称“Apache 2.0 OR MIT”，与 SKILL.md 的 Apache-2.0 不一致；基准报告还记录了 author 格式问题。
技能覆盖自然语言视频融合搜索、文件/RTSP 摄取和清理，并规定结果报告、结果核验和可选截图验证，具备直接完成任务的流程价值。扣分原因是静态审查不能确认实际搜索结果正确性，基准只有一个任务且报告中的效果得分为 62%（Codex）和 68%（Claude），输出仍依赖部署、索引和人工视觉复核。
路径内包含评估清单、搜索场景、基准指标和故障排查命令，部分关键声明可由提交文件审计。扣分原因是没有多源独立佐证或持续集成测试，评估样本仅一个任务，静态读取不能证明真实运行结果；因此不超过静态上限 5 分。
- 执行删除前应增加明确的用户确认、目标 UUID 校验和可恢复备份/回滚策略。
- 不要在日志、命令回显或错误信息中暴露 NGC/API 凭据；应补充视频隐私、访问控制和数据保留要求。
- 部署和搜索依赖 VSS、Docker、GPU、Elasticsearch、NGC 及远程服务；在中国大陆网络或受限网络中需先验证可达性。
- 应统一 Apache-2.0 与 Apache 2.0 OR MIT 的许可证元数据，并补充持续测试、版本变更和维护责任说明。
这个 Skill 能做什么，适合哪些场景？
该技能用于在 NVIDIA Video Search and Summarization 部署中执行顶层融合搜索。它支持搜索已归档视频、通过 VSS 后端摄取视频文件或 RTSP 流，以及删除已摄取来源。搜索使用 Cosmos Embed1 生成视频片段向量，并通过 Elasticsearch 进行相似度匹配。使用前必须具备可访问的 VSS search profile、必要凭据和命令行依赖。
检查 VSS agent 和 Elasticsearch 是否可访问；列出并核验 VIOS 中的视频来源；通过 VSS agent 后端上传视频文件或注册 RTSP 流；触发 RTVI-CV 与 RTVI-Embed 处理并将嵌入写入 Elasticsearch；向 /generate 发送自然语言查询；返回按相关性排序、带时间戳和播放链接的视频片段；通过 agent 后端删除视频文件或 RTSP 来源。
- 安防或运营人员需要在仓储归档中查找叉车、人员或车辆时，使用自然语言检索相关片段。
- 调查人员需要定位人员进入限制区域、卡车到达入口等动作事件时，搜索指定时间范围。
- 视频平台管理员需要将新的视频文件摄取到搜索系统并等待嵌入生成后再查询。
- 摄像头运营人员需要注册 RTSP 流，让后续视频片段进入搜索索引。
- 系统管理员需要同时清理 VIOS 存储和对应搜索嵌入时，通过 agent 后端删除来源。
这个 Skill 有哪些优点和局限？
- 支持归档视频和 RTSP 流两类来源。
- 提供文件摄取、流注册、搜索和删除的完整 agent 后端流程。
- 支持属性搜索、嵌入搜索以及属性与动作融合搜索。
- 包含部署检查、来源核验和常见故障处理要求。
- 文档明确将视频搜索标为 Alpha Feature，不建议用于生产环境。
- 依赖可访问的 VSS search profile、Elasticsearch、Docker、curl、jq 和 NGC 凭据。
- GPU 内存、并发和存储能力取决于主机硬件及部署 profile。
- NGC 模型和 NIM 可能受速率限制、GPU 内存要求及许可证限制影响。
如何安装这个 Skill？
安装整个 NVIDIA 技能集合：npx skills add nvidia/skills。只安装本技能：npx skills add nvidia/skills --skill vss-search-archive --yes。README 未说明其他手动安装步骤。
如何使用这个 Skill？
先向 agent 明确提供 HOST_IP；确保 VSS search profile 正在运行，并且视频来源已通过 VSS agent 后端摄取。然后可触发“find all instances of forklifts”或“show me people near the loading dock”等请求。REST 示例：curl -s -X POST http://${HOST_IP}:8000/generate -H "Content-Type: application/json" -d '{"input_message":"find all instances of forklifts"}' | jq .。若请求指定来源，必须先在 VIOS 中核验；若未提供 HOST_IP、来源不存在或搜索异常，技能要求停止并等待处理。
这个 Skill 与同类方案有什么区别？
与 vss-ask-video 的边界是：本技能用于归档视频搜索，不用于临时视觉问答。与 vss-deploy-dense-captioning 的边界是：本技能不负责实时字幕。与 vss-summarize-video 的边界是：本技能不负责视频摘要或报告。