Thanks for sending an issue! Please fill in the following template to help quickly solve your problem.

一、问题描述 （必填）

在 matmul_story 用例按 README 流程执行时，gen_data.py 阶段因 import torch 失败，报错缺少 libhccl.so，导致用例无法运行。

典型报错日志：

ImportError: libhccl.so: cannot open shared object file: No such file or directory

RuntimeError: Failed to load the backend extension: torch_npu.
You can disable extension auto-loading with TORCH_DEVICE_BACKEND_AUTOLOAD=0.

补充说明：

• matmul_story 相关 README 中未明确声明需安装 torch/torch_npu/HCCL 运行依赖。
• 编译阶段可通过，问题发生在运行脚本的数据生成（Python）阶段。

二、环境信息 （可选）

• 昇腾硬件型号：容器内未直接确认（可补充）
• CANN版本：9.0.0（ASCEND_HOME_PATH=/usr/local/cann-9.0.0）
• 操作系统：Ubuntu 24.04.3 LTS
• 其他相关软件版本：Python 3.12.9
• 运行依赖现状：
  • 脚本依赖 torch，触发 torch_npu 自动加载
  • 当前环境中未找到 libhccl.so（/usr/local/cann-9.0.0/lib64 下不存在）

三、重现步骤 （可选）

1. 配置环境变量：

source /usr/local/cann-9.0.0/set_env.sh

2. 在仓库根目录配置并编译：

cmake -S . -B build_usr_local -DNPU_ARCH=dav-3510
cmake --build build_usr_local --parallel $(nproc)
cmake --install build_usr_local --prefix ./build_out

3. 执行 matmul_story 任一 README 推荐脚本（示例）：

cd Samples/2_Performance/matmul_story/matmul_tutorials
bash scripts/run.sh --skip-build --target matmul_tutorial_mxfp4_swat_balance 256 256 256

4. 在 gen_data.py 中 import torch 时失败，报 libhccl.so 缺失。

同类问题在以下脚本也可复现：

• Samples/2_Performance/matmul_story/matmul_tutorials/scripts/gen_data.py
• Samples/2_Performance/matmul_story/matmul_recipes/examples/matmul_a16w16/scripts/gen_data.py
• Samples/2_Performance/matmul_story/matmul_recipes/examples/quant_matmul_mxfp4/scripts/gen_data.py
• Samples/2_Performance/matmul_story/matmul_recipes/examples/quant_matmul_mxfp8/scripts/gen_data.py

四、预期结果 （可选）

• matmul_story README 明确说明运行阶段对 torch/torch_npu/HCCL 的依赖与安装要求；或
• gen_data.py / run.sh 增加前置依赖检查与友好错误提示；或
• 提供不依赖 torch_npu/HCCL 的数据生成兜底路径（至少用于基础样例跑通）。

💡 备注（选填）