| Files | Last commit | Last update |
|---|---|---|
代码框架重构 Co-authored-by: wangrui<wangrui124@huawei.com> # message auto-generated for no-merge-commit merge: !393 merge master into master 代码框架重构 Created-by: wangrui_ Commit-by: wangrui Merged-by: cann-robot Description: <!-- 感谢您的合入申请! --> ### 当前PR是否有AI参与: [ ] 否 [x] 是 __1. AI Agent 平台: opencode（CLI 编程助手） __2. AI 模型: GLM（CANNBot/glm-5.3） __3. Prompt上下文 : 本仓 AGENTS.md + TTK 重构任务卡。AI 辅助范围：upstream 同步冲突解决、主线修复移植（bind_params）、测试治理 review、文档链接核查、本 PR 描述整理 ### PR功能描述 / 为什么需要这个合入**: TTK 代码框架重构（15 笔提交、583 文件，按主题组织，可分批 reviewing），核心目标：**分层归位、公开面收口、测试体系治理、主线同步**。 **一、目录与分层重组** - common 层域建设（W4-W15）：utilities/switches/process/dump/comparison/result/plugin/testcase/backend/xpu/profiler/instance 归位为 ttk/core_modules/common/* 单份契约代码 - 四通路目录重组与清场（W16-W20）：kernel/aclnn/framework_api/geir 换基，tests/ 目录树与 ttk/ 同构 **二、公开面收口** - scripts/common_public_surface.json 公开面名单 + pre-commit「ttk refactor guard」守护 - kernel/aclnn 公开面收口；mc2→hccl 改名；CLI 参数面治理（args_to_switches 四通路必经收口、--core-limit 统一解析） **三、模型与共性件上提** - Tensor 槽模型落地（声明/运行时槽位统一）、输入/golden 共性件上提 - 动态槽（-1）物化、参数级可变性上提、batch 一致性框架化、E2E 框架子目录化/编排步骤化 - W21-W24 扩展：设备状态泛化、E2E backward 一期、XPU 三方 golden、ttk-prof2case 技能（profiling 报告转用例） **四、GEIR/E2E 专项深化** - GEIR：manual-data 落盘口径统一与时序对齐、轮间一致性 MD5、模板 Data/Const 防重定义宏守卫 - E2E：-b/golden/mutability/xpu/open 后置系列改造、forkserver 预载框架感知修复（torch/TF libstdc++ 弱符号冲突）、eager 逐轮可变槽载体下沉 Backend.stage_mutable_rounds **五、主线同步（upstream/master e3fb50a + 9e74ae6）** - rebase 解决 6 处冲突（含 3 处文件迁移形态的 modify/delete 冲突、1 处双方同构修复） - **语义缺口补齐**：主线 e3fb50a bind_params 前序可选参数缺省占位修复（防后续参数左移错位——alpha 落 gamma 槽）移植至重构后 ttk/core_modules/common/xpu.py 单份契约 + TestBindParams 回归测试 - geir 模板 Data/Const OPS_PROTO_DEF_* 防重定义宏守卫（9e74ae6 同构合入） **六、测试体系治理（tests/common + utilities/remote/cli/config）** - 错位用例归位：framework_api/kernel 域（test_simple_param_extractor、test_super_kernel 拆分、test_xpu_perf_collect 拆分、test_e2e_simulator_backend） - 私有接口直调转公开入口 30+ 用例：compare_with_hooks / args_to_switches / TestcaseBase.validate / get_comparison().compare() - 重复与不可达用例清理、命名修复（testgenerate/testformat 两处缺下划线） - 白盒保留项均有归类（调度状态机/规则单元/parity 对拍/pins 守卫，公开路径需进程编排或活服务端） ### 该PR关联的issue *(格式为fixes #<issue号>, 或者resolves #<issue号>)*: fixes #305 ### 希望检视人员了解: - 大 PR（583 文件），建议按提交主题分批 reviewing（15 笔提交各自独立成篇） - review 收尾阶段 3 笔已 squash 为单笔（含主线同步与测试治理），历史已 force-push 整理 - 重构设计文档（TTK_Refactoring_Design 等 20 篇）按计划本地化，未随 PR 入库；行为基线见 scripts/refactor_baseline.json ## 测试 <!--描述进行了哪些测试来验证你的改动。--> - 全量单测：**2731 passed / 3 skipped（环境相关）/ 1 xfailed** - pre-commit 全绿：ruff check + ruff format + ttk refactor guard + codespell + OAT 合规检查 - 专项验证：主线 bind_params 错位场景实测（省略前序可选参数 gamma 时槽位对齐、无左移） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - README/README-EN、docs/ 40+ 篇随代码同步（Operator_Test_Guides/NPUSim/Task_Execution/Test_Case_Generation/FAQ 等） - 文档命名英文化（msdebug适配方法指南.md → msdebug_guide.md）；全仓 markdown 链接有效性核查（79 文件、含外部 URL 逐个验证，0 失效） - .claude/skills 五技能文档（含新增 ttk-prof2case：profiling 报告转用例） ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码框架重构（分层归位/公开面收口/测试治理 + 主线同步） See merge request: cann/ops-test-kit!393 | 1 month ago | |
代码框架重构 Co-authored-by: wangrui<wangrui124@huawei.com> # message auto-generated for no-merge-commit merge: !393 merge master into master 代码框架重构 Created-by: wangrui_ Commit-by: wangrui Merged-by: cann-robot Description: <!-- 感谢您的合入申请! --> ### 当前PR是否有AI参与: [ ] 否 [x] 是 __1. AI Agent 平台: opencode（CLI 编程助手） __2. AI 模型: GLM（CANNBot/glm-5.3） __3. Prompt上下文 : 本仓 AGENTS.md + TTK 重构任务卡。AI 辅助范围：upstream 同步冲突解决、主线修复移植（bind_params）、测试治理 review、文档链接核查、本 PR 描述整理 ### PR功能描述 / 为什么需要这个合入**: TTK 代码框架重构（15 笔提交、583 文件，按主题组织，可分批 reviewing），核心目标：**分层归位、公开面收口、测试体系治理、主线同步**。 **一、目录与分层重组** - common 层域建设（W4-W15）：utilities/switches/process/dump/comparison/result/plugin/testcase/backend/xpu/profiler/instance 归位为 ttk/core_modules/common/* 单份契约代码 - 四通路目录重组与清场（W16-W20）：kernel/aclnn/framework_api/geir 换基，tests/ 目录树与 ttk/ 同构 **二、公开面收口** - scripts/common_public_surface.json 公开面名单 + pre-commit「ttk refactor guard」守护 - kernel/aclnn 公开面收口；mc2→hccl 改名；CLI 参数面治理（args_to_switches 四通路必经收口、--core-limit 统一解析） **三、模型与共性件上提** - Tensor 槽模型落地（声明/运行时槽位统一）、输入/golden 共性件上提 - 动态槽（-1）物化、参数级可变性上提、batch 一致性框架化、E2E 框架子目录化/编排步骤化 - W21-W24 扩展：设备状态泛化、E2E backward 一期、XPU 三方 golden、ttk-prof2case 技能（profiling 报告转用例） **四、GEIR/E2E 专项深化** - GEIR：manual-data 落盘口径统一与时序对齐、轮间一致性 MD5、模板 Data/Const 防重定义宏守卫 - E2E：-b/golden/mutability/xpu/open 后置系列改造、forkserver 预载框架感知修复（torch/TF libstdc++ 弱符号冲突）、eager 逐轮可变槽载体下沉 Backend.stage_mutable_rounds **五、主线同步（upstream/master e3fb50a + 9e74ae6）** - rebase 解决 6 处冲突（含 3 处文件迁移形态的 modify/delete 冲突、1 处双方同构修复） - **语义缺口补齐**：主线 e3fb50a bind_params 前序可选参数缺省占位修复（防后续参数左移错位——alpha 落 gamma 槽）移植至重构后 ttk/core_modules/common/xpu.py 单份契约 + TestBindParams 回归测试 - geir 模板 Data/Const OPS_PROTO_DEF_* 防重定义宏守卫（9e74ae6 同构合入） **六、测试体系治理（tests/common + utilities/remote/cli/config）** - 错位用例归位：framework_api/kernel 域（test_simple_param_extractor、test_super_kernel 拆分、test_xpu_perf_collect 拆分、test_e2e_simulator_backend） - 私有接口直调转公开入口 30+ 用例：compare_with_hooks / args_to_switches / TestcaseBase.validate / get_comparison().compare() - 重复与不可达用例清理、命名修复（testgenerate/testformat 两处缺下划线） - 白盒保留项均有归类（调度状态机/规则单元/parity 对拍/pins 守卫，公开路径需进程编排或活服务端） ### 该PR关联的issue *(格式为fixes #<issue号>, 或者resolves #<issue号>)*: fixes #305 ### 希望检视人员了解: - 大 PR（583 文件），建议按提交主题分批 reviewing（15 笔提交各自独立成篇） - review 收尾阶段 3 笔已 squash 为单笔（含主线同步与测试治理），历史已 force-push 整理 - 重构设计文档（TTK_Refactoring_Design 等 20 篇）按计划本地化，未随 PR 入库；行为基线见 scripts/refactor_baseline.json ## 测试 <!--描述进行了哪些测试来验证你的改动。--> - 全量单测：**2731 passed / 3 skipped（环境相关）/ 1 xfailed** - pre-commit 全绿：ruff check + ruff format + ttk refactor guard + codespell + OAT 合规检查 - 专项验证：主线 bind_params 错位场景实测（省略前序可选参数 gamma 时槽位对齐、无左移） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - README/README-EN、docs/ 40+ 篇随代码同步（Operator_Test_Guides/NPUSim/Task_Execution/Test_Case_Generation/FAQ 等） - 文档命名英文化（msdebug适配方法指南.md → msdebug_guide.md）；全仓 markdown 链接有效性核查（79 文件、含外部 URL 逐个验证，0 失效） - .claude/skills 五技能文档（含新增 ttk-prof2case：profiling 报告转用例） ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码框架重构（分层归位/公开面收口/测试治理 + 主线同步） See merge request: cann/ops-test-kit!393 | 1 month ago | |
代码框架重构 Co-authored-by: wangrui<wangrui124@huawei.com> # message auto-generated for no-merge-commit merge: !393 merge master into master 代码框架重构 Created-by: wangrui_ Commit-by: wangrui Merged-by: cann-robot Description: <!-- 感谢您的合入申请! --> ### 当前PR是否有AI参与: [ ] 否 [x] 是 __1. AI Agent 平台: opencode（CLI 编程助手） __2. AI 模型: GLM（CANNBot/glm-5.3） __3. Prompt上下文 : 本仓 AGENTS.md + TTK 重构任务卡。AI 辅助范围：upstream 同步冲突解决、主线修复移植（bind_params）、测试治理 review、文档链接核查、本 PR 描述整理 ### PR功能描述 / 为什么需要这个合入**: TTK 代码框架重构（15 笔提交、583 文件，按主题组织，可分批 reviewing），核心目标：**分层归位、公开面收口、测试体系治理、主线同步**。 **一、目录与分层重组** - common 层域建设（W4-W15）：utilities/switches/process/dump/comparison/result/plugin/testcase/backend/xpu/profiler/instance 归位为 ttk/core_modules/common/* 单份契约代码 - 四通路目录重组与清场（W16-W20）：kernel/aclnn/framework_api/geir 换基，tests/ 目录树与 ttk/ 同构 **二、公开面收口** - scripts/common_public_surface.json 公开面名单 + pre-commit「ttk refactor guard」守护 - kernel/aclnn 公开面收口；mc2→hccl 改名；CLI 参数面治理（args_to_switches 四通路必经收口、--core-limit 统一解析） **三、模型与共性件上提** - Tensor 槽模型落地（声明/运行时槽位统一）、输入/golden 共性件上提 - 动态槽（-1）物化、参数级可变性上提、batch 一致性框架化、E2E 框架子目录化/编排步骤化 - W21-W24 扩展：设备状态泛化、E2E backward 一期、XPU 三方 golden、ttk-prof2case 技能（profiling 报告转用例） **四、GEIR/E2E 专项深化** - GEIR：manual-data 落盘口径统一与时序对齐、轮间一致性 MD5、模板 Data/Const 防重定义宏守卫 - E2E：-b/golden/mutability/xpu/open 后置系列改造、forkserver 预载框架感知修复（torch/TF libstdc++ 弱符号冲突）、eager 逐轮可变槽载体下沉 Backend.stage_mutable_rounds **五、主线同步（upstream/master e3fb50a + 9e74ae6）** - rebase 解决 6 处冲突（含 3 处文件迁移形态的 modify/delete 冲突、1 处双方同构修复） - **语义缺口补齐**：主线 e3fb50a bind_params 前序可选参数缺省占位修复（防后续参数左移错位——alpha 落 gamma 槽）移植至重构后 ttk/core_modules/common/xpu.py 单份契约 + TestBindParams 回归测试 - geir 模板 Data/Const OPS_PROTO_DEF_* 防重定义宏守卫（9e74ae6 同构合入） **六、测试体系治理（tests/common + utilities/remote/cli/config）** - 错位用例归位：framework_api/kernel 域（test_simple_param_extractor、test_super_kernel 拆分、test_xpu_perf_collect 拆分、test_e2e_simulator_backend） - 私有接口直调转公开入口 30+ 用例：compare_with_hooks / args_to_switches / TestcaseBase.validate / get_comparison().compare() - 重复与不可达用例清理、命名修复（testgenerate/testformat 两处缺下划线） - 白盒保留项均有归类（调度状态机/规则单元/parity 对拍/pins 守卫，公开路径需进程编排或活服务端） ### 该PR关联的issue *(格式为fixes #<issue号>, 或者resolves #<issue号>)*: fixes #305 ### 希望检视人员了解: - 大 PR（583 文件），建议按提交主题分批 reviewing（15 笔提交各自独立成篇） - review 收尾阶段 3 笔已 squash 为单笔（含主线同步与测试治理），历史已 force-push 整理 - 重构设计文档（TTK_Refactoring_Design 等 20 篇）按计划本地化，未随 PR 入库；行为基线见 scripts/refactor_baseline.json ## 测试 <!--描述进行了哪些测试来验证你的改动。--> - 全量单测：**2731 passed / 3 skipped（环境相关）/ 1 xfailed** - pre-commit 全绿：ruff check + ruff format + ttk refactor guard + codespell + OAT 合规检查 - 专项验证：主线 bind_params 错位场景实测（省略前序可选参数 gamma 时槽位对齐、无左移） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - README/README-EN、docs/ 40+ 篇随代码同步（Operator_Test_Guides/NPUSim/Task_Execution/Test_Case_Generation/FAQ 等） - 文档命名英文化（msdebug适配方法指南.md → msdebug_guide.md）；全仓 markdown 链接有效性核查（79 文件、含外部 URL 逐个验证，0 失效） - .claude/skills 五技能文档（含新增 ttk-prof2case：profiling 报告转用例） ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码框架重构（分层归位/公开面收口/测试治理 + 主线同步） See merge request: cann/ops-test-kit!393 | 1 month ago | |
docs+fix: NPUSim/priority 契约文档收敛；wheel 补齐默认 YAML；仿真超时整组回收；tiling dump uint8 序列化 Co-authored-by: wangrui<wangrui124@huawei.com> # message auto-generated for no-merge-commit merge: !470 merge br_issue into master docs+fix: NPUSim/priority 契约文档收敛；wheel 补齐默认 YAML；仿真超时整组回收；tiling dump uint8 序列化 Created-by: wangrui_ Commit-by: wangrui Merged-by: cann-robot Description: <!-- 感谢您的合入申请! --> ### 当前PR是否有AI参与: [ ] 否 [x] 是 __1. AI Agent 平台: OpenCode __2. AI 模型: deepseek-v4-pro __3. Prompt上下文 : TTK 运维工作流（issue 分析→修复→回归→提交） ### PR功能描述 / 为什么需要这个合入: 五笔小修复与文档收敛： 1. **NPUSim 文档判据矛盾（#366）**：设计文档第 2 节表格原写「退出码 0 = PASS」，与第 7/13 节「以 wrapper 结果文件为准」的契约矛盾，且原文暴露代码实现细节；改为功能化描述并指向 §7。 2. **priority 非负契约（#296）**：文档与 --priority help 明确仅支持非负整数（单值/闭区间/开放上界），消除「负数被当范围符解析」的契约歧义。 3. **wheel 默认 YAML 缺失（#316）**：pyproject package-data 补齐 config/*.yaml 与 remote/server/*.yaml；wheel 构建+隔离安装验证 load_config/load_server_config 恢复默认值（cascade.port_base=30000、providers=['torch']）。 4. **仿真超时后代进程残留（#326）**：npusim_runner 改为独立会话启动（start_new_session），超时/中断时对整组 SIGTERM→宽限→SIGKILL 后回收并排空管道；补 2 个假进程回归（超时/KeyboardInterrupt 后 wrapper 后代必死）。 5. **tiling bytes dump 格式无效（#341）**：无 dtype 的 bytes 走 npy/pt 时按一维 uint8 数组序列化，numpy.load/torch.load 可读且逐字节保真；bin 保持原始字节；读侧无影响（manual_data 忽略 tiling 调试文件）。 ### 该PR关联的issue fixes #366, fixes #296, fixes #316, fixes #326, fixes #341 ### 希望检视人员了解: - #316 验证在本机完成（Python 3.12.9/setuptools 82），仓库 CI 无 wheel 构建任务； - #326 回归为纯假进程，无 CANN/NPU 依赖； - 本地 commit 因 .gitignore 的 dump/ 误伤需 -f 暂存 dump 目录文件（既有仓库问题，未在本次修）。 ## 测试 - pytest tests/core_modules/common/simulator/test_simulator_backend.py：42 passed - pytest tests/core_modules/common/dump/test_dumper.py：32 passed - ruff check / ruff format / pre-commit 全部通过 - #316：pip wheel --no-build-isolation 构建成功；隔离安装后 default.yaml 存在、配置解析与源码一致 ## 文档更新 - docs/NPUSim/npusim_design.md - docs/Task_Execution.md、docs/Test_Case_Generation.md - ttk/cli/common.py（--priority help 文案） ## 类型标签 - [x] Bug修复 - [x] 文档更新 See merge request: cann/ops-test-kit!470 | 26 days ago | |
代码框架重构 Co-authored-by: wangrui<wangrui124@huawei.com> # message auto-generated for no-merge-commit merge: !393 merge master into master 代码框架重构 Created-by: wangrui_ Commit-by: wangrui Merged-by: cann-robot Description: <!-- 感谢您的合入申请! --> ### 当前PR是否有AI参与: [ ] 否 [x] 是 __1. AI Agent 平台: opencode（CLI 编程助手） __2. AI 模型: GLM（CANNBot/glm-5.3） __3. Prompt上下文 : 本仓 AGENTS.md + TTK 重构任务卡。AI 辅助范围：upstream 同步冲突解决、主线修复移植（bind_params）、测试治理 review、文档链接核查、本 PR 描述整理 ### PR功能描述 / 为什么需要这个合入**: TTK 代码框架重构（15 笔提交、583 文件，按主题组织，可分批 reviewing），核心目标：**分层归位、公开面收口、测试体系治理、主线同步**。 **一、目录与分层重组** - common 层域建设（W4-W15）：utilities/switches/process/dump/comparison/result/plugin/testcase/backend/xpu/profiler/instance 归位为 ttk/core_modules/common/* 单份契约代码 - 四通路目录重组与清场（W16-W20）：kernel/aclnn/framework_api/geir 换基，tests/ 目录树与 ttk/ 同构 **二、公开面收口** - scripts/common_public_surface.json 公开面名单 + pre-commit「ttk refactor guard」守护 - kernel/aclnn 公开面收口；mc2→hccl 改名；CLI 参数面治理（args_to_switches 四通路必经收口、--core-limit 统一解析） **三、模型与共性件上提** - Tensor 槽模型落地（声明/运行时槽位统一）、输入/golden 共性件上提 - 动态槽（-1）物化、参数级可变性上提、batch 一致性框架化、E2E 框架子目录化/编排步骤化 - W21-W24 扩展：设备状态泛化、E2E backward 一期、XPU 三方 golden、ttk-prof2case 技能（profiling 报告转用例） **四、GEIR/E2E 专项深化** - GEIR：manual-data 落盘口径统一与时序对齐、轮间一致性 MD5、模板 Data/Const 防重定义宏守卫 - E2E：-b/golden/mutability/xpu/open 后置系列改造、forkserver 预载框架感知修复（torch/TF libstdc++ 弱符号冲突）、eager 逐轮可变槽载体下沉 Backend.stage_mutable_rounds **五、主线同步（upstream/master e3fb50a + 9e74ae6）** - rebase 解决 6 处冲突（含 3 处文件迁移形态的 modify/delete 冲突、1 处双方同构修复） - **语义缺口补齐**：主线 e3fb50a bind_params 前序可选参数缺省占位修复（防后续参数左移错位——alpha 落 gamma 槽）移植至重构后 ttk/core_modules/common/xpu.py 单份契约 + TestBindParams 回归测试 - geir 模板 Data/Const OPS_PROTO_DEF_* 防重定义宏守卫（9e74ae6 同构合入） **六、测试体系治理（tests/common + utilities/remote/cli/config）** - 错位用例归位：framework_api/kernel 域（test_simple_param_extractor、test_super_kernel 拆分、test_xpu_perf_collect 拆分、test_e2e_simulator_backend） - 私有接口直调转公开入口 30+ 用例：compare_with_hooks / args_to_switches / TestcaseBase.validate / get_comparison().compare() - 重复与不可达用例清理、命名修复（testgenerate/testformat 两处缺下划线） - 白盒保留项均有归类（调度状态机/规则单元/parity 对拍/pins 守卫，公开路径需进程编排或活服务端） ### 该PR关联的issue *(格式为fixes #<issue号>, 或者resolves #<issue号>)*: fixes #305 ### 希望检视人员了解: - 大 PR（583 文件），建议按提交主题分批 reviewing（15 笔提交各自独立成篇） - review 收尾阶段 3 笔已 squash 为单笔（含主线同步与测试治理），历史已 force-push 整理 - 重构设计文档（TTK_Refactoring_Design 等 20 篇）按计划本地化，未随 PR 入库；行为基线见 scripts/refactor_baseline.json ## 测试 <!--描述进行了哪些测试来验证你的改动。--> - 全量单测：**2731 passed / 3 skipped（环境相关）/ 1 xfailed** - pre-commit 全绿：ruff check + ruff format + ttk refactor guard + codespell + OAT 合规检查 - 专项验证：主线 bind_params 错位场景实测（省略前序可选参数 gamma 时槽位对齐、无左移） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - README/README-EN、docs/ 40+ 篇随代码同步（Operator_Test_Guides/NPUSim/Task_Execution/Test_Case_Generation/FAQ 等） - 文档命名英文化（msdebug适配方法指南.md → msdebug_guide.md）；全仓 markdown 链接有效性核查（79 文件、含外部 URL 逐个验证，0 失效） - .claude/skills 五技能文档（含新增 ttk-prof2case：profiling 报告转用例） ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码框架重构（分层归位/公开面收口/测试治理 + 主线同步） See merge request: cann/ops-test-kit!393 | 1 month ago | |
代码框架重构 Co-authored-by: wangrui<wangrui124@huawei.com> # message auto-generated for no-merge-commit merge: !393 merge master into master 代码框架重构 Created-by: wangrui_ Commit-by: wangrui Merged-by: cann-robot Description: <!-- 感谢您的合入申请! --> ### 当前PR是否有AI参与: [ ] 否 [x] 是 __1. AI Agent 平台: opencode（CLI 编程助手） __2. AI 模型: GLM（CANNBot/glm-5.3） __3. Prompt上下文 : 本仓 AGENTS.md + TTK 重构任务卡。AI 辅助范围：upstream 同步冲突解决、主线修复移植（bind_params）、测试治理 review、文档链接核查、本 PR 描述整理 ### PR功能描述 / 为什么需要这个合入**: TTK 代码框架重构（15 笔提交、583 文件，按主题组织，可分批 reviewing），核心目标：**分层归位、公开面收口、测试体系治理、主线同步**。 **一、目录与分层重组** - common 层域建设（W4-W15）：utilities/switches/process/dump/comparison/result/plugin/testcase/backend/xpu/profiler/instance 归位为 ttk/core_modules/common/* 单份契约代码 - 四通路目录重组与清场（W16-W20）：kernel/aclnn/framework_api/geir 换基，tests/ 目录树与 ttk/ 同构 **二、公开面收口** - scripts/common_public_surface.json 公开面名单 + pre-commit「ttk refactor guard」守护 - kernel/aclnn 公开面收口；mc2→hccl 改名；CLI 参数面治理（args_to_switches 四通路必经收口、--core-limit 统一解析） **三、模型与共性件上提** - Tensor 槽模型落地（声明/运行时槽位统一）、输入/golden 共性件上提 - 动态槽（-1）物化、参数级可变性上提、batch 一致性框架化、E2E 框架子目录化/编排步骤化 - W21-W24 扩展：设备状态泛化、E2E backward 一期、XPU 三方 golden、ttk-prof2case 技能（profiling 报告转用例） **四、GEIR/E2E 专项深化** - GEIR：manual-data 落盘口径统一与时序对齐、轮间一致性 MD5、模板 Data/Const 防重定义宏守卫 - E2E：-b/golden/mutability/xpu/open 后置系列改造、forkserver 预载框架感知修复（torch/TF libstdc++ 弱符号冲突）、eager 逐轮可变槽载体下沉 Backend.stage_mutable_rounds **五、主线同步（upstream/master e3fb50a + 9e74ae6）** - rebase 解决 6 处冲突（含 3 处文件迁移形态的 modify/delete 冲突、1 处双方同构修复） - **语义缺口补齐**：主线 e3fb50a bind_params 前序可选参数缺省占位修复（防后续参数左移错位——alpha 落 gamma 槽）移植至重构后 ttk/core_modules/common/xpu.py 单份契约 + TestBindParams 回归测试 - geir 模板 Data/Const OPS_PROTO_DEF_* 防重定义宏守卫（9e74ae6 同构合入） **六、测试体系治理（tests/common + utilities/remote/cli/config）** - 错位用例归位：framework_api/kernel 域（test_simple_param_extractor、test_super_kernel 拆分、test_xpu_perf_collect 拆分、test_e2e_simulator_backend） - 私有接口直调转公开入口 30+ 用例：compare_with_hooks / args_to_switches / TestcaseBase.validate / get_comparison().compare() - 重复与不可达用例清理、命名修复（testgenerate/testformat 两处缺下划线） - 白盒保留项均有归类（调度状态机/规则单元/parity 对拍/pins 守卫，公开路径需进程编排或活服务端） ### 该PR关联的issue *(格式为fixes #<issue号>, 或者resolves #<issue号>)*: fixes #305 ### 希望检视人员了解: - 大 PR（583 文件），建议按提交主题分批 reviewing（15 笔提交各自独立成篇） - review 收尾阶段 3 笔已 squash 为单笔（含主线同步与测试治理），历史已 force-push 整理 - 重构设计文档（TTK_Refactoring_Design 等 20 篇）按计划本地化，未随 PR 入库；行为基线见 scripts/refactor_baseline.json ## 测试 <!--描述进行了哪些测试来验证你的改动。--> - 全量单测：**2731 passed / 3 skipped（环境相关）/ 1 xfailed** - pre-commit 全绿：ruff check + ruff format + ttk refactor guard + codespell + OAT 合规检查 - 专项验证：主线 bind_params 错位场景实测（省略前序可选参数 gamma 时槽位对齐、无左移） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - README/README-EN、docs/ 40+ 篇随代码同步（Operator_Test_Guides/NPUSim/Task_Execution/Test_Case_Generation/FAQ 等） - 文档命名英文化（msdebug适配方法指南.md → msdebug_guide.md）；全仓 markdown 链接有效性核查（79 文件、含外部 URL 逐个验证，0 失效） - .claude/skills 五技能文档（含新增 ttk-prof2case：profiling 报告转用例） ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码框架重构（分层归位/公开面收口/测试治理 + 主线同步） See merge request: cann/ops-test-kit!393 | 1 month ago | |
代码框架重构 Co-authored-by: wangrui<wangrui124@huawei.com> # message auto-generated for no-merge-commit merge: !393 merge master into master 代码框架重构 Created-by: wangrui_ Commit-by: wangrui Merged-by: cann-robot Description: <!-- 感谢您的合入申请! --> ### 当前PR是否有AI参与: [ ] 否 [x] 是 __1. AI Agent 平台: opencode（CLI 编程助手） __2. AI 模型: GLM（CANNBot/glm-5.3） __3. Prompt上下文 : 本仓 AGENTS.md + TTK 重构任务卡。AI 辅助范围：upstream 同步冲突解决、主线修复移植（bind_params）、测试治理 review、文档链接核查、本 PR 描述整理 ### PR功能描述 / 为什么需要这个合入**: TTK 代码框架重构（15 笔提交、583 文件，按主题组织，可分批 reviewing），核心目标：**分层归位、公开面收口、测试体系治理、主线同步**。 **一、目录与分层重组** - common 层域建设（W4-W15）：utilities/switches/process/dump/comparison/result/plugin/testcase/backend/xpu/profiler/instance 归位为 ttk/core_modules/common/* 单份契约代码 - 四通路目录重组与清场（W16-W20）：kernel/aclnn/framework_api/geir 换基，tests/ 目录树与 ttk/ 同构 **二、公开面收口** - scripts/common_public_surface.json 公开面名单 + pre-commit「ttk refactor guard」守护 - kernel/aclnn 公开面收口；mc2→hccl 改名；CLI 参数面治理（args_to_switches 四通路必经收口、--core-limit 统一解析） **三、模型与共性件上提** - Tensor 槽模型落地（声明/运行时槽位统一）、输入/golden 共性件上提 - 动态槽（-1）物化、参数级可变性上提、batch 一致性框架化、E2E 框架子目录化/编排步骤化 - W21-W24 扩展：设备状态泛化、E2E backward 一期、XPU 三方 golden、ttk-prof2case 技能（profiling 报告转用例） **四、GEIR/E2E 专项深化** - GEIR：manual-data 落盘口径统一与时序对齐、轮间一致性 MD5、模板 Data/Const 防重定义宏守卫 - E2E：-b/golden/mutability/xpu/open 后置系列改造、forkserver 预载框架感知修复（torch/TF libstdc++ 弱符号冲突）、eager 逐轮可变槽载体下沉 Backend.stage_mutable_rounds **五、主线同步（upstream/master e3fb50a + 9e74ae6）** - rebase 解决 6 处冲突（含 3 处文件迁移形态的 modify/delete 冲突、1 处双方同构修复） - **语义缺口补齐**：主线 e3fb50a bind_params 前序可选参数缺省占位修复（防后续参数左移错位——alpha 落 gamma 槽）移植至重构后 ttk/core_modules/common/xpu.py 单份契约 + TestBindParams 回归测试 - geir 模板 Data/Const OPS_PROTO_DEF_* 防重定义宏守卫（9e74ae6 同构合入） **六、测试体系治理（tests/common + utilities/remote/cli/config）** - 错位用例归位：framework_api/kernel 域（test_simple_param_extractor、test_super_kernel 拆分、test_xpu_perf_collect 拆分、test_e2e_simulator_backend） - 私有接口直调转公开入口 30+ 用例：compare_with_hooks / args_to_switches / TestcaseBase.validate / get_comparison().compare() - 重复与不可达用例清理、命名修复（testgenerate/testformat 两处缺下划线） - 白盒保留项均有归类（调度状态机/规则单元/parity 对拍/pins 守卫，公开路径需进程编排或活服务端） ### 该PR关联的issue *(格式为fixes #<issue号>, 或者resolves #<issue号>)*: fixes #305 ### 希望检视人员了解: - 大 PR（583 文件），建议按提交主题分批 reviewing（15 笔提交各自独立成篇） - review 收尾阶段 3 笔已 squash 为单笔（含主线同步与测试治理），历史已 force-push 整理 - 重构设计文档（TTK_Refactoring_Design 等 20 篇）按计划本地化，未随 PR 入库；行为基线见 scripts/refactor_baseline.json ## 测试 <!--描述进行了哪些测试来验证你的改动。--> - 全量单测：**2731 passed / 3 skipped（环境相关）/ 1 xfailed** - pre-commit 全绿：ruff check + ruff format + ttk refactor guard + codespell + OAT 合规检查 - 专项验证：主线 bind_params 错位场景实测（省略前序可选参数 gamma 时槽位对齐、无左移） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - README/README-EN、docs/ 40+ 篇随代码同步（Operator_Test_Guides/NPUSim/Task_Execution/Test_Case_Generation/FAQ 等） - 文档命名英文化（msdebug适配方法指南.md → msdebug_guide.md）；全仓 markdown 链接有效性核查（79 文件、含外部 URL 逐个验证，0 失效） - .claude/skills 五技能文档（含新增 ttk-prof2case：profiling 报告转用例） ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码框架重构（分层归位/公开面收口/测试治理 + 主线同步） See merge request: cann/ops-test-kit!393 | 1 month ago |
| Files | Last commit | Last update |
|---|---|---|
| 1 month ago | ||
| 1 month ago | ||
| 1 month ago | ||
| 26 days ago | ||
| 1 month ago | ||
| 1 month ago | ||
| 1 month ago |