oe-package-detection

OE 包环境检测

执行方式

本 Skill 应通过 subagent 执行。 主 agent 在前置检查中发现 .env.oe-package 缺失或不完整时，应将本文件的完整内容作为 subagent prompt 派发执行。subagent 完成后汇报写入结果（OE 路径、版本、执行模式），主 agent 读取 .env.oe-package 继续后续流程。

目标

检测 OE 包路径、版本及本地环境匹配情况，写入 .horizon/.env.oe-package，供后续所有工具链任务直接使用。

触发条件

任何涉及量化、编译、部署、板端推理、性能/精度评估的任务进入 horizon-router 前，如果 .horizon/.env.oe-package 不存在，顶层 Skill 会中断任务并提示用户：

未检测到 OE 包环境配置（.horizon/.env.oe-package）。请提供 OE 包路径，或回复"跳过"暂不配置。

• 用户提供路径 → 进入本检测流程
• 用户回复"跳过" → 记录跳过（仅当次对话有效，下次仍会提示），继续后续任务

检测流程

1. 检查 .horizon/.env.oe-package 是否存在

• 文件存在且内容完整（包含 OE_DIR、OE_VERSION、EXECUTION_MODE 等字段）→ 直接读取，跳过后续步骤
• 文件不存在或不完整 → 进入步骤 2

2. 定位 OE 包路径

按优先级查找：

1. 环境变量：OE_DIR、OPEN_EXPLORER_DIR、HORIZON_OE_DIR
2. 项目配置文件：.env、.horizon/oe.env、CLAUDE.md 中声明的路径
3. 常见路径探测：/open_explorer、~/open_explorer、/opt/openexplorer
4. 以上都没有 → 询问用户 OE 包路径

找到路径后，验证目录中存在 OE 包的标志性文件（如 run_docker.sh、samples/、docs/、toolchain/ 等至少两个），否则提示用户确认路径是否正确。

3. 采集 OE 版本信息

从 OE 包目录中提取以下信息：

OE 包整体版本：

• 检查 version.txt、VERSION、release_notes.md 或 release_notes.txt
• 从文件名推断（如 OpenExplorer_v3.9.0_rc4）
• 以上都无法确定时询问用户

各组件版本（通过 pip show 检查已安装版本，同时记录 OE 包内 whl 文件名中的版本）：

组件	pip 包名	说明
horizon_tc_ui	horizon-tc-ui	模型集成工具
hmct	hmct	模型转换/量化工具
horizon_plugin_pytorch	horizon-plugin-pytorch	PyTorch 量化插件（QAT）
hbdk4_compiler	hbdk4-compiler	编译器

Docker 信息：

• 检查 run_docker.sh 是否存在
• 从 run_docker.sh 内容或 OE 版本推断 Docker 镜像名称：
  • CPU：openexplorer/ai_toolchain_ubuntu_22_j6_cpu:{version}
  • GPU：openexplorer/ai_toolchain_ubuntu_22_j6_gpu:{version}

4. 本地环境匹配检查

在当前环境中逐项检测：

1. Python 版本：python3 --version，要求 >= 3.8
2. pip 组件：对每个组件执行 pip show <包名>，记录：
   • 是否安装
   • 版本号是否与 OE 包声明一致
3. CLI 工具可用性：检查以下命令是否可执行：
   • hb_compile --version（或 which hb_compile）
   • hb_model_info --version（或 which hb_model_info）
   • hmct-debugger --version（或 which hmct-debugger）