@cannbot-plugin/cannbot-harness 0.0.0-stage → 0.1.4

package/assets/ops-direct-invoke/skills/ascendc-crash-debug/references/memcheck/automated_workflow.md

@@ -0,0 +1,418 @@
+# AscendC Memcheck 自动化工作流指南
+
+## 概述
+
+`run_memcheck_pre.sh` 脚本自动化执行 AscendC 内存检测工作流的第 1-3 步：
+
+1. **编译**：使用 sanitizer 选项编译算子
+2. **安装**：安装算子包到 `code_base_dir/custom_output_dir` 目录
+3. **运行 MemCheck**：执行 mssanitizer memcheck 检测
+
+## 快速开始
+
+### 1. 准备配置文件
+
+从技能目录复制模板到当前工作目录：
+
+```bash
+cp scripts/memcheck_input.json.template memcheck_input.json
+```
+
+编辑 `memcheck_input.json`，填写必要的参数：
+
+```json
+{
+  "operator": {
+    "name": "your_operator_name"
+  },
+  "paths": {
+    "code_base_dir": "/path/to/your/training/ascendc"
+  },
+  "testing": {
+    "test_script_dir": "/path/to/your/code/training/ascendc/src/.../tests/st",
+    "test_script_exe": "pytest test_npu_xxx.py"
+  },
+  "environment": {
+    "device_type": "ascend910b",
+    "cann_env": "/path/to/cann"
+  },
+  "options": {
+    "rebuild": true
+  }
+}
+```
+
+### 2. 拷贝并运行脚本
+
+从技能目录拷贝脚本到当前路径并执行：
+
+```bash
+cp scripts/run_memcheck_pre.sh .
+./run_memcheck_pre.sh
+```
+
+### 3. 查看结果
+
+输出结果保存在 `code_base_dir/memcheck_output/` 目录：
+
+```
+code_base_dir/memcheck_output/
+├── status.txt              # 执行状态摘要
+├── build/
+│   ├── build.log           # 编译日志
+│   ├── build_errors.log    # 编译错误日志
+│   └── package_path.txt    # 编译产物路径
+├── install/
+│   ├── install.log         # 安装日志
+│   └── install_errors.log  # 安装错误日志
+├── memcheck/
+│   ├── memcheck.log        # Memcheck 日志
+│   ├── ascendc_memcheck_report_raw.txt  # 原始报告
+│   └── mindstudio_sanitizer_log/        # mssanitizer 日志
+└── timestamp.txt           # 执行时间戳
+```
+
+## 详细说明
+
+### 配置文件参数
+
+| 字段路径 | 说明 | 是否必需 | 默认值 | 示例 |
+|---------|------|---------|--------|------|
+| `operator.name` | 算子名称 | 是 | - | `"sparse_flash_attention_enhance"` |
+| `paths.code_base_dir` | 代码库根目录（包含 build.sh） | 是 | - | `"/home/user/code/training/ascendc"` |
+| `testing.test_script_dir` | ST 测试脚本绝对路径 | 否 | - | `"/home/user/code/training/ascendc/.../tests/st"` |
+| `testing.test_script_exe` | ST 测试脚本执行方式 | 否 | - | `"pytest test_npu_xxx.py"` |
+| `environment.device_type` | NPU 设备类型 | 是 | - | `"ascend910b"` |
+| `environment.cann_env` | CANN 环境路径 | 是 | - | `"/home/user/pkg/cann/latest"` |
+| `compilation.sanitizer_options` | 编译选项 | 否 | `"-sanitizer;-g"` | `"-sanitizer;-g"` |
+| `memcheck.log_level` | 日志级别 | 否 | `"3"` | `"3"` |
+| `memcheck.slog_print_to_stdout` | 标准输出开关 | 否 | `"true"` | `"true"` |
+| `memcheck.timeout` | 超时时间（秒） | 否 | `600` | `600` |
+| `options.rebuild` | 是否重新编译 | 否 | `true` | `true` |
+| `installation.load_environment` | 是否加载算子环境 | 否 | `true` | `true` |
+
+### 命令行参数
+
+```bash
+./run_memcheck_pre.sh [options]
+```
+
+| 参数 | 说明 |
+|------|------|
+| `-h, --help` | 显示帮助信息 |
+| `-c, --config FILE` | 配置文件路径（默认：`./memcheck_input.json`） |
+| `--skip-build` | 跳过编译步骤 |
+| `--keep-build` | 保留构建目录 |
+| `--verbose` | 显示详细输出 |
+
+### 使用示例
+
+#### 示例 1：使用默认配置
+
+```bash
+./run_memcheck_pre.sh
+```
+
+#### 示例 2：指定配置文件
+
+```bash
+./run_memcheck_pre.sh --config /path/to/my_config.json
+```
+
+#### 示例 3：跳过编译（已有编译产物）
+
+```bash
+./run_memcheck_pre.sh --skip-build
+```
+
+#### 示例 4：详细输出模式
+
+```bash
+./run_memcheck_pre.sh --verbose
+```
+
+#### 示例 5：组合选项
+
+```bash
+./run_memcheck_pre.sh \
+  --config my_config.json \
+  --verbose
+```
+
+## 工作流程
+
+### 完整工作流程（3 步）
+
+1. **编译算子**
+   - 加载 CANN 环境：`source <cann_env>/bin/setenv.bash`
+   - 进入代码目录：`cd <code_base_dir>`
+   - 执行编译：`bash build.sh -n <op_name> -c <device> -p <cann_env> --ops-compile-options "<sanitizer_opts>"`
+   - 检查编译产物（.run 文件）
+   - 保存编译产物路径到 `memcheck_output/build/package_path.txt`
+
+2. **安装算子**
+   - 查找编译产物：从 `code_base_dir/output` 目录查找 .run 文件
+   - 创建/清理安装目录：`code_base_dir/custom_output_dir/`
+   - 执行安装：`./output/<package>.run --install-path=<code_base_dir/custom_output_dir>`
+   - 加载算子环境（可选）：`source <code_base_dir>/custom_output_dir/vendors/omni_training_custom_ops/bin/set_env.bash`
+
+3. **运行 MemCheck**
+   - 设置日志环境变量：
+     - `ASCEND_GLOBAL_LOG_LEVEL=<log_level>`
+     - `ASCEND_SLOG_PRINT_TO_STDOUT=<slog_print>`
+   - 进入 ST 目录（从 `test_script_dir` 绝对路径提取）
+   - 执行：`mssanitizer --tool=memcheck <test_script_exe>`
+   - 收集输出和日志文件
+   - 生成状态报告：
+     - 统计 ERROR 和 WARNING 数量
+     - 显示前 5 条错误/警告
+     - 检查测试结果
+
+### 跳过编译的工作流程
+
+当使用 `--skip-build` 或配置文件中 `rebuild=false` 时：
+
+1. **跳过编译**：直接使用现有的编译产物
+2. **安装算子**：从 `code_base_dir/output` 查找现有算子包并安装到 `code_base_dir/custom_output_dir`
+3. **运行 MemCheck**：执行内存检测
+
+## 输出文件说明
+
+### status.txt
+
+执行状态摘要，包含：
+- 执行时间
+- 配置文件路径
+- 各步骤执行状态（成功/失败/跳过）
+- 输出文件路径列表
+
+### build/
+
+编译相关日志：
+- `build.log`：完整的编译输出
+- `build_errors.log`：编译错误信息（如果编译失败）
+- `package_path.txt`：编译产物的绝对路径
+
+### install/
+
+安装相关日志：
+- `install.log`：完整的安装输出
+- `install_errors.log`：安装错误信息（如果安装失败）
+
+### memcheck/
+
+Memcheck 相关文件：
+- `memcheck.log`：完整的 memcheck 输出（从 raw_report 复制）
+- `ascendc_memcheck_report_raw.txt`：原始 memcheck 报告
+- `mindstudio_sanitizer_log/`：mssanitizer 工具生成的详细日志
+
+## 错误处理
+
+脚本会在以下情况退出并返回非零状态码：
+
+1. 配置文件不存在或格式错误
+2. CANN 环境脚本不存在
+3. 代码目录或编译脚本不存在
+4. 编译失败
+5. 安装失败
+6. 测试目录不存在
+7. Memcheck 执行失败（根据情况）
+
+每次失败都会在日志中保存完整的错误信息。
+
+## 常见问题
+
+### Q: 如何更改编译选项？
+
+A: 编辑配置文件中的 `compilation.sanitizer_options` 字段。
+
+```json
+{
+  "compilation": {
+    "sanitizer_options": "-sanitizer;-g"  // 使用完整调试信息
+  }
+}
+```
+
+### Q: 如何只运行 MemCheck，不重新编译？
+
+A: 使用 `--skip-build` 参数或在配置文件中设置 `rebuild=false`。
+
+```bash
+./run_memcheck_pre.sh --skip-build
+```
+
+或
+
+```json
+{
+  "options": {
+    "rebuild": false
+  }
+}
+```
+
+### Q: 产物保存在哪里？
+
+A: 所有输出保存在 `code_base_dir/memcheck_output/` 目录。算子包安装在 `code_base_dir/custom_output_dir/` 目录。
+
+### Q: 如何查看 Memcheck 结果？
+
+A: 查看 `code_base_dir/memcheck_output/memcheck/ascendc_memcheck_report_raw.txt` 文件。
+
+### Q: 脚本需要什么依赖？
+
+A: 脚本需要：
+- Bash 3.2+
+- Python 3.6+（用于解析 JSON）
+- CANN 环境
+- mssanitizer 工具（通常由 CANN 提供）
+
+### Q: 测试脚本为什么使用绝对路径？
+
+A: 使用绝对路径可以避免相对路径计算错误，特别是在不同目录执行脚本时更可靠。配置文件中使用 `test_script_dir` 指定测试目录绝对路径，`test_script_exe` 指定在该目录下执行的命令（通常为 pytest 命令）。
+
+### Q: `memcheck.timeout` 参数有什么用？
+
+A: 此参数在配置文件中定义，用于设置 Memcheck 执行的超时时间（单位：秒），默认 600 秒（10 分钟）。如果执行时间超过设定值，进程可能被终止。
+
+### Q: 安装失败如何处理？
+
+A: 脚本会先清理旧安装目录，然后重新安装。如果失败：
+1. 检查 `code_base_dir/memcheck_output/install/install.log` 了解详细错误
+2. 检查是否还有残留文件占用目录
+3. 手动清理 `code_base_dir/custom_output_dir/` 目录
+4. 重新运行脚本
+
+### Q: 如何禁用自动加载算子环境？
+
+A: 在配置文件中设置 `installation.load_environment` 为 `false`：
+
+```json
+{
+  "installation": {
+    "load_environment": false
+  }
+}
+```
+
+## 与手动执行的区别
+
+| 项目 | 手动执行 | 自动化脚本 |
+|------|---------|-----------|
+| 配置 | 每次手动设置命令行参数 | 通过 JSON 配置文件管理 |
+| 编译 | 手动执行 build.sh | 自动执行并检查结果 |
+| 安装 | 手动查找安装包并指定路径 | 自动查找并安装到固定路径 |
+| 环境 | 手动加载多次 | 根据配置自动加载必要环境 |
+| 日志 | 分散保存 | 集中管理到 `code_base_dir/memcheck_output` |
+| 错误处理 | 需要手动检查 | 自动检测并报告 |
+| 测试脚本路径 | 需要手动计算相对/绝对路径 | 使用绝对路径，自动进入测试目录 |
+| 安装路径管理 | 需要手动指定绝对路径 | 固定安装在 `code_base_dir/custom_output_dir/` |
+| 结果摘要 | 需要手动统计 | 自动生成 ERROR/WARNING 数量摘要 |
+
+## 后续步骤
+
+脚本完成后，继续执行第 4-7 步：
+
+1. **分析错误输出**：查看 memcheck 报告中的 ERROR 和 WARNING
+2. **定位源代码**：根据调用栈定位问题代码
+3. **根因分析**：分析错误原因
+4. **生成报告**：创建详细的内存检测报告
+
+详细步骤请参考主文档 [`SKILL.md`](../../SKILL.md)。
+
+## 技巧和建议
+
+### 1. 使用版本控制管理配置文件
+
+为不同的算子或测试场景创建不同的配置文件：
+
+```bash
+cp scripts/memcheck_input.json.template memcheck_input_op1.json
+cp scripts/memcheck_input.json.template memcheck_input_op2.json
+```
+
+### 2. 定制超时时间
+
+对于大型算子或复杂测试用例，调整 `memcheck.timeout` 参数：
+
+```json
+{
+  "memcheck": {
+    "timeout": 1200  // 20 分钟
+  }
+}
+```
+
+### 3. 调试模式
+
+使用 `--verbose` 查看详细执行过程：
+
+```bash
+./run_memcheck_pre.sh --verbose
+```
+
+### 4. 批量测试
+
+结合脚本进行多算子测试（创建测试脚本）：
+
+```bash
+#!/bin/bash
+cp scripts/run_memcheck_pre.sh .
+
+for config in memcheck_input_*.json; do
+    ./run_memcheck_pre.sh -c "$config"
+done
+```
+
+### 5. 环境管理
+
+- 如果不希望脚本自动加载算子环境，设置 `load_environment: false`
+- 编译环境（CANN）和算子环境会分别管理，互不干扰
+
+### 6. 清理旧版本
+
+如果不再需要某个版本的算子包：
+
+```bash
+# 手动删除指定的 custom_output_dir 目录
+rm -rf /path/to/code/base/custom_output_dir
+
+# 或修改 code_base_dir 配置指向不同的代码目录
+```
+
+## 目录说明
+
+### 技能目录结构
+
+```
+ascendc-crash-debug/
+├── scripts/
+│   ├── memcheck_input.json.template    # 配置文件模板
+│   ├── run_memcheck_pre.sh             # 自动化脚本
+│   └── parse_plog.py                   # plog 日志解析脚本
+└── references/
+    └── memcheck/
+        ├── automated_workflow.md       # 本文档 - 自动化工作流指南
+        ├── README.md                   # 用户使用指南
+        └── mssanitizer_guide.md        # msSanitizer 工具原始文档
+```
+
+## 支持和反馈
+
+如遇问题，请检查：
+
+1. 配置文件格式是否正确（JSON 语法）
+2. 所有必需参数是否已填写
+3. CANN 环境路径是否正确
+4. NPU 设备是否可用
+5. 日志文件中的错误信息
+6. 是否有其他进程占用算子包安装路径
+7. 测试脚本目录是否存在
+8. 测试脚本名称是否与配置一致
+
+---
+
+**文档版本**: 2.4
+**最后更新**: 2026-05-16
+**适用版本**: ascendc-crash-debug skill (memcheck 子模块)

