ops-blas/docs/zh/install · CANN/ops-blas - AtomGit

cann-robotrefactor: 测试框架集成 Netlib BLAS/LAPACK，重构 6 个算子 golden 实现

文件	最后提交记录	最后更新时间
dir_structure.md	Refact:重构算子目录结构为家族格式 Co-authored-by: xutianze<xutianze2@huawei.com> # message auto-generated for no-merge-commit merge: !95 merge refact_dir_arc into master Refact:重构算子目录结构为家族格式 Created-by: xutianze Commit-by: xutianze Merged-by: cann-robot Description: ## 描述将 blas/ 和 test/ 中扁平结构的算子目录重构为 `family/operator/archXX/` 家族格式，统一仓内目录规范。目录变更： - blas/: gbmv/sbmv/syr/syr2 移入家族子目录（如 `blas/gbmv/arch35/` → `blas/gbmv/sgbmv/arch35/`） - test/: gbmv/sbmv/sspmv/ssymv/syr/syr2/stpttr/strttp 移入家族子目录（如 `test/sspmv/` → `test/spmv/sspmv/`） - 测试文件重命名匹配算子名（如 `gbmv_test.cpp` → `sgbmv_test.cpp`） - 算子 README 从 test/ 移动到 blas/ 对应算子目录下（34 个文件）构建系统适配： - `test/CMakeLists.txt`: 支持家族嵌套路径解析，自动查找 `test/family/op/` 结构 - `build.sh`: 新增 `expand_family_ops()` 函数，支持 `--ops=gbmv` 自动展开为具体算子（如 sgbmv）；自动发现功能支持家族嵌套目录；测试二进制路径解析适配嵌套结构文档更新： - `docs/QUICKSTART.md`: scopy 路径更新为 `blas/copy/scopy/` - `docs/zh/install/dir_structure.md`: 目录结构说明更新为 `family/operator/archXX/` 格式 - `docs/zh/develop/st_develop_guide.md`: 测试文件清单更新为 `test/<family>/<op>/` 格式 - `agent/agents/developer.md`、`agent/agents/tester.md`: 路径模板更新为 `{family}/{operator_name}` 格式 - `agent/skills/blas-new-op-workflow/references/task-prompts.md`: 输出路径更新 ## 关联的Issue [#56](https://gitcode.com/cann/ops-blas/issues/56) ## 测试双平台验证，全部通过，0 失败。 ### arch22 平台 (ascend910b3) 自动发现验证： `bash bash build.sh --run --soc=ascend910b3` 结果：自动发现 34 个算子，23 passed / 11 skipped / 0 failed ✅ 通过的算子 (23个)： \| 命令 \| 结果 \| \|------\|------\| \| `bash build.sh --ops=sasum --soc=ascend910b3 --run` \| sasum: passed ✅ \| \| `bash build.sh --ops=caxpy --soc=ascend910b3 --run` \| caxpy: passed ✅ \| \| `bash build.sh --ops=scopy --soc=ascend910b3 --run` \| scopy: passed ✅ \| \| `bash build.sh --ops=cdot --soc=ascend910b3 --run` \| cdot: passed ✅ \| \| `bash build.sh --ops=sdot --soc=ascend910b3 --run` \| sdot: passed ✅ \| \| `bash build.sh --ops=snrm2 --soc=ascend910b3 --run` \| snrm2: passed ✅ \| \| `bash build.sh --ops=csrot --soc=ascend910b3 --run` \| csrot: passed ✅ \| \| `bash build.sh --ops=srotm --soc=ascend910b3 --run` \| srotm: passed ✅ \| \| `bash build.sh --ops=cscal --soc=ascend910b3 --run` \| cscal: passed ✅ \| \| `bash build.sh --ops=sscal --soc=ascend910b3 --run` \| sscal: passed ✅ \| \| `bash build.sh --ops=cswap --soc=ascend910b3 --run` \| cswap: passed ✅ \| \| `bash build.sh --ops=sswap --soc=ascend910b3 --run` \| sswap: passed ✅ \| \| `bash build.sh --ops=cgemv --soc=ascend910b3 --run` \| cgemv: passed ✅ \| \| `bash build.sh --ops=cgemv_batched --soc=ascend910b3 --run` \| cgemv_batched: passed ✅ \| \| `bash build.sh --ops=sger --soc=ascend910b3 --run` \| sger: passed ✅ \| \| `bash build.sh --ops=cgerc --soc=ascend910b3 --run` \| cgerc: passed ✅ \| \| `bash build.sh --ops=sspmv --soc=ascend910b3 --run` \| sspmv: passed ✅ \| \| `bash build.sh --ops=ssymv --soc=ascend910b3 --run` \| ssymv: passed ✅ \| \| `bash build.sh --ops=stbmv --soc=ascend910b3 --run` \| stbmv: passed ✅ \| \| `bash build.sh --ops=stpmv --soc=ascend910b3 --run` \| stpmv: passed ✅ \| \| `bash build.sh --ops=ctrmv --soc=ascend910b3 --run` \| ctrmv: passed ✅ \| \| `bash build.sh --ops=strmv --soc=ascend910b3 --run` \| strmv: passed ✅ \| \| `bash build.sh --ops=strsv --soc=ascend910b3 --run` \| strsv: passed ✅ \| 跳过的算子 (11个)： \| 算子 \| 跳过原因 \| \|------\|---------\| \| sgbmv, ssbmv, ssyr, ssyr2, stpsv, stpttr, strttp \| 仅 arch35 实现 (ascend950) \| \| blasLtMatmul \| 需要 asc-devkit >= 9.1，当前 9.0 \| \| colwise_mul, complex_mat_dot, iamax \| arch22 无实现 \| ### arch35 平台 (ascend950) 单算子验证： \| 命令 \| 结果 \| \|------\|------\| \| `bash build.sh --ops=gbmv --soc=ascend950 --run` \| sgbmv: 51 tests passed ✅ \| \| `bash build.sh --ops=sbmv --soc=ascend950 --run` \| ssbmv: 29 tests passed ✅ \| \| `bash build.sh --ops=syr --soc=ascend950 --run` \| ssyr: 23 tests passed ✅ \| \| `bash build.sh --ops=syr2 --soc=ascend950 --run` \| ssyr2: 34 tests passed ✅ \| \| `bash build.sh --ops=spmv --soc=ascend950 --run` \| sspmv: 20 tests passed ✅ \| \| `bash build.sh --ops=symv --soc=ascend950 --run` \| ssymv: 20 tests passed ✅ \| \| `bash build.sh --ops=tpttr --soc=ascend950 --run` \| stpttr: 56 tests passed ✅ \| \| `bash build.sh --ops=trttp --soc=ascend950 --run` \| strttp: 56 tests passed ✅ \| 家族名展开验证： \| 命令 \| 展开结果 \| 结果 \| \|------\|---------\|------\| \| `bash build.sh --ops=gbmv --soc=ascend950 --run` \| gbmv → sgbmv \| 51 tests passed ✅ \| \| `bash build.sh --ops=sbmv --soc=ascend950 --run` \| sbmv → ssbmv \| 29 tests passed ✅ \| \| `bash build.sh --ops=syr --soc=ascend950 --run` \| syr → ssyr \| 23 tests passed ✅ \| \| `bash build.sh --ops=gbmv,sbmv,syr --soc=ascend950 --run` \| gbmv,sbmv,syr → sgbmv,ssbmv,ssyr \| 3 passed, 0 failed ✅ \| 自动发现验证： `bash bash build.sh --soc=ascend950 --run` 结果：自动发现 33 个算子，11 passed / 22 skipped / 0 failed ✅ Rebase cann/master 后验证： `bash git rebase cann/master # rebase 到 cb1184d bash build.sh --ops=gbmv,sbmv,syr,syr2,spmv,symv,tpttr,trttp --soc=ascend950 --run` 结果： 8 passed, 0 skipped, 0 failed ✅ ### 验证总结 \| 平台 \| 通过算子数 \| 测试用例数 \| 失败数 \| \|------\|-----------\|-----------\|--------\| \| arch22 (ascend910b3) \| 23 \| - \| 0 \| \| arch35 (ascend950) \| 8 \| 289 \| 0 \| \| 总计 \| 31 \| 289+ \| 0 \| ## 文档更新 - `docs/QUICKSTART.md`: scopy 路径更新 - `docs/zh/install/dir_structure.md`: 目录结构说明更新 - `docs/zh/develop/st_develop_guide.md`: 测试文件清单更新 - `agent/agents/developer.md`、`agent/agents/tester.md`: 路径模板更新 - `agent/skills/blas-new-op-workflow/references/task-prompts.md`: 输出路径更新 - 34 个算子 README 从 `test/` 移动到 `blas/` 对应目录 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：目录结构重构 See merge request: cann/ops-blas!95	25 天前
quick_install.md	refactor: 测试框架集成 Netlib BLAS/LAPACK，重构 6 个算子 golden 实现 Co-authored-by: xutianze<xutianze2@huawei.com> # message auto-generated for no-merge-commit merge: !154 merge refactor/test-framework into master refactor: 测试框架集成 Netlib BLAS/LAPACK，重构 6 个算子 golden 实现 Created-by: xutianze Commit-by: xutianze Merged-by: cann-robot Description: ## 描述集成 Netlib BLAS/LAPACK 参考库，新增 cblas_compat.h 适配层，将 6 个算子的 golden 实现替换为直接调用 CBLAS/LAPACK 函数。同时修复 sgeqrf_batched 算子的 tau 计算 bug，更新 agent 工作流文档。 ### 主要改动测试框架 - CMake 集成 Netlib BLAS/LAPACK（libblas + liblapack） - 新增 `test/utils/cblas_compat.h` 枚举映射适配层 - 修复 `fill.h` 中 `RANDOM` 填充范围（`-FLT_MAX` → `-1.0f`），避免 float 累加溢出 6 个算子 golden 替换 - sgemv → cblas_sgemv - sswap → cblas_sswap - stpmv → cblas_stpmv（改用 MERE_MARE 容差模式） - stpttr → LAPACK stpttr_ - strttp → LAPACK strttp_ - sgeqrf_batched → LAPACK sgeqrf_（含 kernel bug 修复）算子 bug 修复 - sgeqrf_batched kernel 在 sigma==0 时的 tau 计算逻辑错误，修正为统一设置 tau=0, alpha=x1 Agent 工作流更新 - 更新 `blas-ST-develop/SKILL.md`：新增 cblas_compat.h 章节，golden 改为直接调用 CBLAS/LAPACK - 更新 `tester.md`：核心原则、完成标准、技术实现适配新框架 - 更新 `task-prompts.md`：验收标准适配 ### 测试结果 Ascend 950 实板验证，6 个算子全部通过（0 失败，0 跳过）。 ## 关联的Issue [#150](https://gitcode.com/cann/ops-blas/issues/150) ## 测试 Ascend 950 实板验证： - sgemv: 64 用例全部通过 - sswap: 55 用例全部通过 - stpmv: 65 用例全部通过 - stpttr: 55 用例全部通过 - strttp: 55 用例全部通过 - sgeqrf_batched: 42 用例全部通过 ## 文档更新 - 更新 `agent/skills/blas-ST-develop/SKILL.md`：新增 BLAS/LAPACK 参考库章节，更新 golden 编写规范 - 更新 `agent/agents/tester.md`：适配新的 golden 框架 - 更新 `agent/skills/blas-new-op-workflow/references/task-prompts.md`：更新验收标准 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他，请描述：测试框架重构 See merge request: cann/ops-blas!154	12 天前