external-gitcode-ascend-atb-nnal-installer

name	external-gitcode-ascend-atb-nnal-installer
description	昇腾 NPU NNAL（ATB 加速库）安装技能。依赖 cann-operator-env-config 提供 Toolkit+Kernels 环境，本技能仅负责 NNAL 包的安装、环境变量配置与验证。
keywords	["cann","nnal","atb","installer","昇腾","ascend","加速库"]
metadata	{"author":"ascend-transformer-boost-team + Claude Code + opus4.7","version":"2.1.0","created":"2026-04-17","updated":"2026-04-28","skill-type":"env-setup"}
hooks	{"PreToolUse":[{"matcher":"Write|Edit|Bash","hooks":"[Truncated]"}]}
original-name	atb-nnal-installer
synced-from	https://gitcode.com/Ascend/agent-skills
synced-date	2026-05-26
synced-commit	1f7666e7768a0ceb21bb1d40ce4b5179fcb6f1d6
license	UNKNOWN

CANN NNAL 安装部署

功能概述

在昇腾 NPU 环境中安装 NNAL（ATB 加速库）。本技能假设 Toolkit+Kernels 已由 cann-operator-env-config 技能安装完毕。

调用时机

• 用户已完成 Toolkit+Kernels 安装（通过 cann-operator-env-config），需要安装 NNAL
• 用户在 Docker 容器中需要安装 NNAL
• 用户需要安装或升级特定版本的 NNAL

前置条件

必须已执行 cann-operator-env-config 技能，确保：

• Toolkit 已安装，/usr/local/Ascend/ascend-toolkit/set_env.sh 存在
• Kernels（ops）已安装

⚠️ 路径约束（必须执行）

执行此技能前，必须从用户处获取以下路径：

• <INSTALL_PATH>: NNAL 安装目标路径（如 /usr/local/Ascend）

若用户未提供 INSTALL_PATH，立即停止并打断，要求用户提供安装路径。

脚本校验示例：

if [ -z "$INSTALL_PATH" ]; then
    echo "ERROR: INSTALL_PATH 未设置，请提供 NNAL 安装路径。"
    exit 1
fi

---

详细内容

🔍 查看详细安装步骤

第1步：检查 NPU 驱动

npu-smi info

若 npu-smi 不可用或未检测到 NPU 设备，停止安装并报错。

第2步：调用 cann-operator-env-config（如尚未安装 Toolkit+Kernels）

如果 Toolkit+Kernels 尚未安装，首先调用 cann-operator-env-config 技能安装 Toolkit 和 Kernels：

• 该技能位于 /home/s30073260/swiglu_quant/agent-skills-ivan-fork/skills/cann-operator-env-config/
• 提供 3 种安装方式：离线 run 包、conda 在线、yum 在线
• 安装完成后，Toolkit 和 Kernels 将位于 /usr/local/Ascend/

第3步：Source Toolkit 环境变量

source /usr/local/Ascend/ascend-toolkit/set_env.sh

关键：NNAL 安装脚本依赖 ASCEND_TOOLKIT_HOME 等环境变量，必须先 source。

验证环境变量：

echo $ASCEND_TOOLKIT_HOME
# 应输出: /usr/local/Ascend/ascend-toolkit/latest 或自定义路径