VIOS 视频输入输出与存储管理
通过 VIOS REST API 管理传感器、视频流、录制、快照和视频存储。
文档披露了API边界、凭据变量、令牌不应输出、健康检查、失败时停止或征求选择，以及删除文件与RTSP传感器的不同清理路径；但部署涉及Docker命令和Docker socket，删除及部署确认边界不够系统，权限隔离、回滚方案和敏感数据流说明不完整，因此扣分。
核心流程包含健康探测、ID和时间线解析、已知错误处理及直接二进制端点；但端点解析、部署模式和多个参考契约存在复杂依赖，未见可执行CI或覆盖关键路径的实际测试结果，静态评估不超过10分，因此扣分。
用途、触发场景和不适用的VLM、搜索、摘要、分析任务定义清楚；但输入输出契约、非适用环境、中文交互和网络可达性未充分说明，且依赖预部署或本地部署环境，因此扣分。
具备目的、前置条件、分层参考文档、版本3.2.0、Apache-2.0许可证和故障排查；但BENCHMARK指出缺少metadata.author，未见明确维护责任、变更日志、稳定参数策略和更新流程，深层参考也增加使用成本，因此扣分。
技能覆盖传感器、流、上传、时间线、快照和剪辑等直接操作，示例和评估任务表明核心目标可由API流程完成；但没有静态可核验的代表性实际输出，部署成本和环境前提较高，结果仍需用户验证，因此按静态上限保守扣分。
提供了详细REST契约、错误码、评估脚本式检查和一份基准报告，关键声明具有一定可审计性；但未提供CI运行记录、真实输出或独立交叉证据，基准结论本身无法在静态阅读中独立复现，因此扣分。
- 部署路径可执行Docker和相关主机操作，并在部分模式下挂载Docker socket；使用前应明确授权、最小化权限并准备可恢复的回滚方案。
- 上传、注册、删除传感器或文件会产生外部状态变化；文档未定义统一的逐操作确认和清理确认流程。
- 技能依赖本地VSS/VIOS、Docker、curl、jq、NGC凭据及GPU/存储配置；未证明在中国大陆网络和中文交互环境中的可达性与适配性。
- 评估报告和检查清单不是本次静态审查中的独立执行证明。
这个 Skill 能做什么，适合哪些场景？
该技能面向 NVIDIA Video Search and Summarization 部署中的 VIOS 与 NvStreamer 运维操作。它可管理摄像头和传感器、RTSP 流、录制时间线、视频上传、快照与片段提取。技能要求 VSS 部署中的 VIOS 已可访问，并通过 curl 调用 REST API。它明确不负责 VLM 推理、视频语义搜索或视频摘要。
检查 VST/VIOS 健康状态；列出、查询、添加和删除传感器及流；查看流状态和录制时间线；上传或删除视频文件；获取实时或历史快照；下载视频片段；在明确需要合成 RTSP 流时调用 NvStreamer；根据传感器名称或 IP 自动解析 sensorId 和 streamId。操作结果可以是 JSON、布尔值、空值或下载到本地的二进制文件。
- VSS 运维人员需要列出当前摄像头并检查其视频流状态。
- 集成测试人员需要上传 MP4 文件并获得 VIOS 生成的流标识。
- 视频分析人员需要根据传感器和录制时间线下载短视频片段。
- 值班人员需要获取实时流或历史录制的快照。
- 测试人员需要通过 NvStreamer 将本地样例视频作为合成 RTSP 摄像头提供给 VIOS。
这个 Skill 有哪些优点和局限？
- 覆盖传感器、流、录制、存储、快照和片段提取等完整 VIOS 操作面。
- 包含 VIOS、NvStreamer、集成和部署相关的参考契约。
- 对普通 VIOS 文件上传与 NvStreamer 合成 RTSP 流进行了明确区分。
- 提供健康检查、时间线解析、认证重试和常见故障处理规则。
- 依赖已部署且可访问的 VIOS/VST 后端；技能本身不是完整部署工具。
- 需要 shell、网络、curl、jq 和 Docker；某些镜像拉取场景还需要 NGC 凭据。
- 上传可能因容器缺少 libav 而失败，部署还可能受到遗留容器或卷漂移影响。
- 3.2.0 中部分 /url 响应存在重复 http:// 缺陷；来源未提供独立的测试套件或平台支持矩阵。
如何安装这个 Skill？
使用 NVIDIA 技能目录的 CLI 安装指定技能：npx skills add nvidia/skills --skill vss-manage-video-io-storage --yes。也可以指定目标客户端，例如：npx skills add nvidia/skills --skill vss-manage-video-io-storage --agent codex。README 未规定该技能在特定客户端中的额外安装步骤。
如何使用这个 Skill？
在已加载技能的 Agent 中提出具体请求，例如“列出活动的 VIOS 传感器并显示流状态”或“上传这个样例视频到 VIOS 并返回生成的 stream id”。使用前必须提供可用的 VST endpoint，且 VIOS 必须已运行；Agent 会先调用 sensor/version 健康检查，再使用 VIOS REST API。若需要上传普通 MP4，使用 VIOS 文件上传接口；只有明确要求 NvStreamer、合成 RTSP 或获取 RTSP URL 时才使用 NvStreamer。未提供时间范围时，Agent 应先读取时间线，不能自行编造时间戳。
这个 Skill 与同类方案有什么区别？
与 vss-ask-video、vss-search-archive 和 vss-summarize-video 不同，本技能专注于 VIOS 输入输出和存储操作，不执行 VLM 问答、语义搜索或视频叙事摘要。与直接使用 NvStreamer 相比，它还负责 VIOS 传感器、录制和存储管理；NvStreamer 仅在合成 RTSP 流等明确场景下使用。