| name | external-cannbot-ops-ascendc-env-check |
| description | Ascend C 算子开发环境检查技能。用于：(1) 通过 npu-smi 查询 NPU 设备信息（设备列表、状态、资源使用），(2) 检查 CANN 环境配置（CANN Toolkit、Ops、自定义算子包），(3) 验证开发依赖是否完整。触发关键词：环境检查、NPU设备、npu-smi、CANN安装、设备查询、资源监控、检查CANN环境变量。 |
| original-name | ascendc-env-check |
| synced-from | https://gitcode.com/cann/cannbot-skills |
| synced-date | 2026-05-26 |
| synced-commit | ac5bbd2b4cf427d011874e11f8d1e8b1bef66eda |
| license | UNKNOWN |
Ascend C 环境检查
快速检查开发环境配置和 NPU 设备状态。
工作流程
环境检查
│
├─ NPU 设备检查
│ └─ npu-smi list / scripts/npu_info.sh
│
└─ CANN 环境检查
└─ scripts/check_env.sh
NPU 设备检查
快速命令
npu-smi info
npu-smi top
脚本工具
bash scripts/npu_info.sh
详细命令参数见 npu_commands.md，npu-smi 不可用时的回退方案见 asys_commands.md
CANN 环境检查
bash scripts/check_env.sh
检查项
| 检查项 | 说明 | 必需 |
|---|
| ASCEND_HOME_PATH | CANN Toolkit 路径 | 是 |
| CANN 版本 | 检测版本号及运行时依赖基线 | 建议确认 |
| ASCEND_OPP_PATH | CANN Ops 路径 | 运行时必需 |
| 自定义算子包 | op_api 库 | 运行自定义算子必需 |
| CANN 工具 | msprof/cannsim | 可选 |
⚠️ 注意：官方环境变量为 ASCEND_HOME_PATH，不是 ASCEND_HOME。部分旧文档或示例代码可能使用 ASCEND_HOME，这是错误用法。
详细环境配置见 env_config_guide.md，版本配套关系见其中「CANN 版本兼容性」章节
诊断脚本
| 脚本 | 用途 |
|---|
scripts/npu_info.sh | NPU 设备信息综合查询 |
scripts/check_env.sh | CANN 环境配置检查 |
常见问题
- NPU 不可见：检查
npu-smi list 是否能识别设备
- 算子运行失败：优先运行
check_env.sh 检查环境配置
- 确认是否有进程占用 NPU：使用
npu-smi info -t usages -i <device_id> 查看运行中的进程；注意空闲设备仍会有少量 HBM 被驱动占用（正常现象），不应误判为设备被占用
详细排查见 troubleshooting.md
