尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

10. 验证包编译运行结果

10. 验证包编译运行结果 10. 验证包编译运行结果【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime项目结果CANN 路径${实际使用的路径}cmake 配置✅ 成功编译✅ 成功运行✅ 成功输出验证✅ 包含 Sample run successfully修复次数0 次或 N 次附修复记录如果经历了修复还需附上修复记录 markdown **修复记录** | 次数 | 阶段 | 错误信息 | 修复操作 | |------|------|---------|---------| | 1 | 编译 | undefined reference to xxx | CMakeLists.txt 添加 xxx 库 |6. 断点记录格式与类型每个断点按以下格式记录--------------------------------------------------------------------- | 断点 #N | | 问题类型Runtime 缺陷 / 外源知识缺失 / 体验问题 | | 发生步骤Step X - 步骤名称 | | 问题描述我在尝试做什么遇到了什么障碍 | | 查找过程我在哪些文件中查找过列出具体路径 | | Runtime 文档中的相关内容有/无若有覆盖了什么遗漏了什么 | | 示例代码中的相关内容有/无若有覆盖了什么遗漏了什么 | | 缺失资料具体缺少哪个文档 / 哪个 API 的说明 | | 影响程度阻塞点真正阻断开发无法继续/ 优化点可解决但过程复杂 | | [推测]根据类似框架经验的猜测标注为推测不计入产出 | | 期望补充理想情况下该有什么资料建议由哪方补充 | ---------------------------------------------------------------------断点类型说明Runtime 缺陷—— 问题在 Runtime 仓库的责任范围内Runtime 维护的 API 文档、示例、构建说明等外源知识缺失—— 非 Runtime 仓库职责范围的知识缺失如aclCreateTensor、aclCreateScalar等外部组件 API 的用法aclnn 算子签名等。记录但不计入 Runtime 整改项仅作为分析过程的完整性补充说明开发者在此处需要依赖外部资料体验问题—— 不阻塞功能但影响开发效率或学习体验。7. 卡点判定规则责任归属Runtime 仓与非 Runtime 仓的职责边界明确划分不设灰色地带卡住的环节责任归属处理方式aclInit / aclrtSetDevice / aclrtCreateStreamRuntime 仓记录为Runtime 缺陷Device/Context/Stream 的初始化和管理Runtime 仓记录为Runtime 缺陷内存分配、拷贝、释放的 API 用法Runtime 仓记录为Runtime 缺陷aclrtSynchronizeStream / aclrtDestroyStream 等Runtime 仓记录为Runtime 缺陷Runtime 在 CANN 软件栈中的位置Runtime 仓记录为Runtime 缺陷两段式调用范式GetWorkspaceSize → Execute 概念非 Runtime 仓优先查references/aclnn-two-phase-calling.md和reference/ops-math/docs/zh/context/两段式接口.md记录为外源知识缺失workspace / executor 概念非 Runtime 仓优先查references/aclnn-two-phase-calling.md记录为外源知识缺失aclCreateTensor / aclDestroyTensor 的用法非 Runtime 仓优先查reference/不足时向用户求助记录为外源知识缺失aclCreateScalar / aclDestroyScalar 的用法非 Runtime 仓优先查reference/不足时向用户求助记录为外源知识缺失目标算子 GetWorkspaceSize / Execute 的具体参数含义非 Runtime 仓优先查reference/不足时向用户求助记录为外源知识缺失aclnn 相关头文件和链接库说明非 Runtime 仓优先查reference/不足时向用户求助记录为外源知识缺失aclnnStatus 错误码非 Runtime 仓优先查reference/不足时向用户求助记录为外源知识缺失判断原则该 API/概念是否由 Runtime 仓库维护是 → Runtime 缺陷否 → 外源知识缺失。不存在中间状态。8. 执行约束算子信息为前置必要条件算子的详细信息功能、签名、Tensor、Scalar 等必须在分析前获取。获取优先级先从reference/外源知识仓库搜索不足时再向用户求助。不得自行猜测或基于经验补全外源知识不得猜测遇到非 Runtime 仓库职责范围内的知识缺失时如aclCreateTensor、aclCreateScalar、workspace/executor 概念、aclnn 头文件/库文件等优先从reference/目录下的外源知识仓库中查找如果reference/中也无法找到再暂停并向用户求助不得自行猜测或脑补。此类缺失记录为外源知识缺失类型不计入 Runtime 整改项全程自主执行在算子信息确认后遇到 Runtime 断点记录后继续推进遇到外源知识需求时优先查reference/reference/不足时再暂停求助用户严格遵守知识来源规则Runtime API 只看仓库文档非 Runtime API 优先查reference/、不足时向用户求助遇到资料缺失不假设Runtime 范畴的如实记录为断点非 Runtime 范畴的向用户求助并记录为外源知识缺失以第一人称叙述还原真实探索路径不得跳过任何步骤即使预判会卡住也要尝试并记录。9. 输出内容与报告结构分析完成后输出以下内容写入reports/目录。输出文件名使用执行前准备中确定的版本号分析报告reports/cann_runtime_blockpoint_analysis_{算子名}_v{版本号}.md整改清单reports/cann_runtime_blockpoint_todolist_{算子名}_v{版本号}.md验证包目录reports/{算子名小写}_verify/如reports/aclnnadd_verify/、reports/aclnnmatmul_verify/9.1 开发过程叙述以第一人称按 Step 1~10 顺序完整叙述开发探索过程。每个步骤包含做了什么 → 查了哪些资料 → 结果如何 → 是否遇到断点。9.2 API 资料支撑情况表汇总每个 API 的文档覆盖情况格式见 Step 5 表格。9.3 最终代码产出输出尽可能完整的目标算子调用代码。无法填充的部分用[UNKNOWN: 原因]占位标注。9.4 代码完成度统计Runtime 相关步骤N 步 ├─ 可完成有明确文档支撑N 步 ├─ 可完成但体验差需复杂查找N 步优化点 └─ 无法完成资料缺失导致阻断N 步阻塞点 代码完成率仅 Runtime 部分XX%9.5 断点汇总表#类型步骤问题描述查找过的文件缺失资料影响程度9.6 断点统计Runtime 缺陷N 个阻塞点 M 个 / 优化点 M 个 外源知识缺失N 个不计入 Runtime 整改仅供参考 体验问题N 个 阻塞点总计仅 Runtime 缺陷N 个9.7 断裂地图全链路断点分布可视化用文本图示展示 Step 1→8 的全链路中哪些位置发生了断点Step 9-10 为验证包生成与编译运行不纳入断裂地图Step1 ──→ Step2 ──→ Step3 ──→ Step4 ──→ Step5 ──→ Step6 ──→ Step7 ──→ Step8 ✅ ✅ #1 #2 ✅ #3 #4 ✅图例✅ 顺畅 | 阻塞点Runtime 缺陷真正阻断开发 | 优化点Runtime 缺陷可解决但体验差 | 外源知识缺失9.8 整改 TodoList断点分析完成后立即基于断点汇总表生成整改 TodoList写入整改清单文件与分析报告使用相同版本号。优先级映射规则阻塞点 → P0立即修复—— 真正阻断开发过程无法继续优化点 → P1近期改善—— 通过复杂查找可解决但体验差。每条任务格式- [ ] **T-P0-001 [标签]** 任务标题 问题断点描述定位到文件/函数/章节 目标改进后应达到的状态 行动具体操作步骤 负责模块docs / example / 根目录 关联断点#N任务标签每条任务必选一个[API文档][编程模型][示例代码][错误处理][构建系统][开发者体验]。生成规则每个断点至少对应一条任务不得遗漏可将同类断点合并为一条任务需在任务中列出所有关联断点编号文件头包含关联报告、生成日期、统计概览P0/P1 各 N 项、完成进度条。9.9 验证包按照 Step 9 的要求生成完整可编译的验证包写入reports/{算子名小写}_verify/目录。验证包输出文件清单以 aclnnadd 为例reports/aclnnadd_verify/ ├── README.md 使用说明 ├── CMakeLists.txt 标准 C 项目配置 ├── main.cpp Host 代码aclnn 两段式调用完整流程 ├── run.sh 一键编译运行验证脚本 └── scripts/ ├── gen_data.py 数据生成 └── verify_result.py 精度验证【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表