Holoscan Sensor Bridge 演示搭建

要解决什么问题

Holoscan Sensor Bridge（HSB）的 demo 不是「一条脚本跑完」：不同开发套件（IGX Orin iGPU/dGPU、AGX Orin、AGX Thor、DGX Spark）对应不同的主机配置与 docker/build.sh 构建参数，还要确认传感器桥接、网络、OS 版本，并在容器里跑通后与板卡（常见 192.168.0.2）和 FPGA 版本对齐。手工翻 docs/user_guide、漏配 SSH 或烧录版本不匹配时，排查成本很高。

技能如何工作

通过 /hsb-setup [平台] [选项] 在用户显式调用后按阶段推进；工作流有副作用，不会自动执行。开始前强制三门控：解析并校验 SSH_TARGET、REMOTE_ROOT 等环境变量；展示完整阶段计划并等待确认；在任何远程操作前做 Token 预算预检（完整搭建约 280k tokens，AGX Thor 约 340k，复杂场景再加预算），不足则停止。

核心步骤包括：确认硬件与接线就绪 → 必要时 SSH 到开发套件 → 用 /sys/class/dmi/id/product_name 与 HSB_PLATFORM 协调平台 → 克隆/刷新 nvidia-holoscan/holoscan-sensor-bridge（可用 HSB_REPO 或 --repo 覆盖）→ 按用户指南配置主机并映射到 --igpu / --dgpu 构建 → 构建并运行 demo 容器 → 验证板卡连通与寄存器 0x80 的 FPGA 版本；不匹配时指向 hsb-flash 烧录。每阶段结束后摘要结果并询问是否继续；失败时给出命令、可能原因与安全修复尝试，并可导出问题报告为 Markdown。

适用边界与注意点

• 仅用于「端到端搭建 HSB 演示环境」，不是日常开发或生产部署的通用运维技能。
• Thor 与非 Thor 平台的阶段略有差异（文档中非 Thor 可跳过部分阶段）。
• 若板卡 IP 不是 192.168.0.2，技能会提示你自行核对地址。
• 自定义 SSH 仓库需自行配置密钥；无法验证订阅用量时，预检会要求你选择「停止」或提供剩余配额后再继续。