board-detection

板卡硬件平台检测

执行方式

本 Skill 应通过 subagent 执行。 主 agent 在前置检查中发现 .env.board 缺失或不完整时，应将本文件的完整内容作为 subagent prompt 派发执行。subagent 完成后汇报写入结果和需要用户确认的事项（如有），主 agent 读取 .env.board 继续后续流程。

目标

检测用户的板卡硬件平台信息，写入 .horizon/.env.board，供后续所有板端任务直接使用。

板卡检查规则

• 板卡类型按三类处理：nash-e/m（Linux）、nash-p（Linux）与 nash-b（QNX）
• 优先从环境变量中查找板卡信息，例如 HORIZON_BOARD_TYPE、OE_BOARD_TYPE、BOARD_TYPE、BOARD、NASH_BOARD
• 如果环境变量没有提供，再检查项目内相关配置文件，例如 .env、.env.local、.horizon/board.env、.horizon/board.json、AGENTS.md、CLAUDE.md
• 如果任务涉及板端运行、板端推理、远端 HBM、性能压测或 BPU 实测，但没有找到板卡信息，必须先向用户确认是否有可用板卡
• 如果用户明确没有可用板卡，涉及板端的任务应回退到 X86 评测、仿真、静态检查或可离线执行的分析工具，并说明该结果不能替代真实板端验证
• nash-b 板卡为可选项：用户可以跳过 nash-b 配置，但系统必须给出明确提示："已跳过 nash-b 板卡配置。后续涉及 nash-b 板端的任务将不可用，仅可在 X86 环境进行编译和离线分析。如需启用，请删除 .horizon/.env.board 重新执行板卡检测。"
• 板卡工作目录（BOARD_WORKDIR）也是 .env.board 完整性的必要字段。如果文件中缺少该字段，需要重新执行工作目录检测（步骤 3.5）

检测流程

1. 检查 .horizon/.env.board 是否存在

   • 文件存在且内容完整（包含 BOARD_TYPE、BOARD_IP、BPU_ARCH、BOARD_WORKDIR 等字段）→ 直接读取，跳过后续步骤
   • 文件不存在或不完整（含缺少 BOARD_WORKDIR）→ 进入步骤 2

2. 获取板卡 IP

   • 先读取项目根目录 .env 文件，查找 BOARD_IP、BOARD_IP_NASH_P、BOARD_IP_NASH_B 等字段
   • 如果 .env 中有板卡 IP → 进入步骤 3
   • 如果 .env 中没有 → 询问用户是否有可用板卡 IP
     • 用户提供了 IP → 进入步骤 3
     • 用户明确表示没有可用板卡 → 跳过本阶段，说明"当前任务将回退到 X86 评测或仿真模式，结果不能替代真实板端验证"

3. 自动检测板卡架构

   • 使用 SSH 连接板卡（默认用户名 root），执行：

     uname -a
     hrut_somstatus
     

   • 从输出中自动解析架构、内核版本、镜像日期、BPU 状态等信息
   • 根据 .env 中 IP 与变量的对应关系自动判断板卡类型：
     • BOARD_IP / 无后缀 → nash-e/m（Linux 平台）
     • BOARD_IP_NASH_P / _NASH_P 后缀 → nash-p（Linux 平台）
     • BOARD_IP_NASH_B / _NASH_B 后缀 → nash-b（QNX 平台，uname -a 输出含 QNX）
   • nash-b (QNX) 特殊说明：nash-b 运行 QNX 实时操作系统，SSH 连接后 uname -a 的输出格式与 Linux 不同（系统名为 QNX，无发行版信息）。hrut_somstatus 命令仍可用。如果 SSH 连接或命令执行失败，可能是 QNX 板卡的 SSH 服务配置不同，需要向用户确认
   • 全程不需要用户手动确认架构信息，全部自动推断
   • 跳过选项：对于每种板卡类型，用户都可以选择跳过。跳过时给出明确提示：

     ⚠️ 已跳过 [板卡类型] 的配置。后续涉及该板卡的板端任务将不可用。如需启用，请删除 .horizon/.env.board 重新执行板卡检测。