HSB 应用运行器

要解决什么问题

在 NVIDIA Holoscan Sensor Bridge（HSB）开发流程里，板卡已接上、演示容器也建好了，但 examples/ 里示例很多，平台、板卡类型（如 Lattice）和传感器（双 IMX274、VB1940 等）一组合，很容易选错应用或在错误环境里跑。手动 SSH、docker run、看日志、失败后改配置再试，步骤长且容易漏掉「板卡是否在线、FPGA 版本是否匹配」这类前置检查。

技能如何工作

/hsb-app 把「验证 → 发现配置 → 选应用 → 容器内运行 → 报告」拆成 阶段 0～3，并在动手前做三道门控：检查 SSH_TARGET、REMOTE_ROOT 等环境变量；向用户展示阶段计划并确认；若会话里已有 _SESSION_VERIFIED=true 则走快速路径，跳过重复的连接验证。

核心能力包括：

• 连接与容器就绪：SSH 可达、HSB 响应、演示容器可用，并读取 FPGA 版本与板卡标识。
• 按设置筛应用：结合仓库位置、HSB 版本、板卡与传感器，扫描用户指南与 examples/，列出兼容应用供选择；--headless 仅在用户明确要求时加入。
• 容器内执行与调试：在演示容器里以命名容器方式运行所选示例；支持 --timeout N 看门狗或交互式长跑；失败时归纳命令、可能根因与是否阻塞，而不是整段丢日志。
• 会话报告：汇总问题、修复与结果，可选保存；同一会话后续运行可跳过阶段 0/1 的发现，直接再选应用。

环境变量与 hsb-setup、hsb-flash 一致（如 REMOTE_SUDO、REMOTE_SSH_OPTS、可选 HSB_PLATFORM）。支持 --verbose、--y（自动批准，不推荐日常）、--full 强制从头验证。

适用边界

技能假设开发套件已完成 /hsb-setup（SSH、演示容器、主机与板卡连接）。未完成时应先跑 setup。应用只在用户显式调用时、在演示容器内运行；连接丢失或用户要求「重新验证」时会清除会话状态并重新跑阶段 0。