用途:在 HSB 板卡与开发套件上执行 QA 测试计划。该技能读取用户提供的测试文档(本地文件或网页链接),按用户的具体硬件配置过滤可自动运行的测试,逐项执行并做通过/失败评估,最终生成结果报告。
主要能力:验证开发套件 SSH 连通、板卡连通与演示容器可用,读取 FPGA 版本与板卡身份,识别传感器/相机、HSB 开发套件类型与 release 仓库;从测试文档与仓库 examples/ 目录判断哪些测试可自动运行,跳过人工测试与需要额外设备的测试;逐项执行测试、记录结果,失败时分析日志并给出修复建议;生成包含逐项状态、问题与修复的结构化报告并可选择保存;最后清理容器、临时文件与会话状态。
使用方式:以 /hsb-test 调用,可加参数 --help、--verbose、--y、--timeout N、--full。需先设置环境变量 SSH_TARGET、REMOTE_ROOT(两者必填)、REMOTE_SUDO、REMOTE_SSH_OPTS、HSB_PLATFORM。流程分四个阶段:Phase 0 验证连通与配置,Phase 1 获取测试文档并生成可执行测试清单,Phase 2 执行与判定,Phase 3 生成报告,Phase 4 自动清理。同一会话已验证时跳过 Phase 0 与 Phase 1 的配置确认;--full 可强制从 Phase 0 重新验证;--timeout 设置单项测试秒数(默认 120 秒,有效范围 5–3600);--y 跳过阶段确认但官方不建议用于 QA,且仍须在 Phase 1 提供测试计划。
限制:假定开发套件已完成 SSH、演示容器构建、主机配置与板卡连接等设置,未完成时会建议先执行 /hsb-setup;测试应用在演示容器内运行,仅应在用户显式调用时执行;需用户提供测试文档路径或 URL,否则不予开始;仅覆盖测试计划中可自动化的部分。