VSS 配置文件部署助手
为 NVIDIA 视频搜索与摘要蓝图选择、部署并验证 Compose 配置文件。
证据显示技能明确要求凭据门禁、远程端点意图确认、生成环境与源.env隔离、不得打印令牌、部署前展示摘要并确认；但第0步要求在确认部署前拆除现有部署并清理数据卷，未在本文件中明确用户同意、备份或恢复路径，属于高风险破坏性默认，因此大幅扣分并触发阻断。
证据显示流程顺序、硬件检查、凭据探测、Compose dry-run、配置校验、容器计数和就绪检查较完整，也提供异常停止条件；但关键参考文件、脚本实现和真实运行结果未在本次材料中提供，静态审查无法验证依赖可用性、关键路径复现或错误处理，故不超过静态上限并扣分。
证据显示目标用户、配置场景、五类主要 profile、边缘硬件路由和不适用的独立微服务范围较清楚；但触发词覆盖不完整，输入输出契约仍依赖外部参考文件，未说明中文交互支持，也未证明对中国大陆网络环境的适配，故扣分。
证据显示有结构化元数据、Apache-2.0许可证、版本号、产品仓库链接、路由表、逐步流程、限制说明和基准报告；但缺少作者字段和Examples章节，未提供本技能自身的变更日志、明确维护责任或稳定参数契约，且大量安装与故障信息外置，故扣分。
证据显示技能覆盖部署、验证、调试和拆除，并定义了生成resolved.yml及健康检查等可直接操作的结果；但没有可独立核验的代表性输出或静态可复现结果，且外部profile参考文件缺失，无法确认所有场景能直接完成，按静态上限保守扣分。
证据显示有修订版本、产品仓库链接、提交的评估报告和多个评估用例，部分关键主张可追溯；但报告未提供可复核日志、CI测试实现或第三方独立复现材料，且核心参考内容未包含，故仅给有限静态证据分。
- 部署前会无条件进入清理现有部署和数据卷的流程；在实际运行前应明确要求用户确认数据丢失影响，并核实可恢复方案。
- 本次材料未包含 references/、脚本实现或可复核执行日志，无法静态确认硬件矩阵、凭据探测和就绪门禁的实际可运行性。
- 技能未说明中文交互或中国大陆网络可达性；NGC、Hugging Face、Docker镜像及远程端点可能需要额外网络配置。
这个 Skill 能做什么，适合哪些场景？
该技能面向 NVIDIA Video Search and Summarization（VSS）蓝图的 compose 配置文件部署。它根据用户意图选择 base、alerts、lvs、search、warehouse 或 edge 配置，并指导环境准备、模型放置、凭证检查、Compose 解析、部署、就绪验证和故障排查。它也支持清理现有部署、检查远程模型端点以及修复解析配置中的可选依赖。该技能不负责独立微服务部署，硬件规格和各配置文件的最低 GPU 要求由对应参考文件决定。
自动检测 video-search-and-summarization 仓库路径，读取 GPU、Docker 和网络环境信息，检查凭证与远程模型端点；将配置文件中的 .env 复制为 generated.env，写入部署覆盖项，并运行 docker compose config 生成 resolved.yml；调用 normalize_resolved_yml.py 清理已过滤服务的可选 depends_on；根据实际配置检查 NGC 镜像和模型资源访问权限；启动 Compose 服务并检查容器数量、健康端点、Agent API、UI 以及 LLM/VLM 端点；在部署失败时使用通用和配置文件专属排查流程。
- VSS 用户希望在具备 NVIDIA GPU、Docker 和 NVIDIA Container Toolkit 的主机上部署基础视频搜索与摘要配置。
- 运维人员需要部署 search、lvs、alerts 或 warehouse 配置，并根据主机硬件选择合适的模型放置方式。
- 团队需要在 DGX Spark、AGX Thor 或 IGX Thor 上按照 edge 配方部署 VSS。
- 工程师需要验证部署是否真正可用，而不只是确认容器处于运行状态。
- 运维人员需要排查远程 LLM/VLM 端点、NGC 权限、Compose 变量或服务就绪问题。
这个 Skill 有哪些优点和局限？
- 覆盖从环境检查、凭证验证到部署后就绪检查的完整 Compose 部署流程。
- 明确区分 base、alerts、lvs、search、warehouse 和 edge 配置文件。
- 包含远程模型探测、NGC 工件权限检查和 dangling depends_on 清理流程。
- 对 .env 与每次部署使用的 generated.env 进行分离，降低误改默认配置的风险。
- 必须使用 NVIDIA GPU、驱动、Docker 和 NVIDIA Container Toolkit，并依赖 VSS 源代码仓库。
- 需要访问相应的 NGC 工件或有效的远程模型端点；缺少凭证或权限时无法继续。
- 该技能只面向基于 Compose 的 VSS 配置文件，不覆盖独立微服务部署。
- 提供的材料没有展示测试套件或各硬件平台的实际测试结果；具体硬件规格依赖未提供的配置文件参考资料。
如何安装这个 Skill？
使用仓库 README 中记录的 skills CLI 安装指定技能：
npx skills add nvidia/skills --skill vss-deploy-profile --yes
也可以针对 Codex 安装：
npx skills add nvidia/skills --skill vss-deploy-profile --agent codex --yes
README 未提供该单个技能的手动复制路径；该仓库整体通过 CLI 安装。
如何使用这个 Skill？
安装后，让兼容的 Agent 处理明确请求，例如："deploy vss"、"deploy search"、"debug warehouse" 或 "verify the deploy"。技能随后要求先检测 VSS 仓库路径、硬件、凭证和网络地址，再复制 .env 为 generated.env，应用覆盖项，运行 docker compose --env-file generated.env config > resolved.yml，检查并标准化 resolved.yml，最后在获得确认后启动服务。若用户没有明确要求远程模型，技能不会仅因环境变量存在就自动选择远程端点。