Holoscan Sensor Bridge 演示环境部署
为 NVIDIA devkit 构建并验证 Holoscan Sensor Bridge 演示环境。
技能要求显式调用、阶段确认、环境变量展示和部分失败恢复,且声明了副作用;但要求为所有人类用户加入 docker 组、复制 NGC 凭据、批量配置 X11 权限,并在失败时可退回 xhost +,权限范围明显超出单一用户的最小权限,且凭据流转和回滚不充分。因此扣除大部分分数,并因存在未解决的过度权限红线而阻断。
阶段流程、平台映射、失败剧本、重启重连和容器清理说明较完整;但依赖未提供的用户指南、外部仓库最新 main、Claude 账户用量机制和未定义的 run_script,且静态审查无法复现关键路径。按静态上限扣分,不能证明异常情况下始终可控。
目标用户、支持平台、触发方式、平台选择和部分非适用边界较清楚;但主要面向英文交互,未说明中文支持,依赖 GitHub、NGC、Docker、SSH 和可能的海外网络,缺少中国大陆网络可达性方案。
技能有名称、描述、作者、版本、标签、许可证、阶段结构、帮助文本、失败手册和辅助脚本;但缺少明确 changelog、维护责任与更新流程,引用文件不完整,BENCHMARK 还显示缺少 Examples 推荐段落,且仓库许可证元数据为 NOASSERTION。
工作流覆盖克隆、主机配置、构建、容器启动、连通性和 FPGA 版本检查,理论上可完成核心 bring-up;但依赖硬件、远程权限、外部仓库和容器镜像,关键输出没有静态可验证的代表性结果,且高成本和高权限使收益与风险不完全成比例。
提供了固定修订中的源文件、脚本、平台映射、失败案例和一份静态 benchmark;但 benchmark 仅有一个任务,缺少提交的测试套件、真实 CI 覆盖和多源交叉验证,无法静态证明关键路径。
- 存在未解决的高风险权限扩大:将所有人类用户加入 docker 组并复制 NGC 凭据,可能扩大主机和私有镜像访问范围。
- xhost + 和批量 X11 授权可能削弱图形会话隔离;不应作为默认故障处理。
- 技能要求检查 Claude Code 账户用量,但目标环境可能是 Codex,无法证明该检查可执行;预算不可验证时应停止。
- 默认克隆最新 main,未锁定依赖提交或镜像版本,可能导致不可重复构建。
- 核心操作依赖 GitHub、NGC、Docker、SSH 和硬件;未提供中国大陆网络受限时的替代方案。
这个 Skill 能做什么,适合哪些场景?
该技能面向 Holoscan Sensor Bridge 演示环境的一站式 bring-up,覆盖远程 devkit 连接、平台识别、仓库同步、主机配置、容器构建与启动。它支持 IGX Orin、AGX Orin、AGX Thor 和 DGX Spark,并根据平台选择 iGPU 或 dGPU 构建模式。工作流会通过 SSH 和 shell 命令检查环境,构建 demo 容器,并通过 ping 192.168.0.2 验证传感器桥接连通性。技能版本为 1.0.0,由 Holoscan Team 发布,技能许可证为 Apache-2.0。
读取 SSH_TARGET、REMOTE_ROOT、REMOTE_SUDO、REMOTE_SSH_OPTS、HSB_PLATFORM 和 HSB_REPO 等环境变量;在继续操作前执行令牌预算预检并展示分阶段计划;通过 /sys/class/dmi/id/product_name 检测 devkit 平台并协调 HSB_PLATFORM;从默认或自定义 Git 仓库克隆或刷新最新 main 分支;研究 docs/user_guide 中的主机、容器、应用和 FPGA 配置说明;按平台运行 docker/build.sh 的 --igpu 或 --dgpu 模式;运行 demo 容器;ping 192.168.0.2 并验证 FPGA 版本寄存器 0x80;记录问题、提供修复建议,并可将最终报告导出为 Markdown 文件;结束时停止应用并退出容器。
- 使用外部计算机通过 SSH 为 NVIDIA devkit 首次搭建 Holoscan Sensor Bridge 演示环境的工程师。
- 使用 IGX Orin 且需要区分 iGPU 或 dGPU 配置后构建对应 demo 容器的开发者。
- 使用 AGX Orin、AGX Thor 或 DGX Spark 验证传感器桥接板网络连通性的开发者。
- 需要检查传感器 FPGA 版本是否与 devkit 上的 HSB 主机软件匹配的测试或集成工程师。
这个 Skill 有哪些优点和局限?
- 覆盖从平台识别到容器启动和连通性验证的完整流程。
- 支持多种 NVIDIA devkit,并提供 IGX Orin iGPU/dGPU 构建映射。
- 包含阶段确认、失败摘要、问题报告和可选 Markdown 导出。
- 明确要求用户显式调用,降低意外修改 devkit 的风险。
- 需要远程目标和工作目录等环境变量,且依赖 SSH、sudo、Docker、Git 和网络连接。
- 会执行主机配置、容器构建及其他具有副作用的操作。
- 令牌预算无法验证或不足时会在 Phase 1 前停止。
- 提供的材料没有展示自动化测试结果,也没有证明所有支持平台均已实际验证。
如何安装这个 Skill?
从 NVIDIA/skills 仓库安装技能集合:npx skills add nvidia/skills --skill hsb-setup --agent codex。也可将 skills/hsb-setup/ 目录安装到兼容 Agent Skills 的技能目录中。README 未规定该目录在每个客户端中的具体目标路径。
如何使用这个 Skill?
明确调用 /hsb-setup [PLATFORM] [OPTIONS],例如 /hsb-setup AGX Thor。开始前必须提供 SSH_TARGET 和 REMOTE_ROOT;技能会要求确认硬件、供电、网络和权限,并执行令牌预算预检。可使用 --verbose、--repo <URL> 或 --y;--y 不能绕过预算预检。该工作流具有副作用,不会自动运行。