package/assets/ops-direct-invoke/skills/ascendc-crash-debug/references/memcheck/mssanitizer_guide.md

@@ -0,0 +1,181 @@
+# msSanitizer 内存检测工具指南
+
+> **文档版本**: MindStudio 80.RC1
+> **适用产品**: Atlas 系列开发者套件/模组
+
+## 1. 概述
+
+内存检测（Memory Check）是针对用户程序运行时的一种异常检测功能。**msSanitizer** 工具可以检测并报告算子运行中对外部存储（Global Memory）和内部存储（Local Memory）的越界及未对齐等内存访问异常。
+
+> **⚠️ 注意**:
+> *   msSanitizer 工具**不支持**对加速库（Ascend Transformer Boost）的算子仓进行内存检测。
+> *   当用户使用 PyTorch 等框架接入算子时，框架内部可能会通过内存池管理 GM 内存。此时需使用手动上报接口（`SanitizerReportMalloc` / `SanitizerReportFree`）以确保检测准确性。
+
+---
+
+## 2. 支持的内存异常类型
+
+内存检测能够识别并报告以下六类核心异常：
+
+| 异常名称 | 描述 | 发生位置 | 支持地址空间 |
+| :--- | :--- | :--- | :--- |
+| **非法读写**<br>(Illegal Read/Write) | 访问了未分配的内存区域。 | Kernel, Host | GM, UB, L0{A,B,C}, L1 |
+| **多核踩踏**<br>(Multi-core Overwrite) | 多个 AI Core 访问了重叠的内存区域，且至少有一个核进行了写入操作。 | Kernel | GM |
+| **非对齐访问**<br>(Misaligned Access) | DMA 搬运数据的地址未满足硬件最小访问粒度对齐要求。 | Kernel | GM, UB, L0{A,B,C}, L1 |
+| **非法释放**<br>(Illegal Free) | 尝试释放未分配或已释放的内存地址。 | Host | GM |
+| **内存泄漏**<br>(Memory Leak) | 申请内存后未释放，导致运行过程中内存占用持续增加。 | Host | GM |
+| **分配内存未使用**<br>(Unused Memory) | 内存分配后直到程序结束都未被访问或使用。 | Kernel, Host | GM |
+
+---
+
+## 3. 启用内存检测
+
+运行 `msSanitizer` 工具时，默认启用基础内存检测功能（memcheck）。
+
+### 3.1 基础检测命令
+开启默认的非法读写、多核踩踏、非对齐访问和非法释放检测：
+```bash
+mssanitizer --tool=memcheck <application>
+```
+
+### 3.2 高级检测选项
+
+*   **开启内存泄漏检测**:
+    若需检测内存泄漏，需显式添加 `--leak-check=yes` 参数：
+    ```bash
+    mssanitizer --tool=memcheck --leak-check=yes <application>
+    ```
+
+*   **开启分配内存未使用检测**:
+    若需检测已分配但未使用的内存，需显式添加 `--check-unused-memory=yes` 参数：
+    ```bash
+    mssanitizer --tool=memcheck --check-unused-memory=yes <application>
+    ```
+
+> **💡 提示**:
+> *   异常报告将在用户程序运行完成后打印到终端。
+> *   该工具也支持对 HCCL 通信接口（如 AllReduce, AllGather 等）及通算融合类算子的非法读写检测。
+
+---
+
+## 4. 内存异常报告解析
+
+以下是各类异常的典型报告格式及解读方法。
+
+### 4.1 非法读写 (Illegal Read/Write)
+**含义**: 算子访问了未分配的 GM 或片上内存（超出硬件容量）。
+
+**示例报告**:
+```text
+====== ERROR : illegal read of size 224 
+====== at 0x12c0c0015000 on GM in add_custom_kernel 
+====== in block aiv(0) on device 0 
+====== code in pc current 0x77c (serialNo: 10) 
+====== #0  $ {ASCEND_HOME_PATH}/compiler/tikcpp/tikcfw/impl/dav_c220/kernel_operator_data_copy_impl.h:58:9 
+====== #1 ...
+====== #3 illegal_read_and_write/add_custom.cpp:18:5 
+```
+
+
+解读:
+
+错误类型: 非法读取 224 字节。
+
+位置: GM 地址 0x12c0c0015000，发生在 add_custom_kernel 核函数中。
+
+代码定位: 对应源文件 add_custom.cpp 第 18 行。
+
+注意: 若编译时未添加调试选项，可能不会显示 #0 到 #3 的调用栈信息。
+
+
+### 4.2 多核踩踏
+
+AI Core 是昇腾 AI 处理器中的计算核心，AI 处理器内部有多个 AI Core，算子运行就在这些 AI Core 上。这些 AI Core 会在计算过程中从 GM 上搬入或搬出数据。当没有显式地进行核间同步时，如果各个核之间访问的 GM 内存存在重叠并且至少有一个核对重叠地址进行写入时，则会发生多核踩踏问题。这里我们通过所有者的概念来保证多核之间不会发生踩踏问题，当一块内存被某一个核写入后，这块内存就由该核所有。当其他核对这块内存进行访问时就会产生 out of bounds 异常。
+
+**示例报告：**
+
+```text
+====== WARNING : out of bounds of size 256 
+// 异常的基本信息，包含发生踩踏的字节数
+====== at 0x12c0c00150fc on GM when writing data in add_custom_kernel 
+// 异常发生的内存位置信息，包含发生的核函数名、地址空间与内存地址，此处的内存地址指一次内存访问中的首地址
+====== in block aiv(9) on device 0 
+// 异常代码对应 vector 核的 block 索引
+====== code in pc current 0x7b8 (serialNo: 22) 
+// 当前异常发生的 pc 指针和调用 api 行为的序列号
+====== #0  $ {ASCEND_HOME_PATH}/compiler/tikcpp/tikcfw/impl/dav_c220/kernel_operator_data_copy_impl.h:103:9 
+// 以下为异常发生代码的调用栈，包含文件名、行号和列号
+====== #1  $ {ASCEND_HOME_PATH}/compiler/tikcpp/tikcfw/inner_interface/inner_kernel_operator_data_copy_intf.cppm:155:9
+====== #2  $ {ASCEND_HOME_PATH}/compiler/tikcpp/tikcfw/inner_interface/inner_kernel_operator_data_copy_intf.cppm:461:5
+====== #3 out_of_bound/add_custom.cpp:21:5
+```
+以上示例中，共有 256 个字节的访问发生踩踏，对 GM 上的“0x12c0c00150fc”地址进行访问时存在多核踩踏，且导致异常发生的指令对应于算子实现文件 add_custom.cpp 的第 21 行。
+
+### 4.3 非对齐访问 (Misaligned Access)
+
+含义: 访问地址不符合 DMA 搬运的最小粒度要求（如 32 字节或 128 字节对齐），可能导致数据错误或 AI Core 异常。
+
+示例报告:
+```text
+====== ERROR : misaligned access of size 13 
+// 异常的基本信息，包含发生对齐异常操作的字节数
+====== at 0x6 on UB in add_custom_kernel 
+// 异常发生的内存位置信息，包含发生的核函数名、地址空间与内存地址
+====== in block aiv(0) on device 0 
+// 异常代码对应 vector 核的 block 索引
+====== code in pc current 0x780 (serialNo: 33) 
+// 当前异常发生的 pc 指针和调用 api 行为的序列号
+====== #0  $ {ASCEND_HOME_PATH}/compiler/tikcpp/tikcfw/impl/dav_c220/kernel_operator_data_copy_impl.h:103:9 
+// 以下为异常发生代码的调用栈，包含文件名、行号和列号
+====== #1  $ {ASCEND_HOME_PATH}/compiler/tikcpp/tikcfw/inner_interface/inner_kernel_operator_data_copy_intf.cppm:155:9
+====== #2  $ {ASCEND_HOME_PATH}/compiler/tikcpp/tikcfw/inner_interface/inner_kernel_operator_data_copy_intf.cppm:461:5
+====== #3 illegal_align/add_custom.cpp:18:5
+```
+以上示例中，共有针对 13 个字节的对齐异常访问，对 UB 上的“0x6”地址进行访问时存在对齐问题，且导致异常发生的指令对应于算子实现文件 add_custom.cpp 的第 18 行。
+注意：不添加编译选项的情况下，异常报告将不会出现调用栈信息。
+
+### 4.4 内存泄漏
+内存检测可以检测出 Device 侧的内存泄漏问题，这些问题通常是开发者没有正确释放使用 AscendCL 接口申请的内存导致的，由于内部存储（Local Memory）目前不存在内存分配的概念，因此内存泄漏只可能出现在 GM 上。通过指定命令行参数 --leak-check=yes 可以开启内存泄漏检测。
+
+示例报告:
+```text
+====== ERROR : LeakCheck: detected memory leaks 
+// 检测到内存泄漏
+====== Direct leak of 100 byte(s) 
+// 具体每次的内存泄漏信息
+====== at 0x124080013000 on GM allocated in add_custom.cpp:14 (serialNo: 37)
+====== Direct leak of 1000 byte(s)
+====== at 0x124080014000 on GM allocated in add_custom.cpp:15 (serialNo: 55)
+====== SUMMARY: 1100 byte(s) leaked in 2 allocation(s) 
+// 全部内存泄漏的总结，包括发生泄漏的次数以及总共泄漏了多少字节等信息
+```
+
+以上示例中，第一个内存泄漏信息包含了地址空间、内存地址、内存长度以及代码定位信息，代码定位信息指向具体分配这块内存的调用所在的文件名和行号。
+### 4.5 非法释放
+非法释放是指对一个未分配的地址或者已释放的地址进行了释放操作，一般发生在 GM 上。
+
+示例报告：
+```text
+====== ERROR: illegal free()     
+// 异常的基本信息，表明发生了非法释放异常
+====== at 0x124080013000 on GM      
+// 异常发生的内存位置信息，包含发生的地址空间与内存地址
+====== code in add_custom.cpp:84 (serialNo:63)    
+// 异常发生的代码定位信息，包含文件名、行号和调用 api 行为的序列号
+```
+以上示例中，对 GM 上的“0x124080013000”地址进行了非法释放，且导致异常发生的指令对应于算子实现文件 add_custom.cpp 的第 84 行。
+
+### 4.6 分配内存未使用
+分配内存未使用是指算子运行时申请了内存，但直到算子运行完成，都没有使用该内存。该异常场景一般是算子使用了错误的内存或算子逻辑存在问题，一般发生在 GM 上。
+
+示例报告：
+```text
+====== WARNING : Unused memory of 1000 byte(s) 
+// 异常的基本信息，表明检测到内存分配未使用异常
+====== at 1240c0016000 on GM 
+// 异常发生的内存位置信息，包含发生的地址空间与内存地址
+====== code in add_custom.cpp:2 (serialNo: 69) 
+// 异常发生的代码定位信息，包含文件名、行号和调用 api 行为的序列号
+====== SUMMARY: 1100 byte(s) unused memory in 2 allocation(s) 
+// 内存分配未使用的总结信息，包括未使用内存块的个数及字节等信息
+```

