hsb-setup

用途：端到端搭建 NVIDIA Holoscan Sensor Bridge（HSB）演示环境，仅在被用户显式调用时运行，禁止自动执行。调用方式为 /hsb-setup [PLATFORM] [OPTIONS]。\n\n主要能力与阶段：Phase 0 令牌预算预检（在任何 SSH、克隆、构建前运行，预算不足或无法验证即停止）；Phase 1 确认平台、建立 SSH、克隆或刷新仓库、研读 docs/user_guide；Phase 2 主机前置检查与网络配置；Phase 3 原生 CLI 构建（仅 AGX Thor）；Phase 4 构建并运行演示容器，ping 192.168.0.2，读寄存器 0x80 校验 FPGA 版本；Phase 5 问题报告（可导出 md）；Phase 6 停止应用、退出容器并交还控制权。\n\n平台与构建映射：IGX Orin dGPU 用 sh docker/build.sh --dgpu；IGX Orin iGPU、AGX Orin、AGX Thor、DGX Spark 用 sh docker/build.sh --igpu。可通过读取 /sys/class/dmi/id/product_name 自动识别平台并与 HSB_PLATFORM 对账。\n\n环境变量：SSH_TARGET、REMOTE_ROOT 为必填；REMOTE_SUDO、REMOTE_SSH_OPTS、HSB_PLATFORM、HSB_REPO 可选，默认仓库 https://github.com/nvidia-holoscan/holoscan-sensor-bridge.git。选项：--help/-h 显示帮助；--verbose 显示完整原始输出；--y 自动通过阶段确认（无法绕过 Phase 0 预检）。辅助脚本 scripts/hsb_phase_runner.sh，参考文档 references/phase-details.md、docs/platform-mapping.md、docs/failure-playbook.md。\n\n限制：具有副作用，需用户逐阶段确认；FPGA 版本不匹配时建议使用 hsb-flash-skill 刷写；具体价格、收费与性能数据资料未提供。