VSS 视频自动标定
通过 AutoMagicCalib 为本地视频、RTSP 摄像头或示例数据集执行端到端视频标定。
文档包含凭据不回显、NGC/HuggingFace令牌处理、校验后再部署、校准前确认、受限ACL和停止服务说明，降低了越权与泄露风险。扣分原因是部署会执行Docker拉取和启动、可能修改主机权限，缺少统一的部署前明确确认与完整回滚说明；RTSP示例还将ssl_verify设为false，且未充分说明RTSP凭据的数据流和敏感信息处理。
路由、前置探测、状态轮询、超时、错误日志和失败排查较完整，静态上主流程可信。扣分原因是依赖大量外部服务、环境变量、容器和未随提示提供的参考文件，部分脚本在异常HTTP响应、配置解析和环境差异下的诊断仍有限；按静态校准上限不超过10。
输入模式、触发词、必需文件、非适用范围和部署/校准边界写得清楚。扣分原因是没有中文语言支持说明，且核心部署依赖NVIDIA NGC、Docker镜像和可达的主机网络；样例下载还依赖GitHub或其他海外服务，对中国大陆网络可达性没有替代方案。
文档有目的、路由表、渐进式参考、示例、限制、故障排查、版本号和Apache-2.0许可证，并标明NVIDIA相关仓库来源。扣分原因是作者字段缺失，缺少明确维护责任人、变更日志和正式更新路径；部分关键假设分散在引用文件中。
技能覆盖部署、MP4、RTSP和样例校准，并输出项目ID、指标、日志和覆盖图位置，具备实际工作流价值。扣分原因是效果依赖GPU、容器、服务、权限和外部模型/镜像，且基准报告显示总体effectiveness仅33%；静态阅读无法确认结果是否可直接使用，因此按上限保守给分。
提供了版本、仓库指针、API端点、成功条件、评测清单和一份基准报告，具备一定审计线索。扣分原因是没有可由本提示独立核验的CI、完整测试套件或多源第三方复现实证；基准材料主要是项目自带报告，静态评估不授予超过5分。
- 执行部署会拉取外部镜像、启动容器，并可能通过setfacl修改主机权限；应在实际操作前再次确认目标主机、配置文件和回滚方案。
- RTSP示例使用ssl_verify=false，并可能在请求中携带含用户名密码的URL；不要把真实凭据写入日志、命令历史或共享输出。
- NGC、GitHub、Hugging Face和Astral uv等外部依赖的网络可达性及许可证/配额需要单独确认，尤其是在中国大陆网络环境中。
- 基准报告显示effectiveness为33%，且本次未执行任何流程；结果质量仍需人工检查覆盖图、日志和项目文件。
这个 Skill 能做什么，适合哪些场景？
这是 NVIDIA Video Search and Summarization Blueprint 的视频标定技能，使用 AutoMagicCalib 处理本地 MP4、RTSP 流或内置示例数据集。它可以在需要时部署 vss-auto-calibration 微服务，并通过 REST API 创建项目、验证输入、启动标定、轮询状态和获取结果。技能还支持可选的 VGGT 精炼、地面真值评估以及 MV3DT 格式导出。使用前必须具备匹配的 VSS 配置、可访问的微服务、可写的项目目录以及 Python requests。
根据请求选择部署、本地视频、RTSP 或示例数据集流程；必要时部署 AMC 微服务。它读取视频文件、RTSP 地址、可选的 JSON 标定设置、布局与对齐文件以及可选的 GT.zip，通过 AMC REST API 创建和验证项目、上传或摄取视频、启动标定并每 10 秒查询状态。完成后获取项目状态、评估统计、PNG 覆盖图和日志，并可在 VGGT 就绪时执行精炼。技能返回 project_id，供下游请求 AMC 或 VGGT 的 MV3DT ZIP 输出。
- 需要为本地 cam_00.mp4、cam_01.mp4 等连续命名的视频执行多摄像头标定的 VSS 用户。
- 需要从实时摄像头 RTSP 地址采集并标定视频的部署人员。
- 需要验证 AMC 安装或测试 VSS 标定栈内置示例数据集的用户。
- 需要先启动 AMC 微服务，再对视频执行标定的运维人员。
这个 Skill 有哪些优点和局限？
- 覆盖本地 MP4、RTSP 和示例数据集三种输入模式。
- 包含部署、上传或摄取、验证、标定、轮询、结果查看和故障排查流程。
- 支持 resnet 与 transformer detector、GT 评估、VGGT 精炼和 MV3DT 导出。
- 明确处理连接拒绝、NGC 认证、GPU 内存不足、上传超时等常见问题。
- 依赖匹配的 VSS profile、AMC 微服务、可写项目目录和可用网络。
- 标定通常需要 10–60 分钟；示例数据集通常需要 10–30 分钟。
- NGC 模型和 NIM 可能受速率限制、GPU 内存要求及许可证限制。
- 源材料未明确列出受支持的主机平台或完整硬件矩阵。
如何安装这个 Skill？
使用 NVIDIA/skills 的 skills CLI 安装指定技能：
npx skills add nvidia/skills --skill vss-generate-video-calibration --yes
README 说明 CLI 会通过 npx 运行，并提示选择安装目标；不需要手动克隆仓库或复制技能目录。
如何使用这个 Skill？
向兼容的 Agent 请求，例如：“calibrate my videos”或“calibrate RTSP streams”。若要部署服务，可说：“launch AMC”。技能会按输入模式执行相应流程；组合请求会先部署再标定。完成输入准备后，它会验证项目为 READY，确认 detector 和标定设置，调用 /v1/calibrate/<project_id>，轮询至 COMPLETED，并提供 UI、覆盖图、项目文件和日志位置。没有设置、布局或对齐文件时，需要按提示在 AMC UI 中保存相应内容。
这个 Skill 与同类方案有什么区别？
可选的 UI 驱动流程是文档中明确提到的替代方式：当设置、布局或对齐文件缺失时，可在 AMC UI 中完成这些步骤后继续 API 标定。