package/assets/ops-direct-invoke/skills/ascendc-crash-debug/scripts/memcheck_input.json.template

@@ -0,0 +1,44 @@
+{
+  "skill": "ascendc-crash-debug",
+  "version": "2.0",
+  "description": "AscendC 内存检测配置文件模板 - 将此文件复制为 memcheck_input.json 并填写参数",
+
+  "operator": {
+    "name": "sparse_flash_attention_enhance",
+    "description": "算子名称"
+  },
+
+  "paths": {
+    "code_base_dir": "training/ascendc/src",
+    "description": "代码库根目录（必须包含 build.sh 的目录）"
+  },
+
+  "testing": {
+    "test_script_dir": "training/ascendc/src/ops-transformer/attention/sparse_flash_attention_enhance/tests/st",
+    "test_script_exe": "pytest test_npu_sparse_flash_attention_enhance.py",
+    "description": "ST 测试脚本绝对路径"
+  },
+
+  "environment": {
+    "device_type": "ascend910b",
+    "cann_env": "/latest",
+    "description": "NPU 设备类型和 CANN 环境路径"
+  },
+
+  "compilation": {
+    "sanitizer_options": "-sanitizer;-g",
+    "description": "编译选项。-g 获取完整调试信息"
+  },
+
+  "memcheck": {
+    "log_level": "3",
+    "slog_print_to_stdout": "true",
+    "timeout": 600,
+    "description": "Memcheck 运行配置"
+  },
+
+  "options": {
+    "rebuild": true,
+    "description": "执行选项控制。rebuild=false 等同于 --skip-build 命令行选项"
+  }
+}