分册 3准备环境并验证含 4.0 门禁【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills对应主流程§4。在执行任何 NPU 训练/推理测试命令之前必须先完成 §4.0。顺序可行性预判part-02→ 本分册 → 代码级迁移part-04。定位与边界维度说明目标确认「目录与快照就绪 → 机器事实可观测 → 工程文档与依赖可对照 → 给出 AUTO / MANUAL_STOP / UNKNOWN → 仅在 AUTO 下落实环境与自检」门禁§4.0硬卡点不过 §4.0.3 的适配判定并落盘不得建议或执行 NPU 训练/推理全链路与 part-02 区别可行性回答「怎么改」门禁回答「当前环境能不能跑、缺什么、能否自动化补齐」本阶段不做不替用户离线安装 CANN/驱动MANUAL_STOP 时只出手动清单不在 UNKNOWN 下擅自升级系统级 Ascend 套件命令约定本分册不写死shell/PowerShell只读检测的命令级参考见 part-07-commands.md落实目标见environment-setup-objectives.md流程总览4.0.0可选快速检查路径 ── 仅适配核查时从本节入口进入 │ ▼ 4.0.1 目录 environment.md 机器快照沙箱内 → 必要时沙箱外复检 │ ▼ 4.0.2 阅读 README / requirements / Docker 等工程期望 │ ▼ 4.0.3 对照判定AUTO | MANUAL_STOP | UNKNOWN → 写入 environment.md │ ├── MANUAL_STOP / 未解决的 UNKNOWN ──► 手动需求清单暂停 NPU 自动化 │ └── AUTO ──► 4.1 本机检测与执行策略 ──► 4.2 环境目标落实 ──► part-044.0.0 快速检查路径仅「检查当前 NPU 适配情况」当用户明确要求「检查当前 NPU 适配情况」而非完整迁移时项行为入口从本分册开始跳过part-01/02 的完整基线与可行性除非用户已提供上下文执行范围§4.0.14.0.3 必要时 §4.1 只读检测更新environment.md输出适配结论AUTO / MANUAL_STOP / UNKNOWN、证据摘要、待补齐项不进入part-0405、part-08 完整归档part-06/07/09 仅完整迁移失败路径按需说明回复中须写明「本次为适配状态检查路径未执行完整迁移链路」完整迁移仍须按 workflow.md 走 part-01 → 02 →03→ 04…4.0 环境与依赖门禁必须作为环境步骤起点在执行任何NPU 训练/推理测试命令之前agent 必须按下列顺序完成不得跳过environment.md与文档/依赖适配判定。4.0.1 第一步目录、路径与environment.md机器快照A. 目录迁移开始时最先检查项目根下是否存在mig_docs/不存在则创建空目录方式随 OS/团队规范此处不规定命令。不要求此时已有Mig_report.md等模板目录可先空仅保证路径存在。B. 路径约定路径用途mig_docs/working/environment.md环境快照唯一权威落盘结构见 ../mig_docs/working/environment.md已存在则先读再更新历史遗留mig_docs/env.md、env.md.exe等有效内容合并入environment.md后删除旧文件C. 机器事实检测沙箱内 → 沙箱外目标Ascend/CANN、驱动可见性、框架 Ascend 插件、Python/venv 等可观测事实写入快照。阶段动作A 沙箱内执行npu-smi info、Python/框架依赖检查可选 CANN 工具链版本自检B 沙箱外触发条件沙箱内出现无设备信息、输出为空、报错、时有时无等不稳定 →必须在宿主机/真实终端用同一组命令复检后再写结论采信environment.md记录沙箱内/外两侧结果以可直接用于目标部署环境的一侧为准并注明原因安全沙箱外仅只读检测未授权不做破坏性系统变更D. 推荐操作将docs/environment-setup-objectives.md并入目标工程 Runbook证据写入mig_docs/working/environment.md。迁移过程中持续更新Mig_report.md、Mig_Readme.md、Compare.md与environment.md刷新快照时覆盖更新避免与过期事实混用。4.0.2 第二步阅读工程文档与依赖声明适配性输入在已有environment.md机器快照后阅读并摘录不存在则标 N/A来源摘录要点README / docs 安装说明Python、OS、CUDA/GPU、是否声明 CANN/昇腾版本或官方样例requirements*.txt、environment.yml、pyproject.toml、Dockerfile等Python 与关键包版本约束model/README、复现脚本说明与主 README 是否冲突摘录须能回答工程期望的 Python/框架版本区间、是否与仅 GPU/CUDA 强绑定、是否要求特定 CANN/驱动/芯片工具链。4.0.3 第三步适配性判定与「停止线」将4.0.1 机器事实与4.0.2 文档声明对照判定并写入environment.md「依赖与 README/requirements 适配判定」节及对话摘要判定含义agent 动作AUTO差距主要为缺 venv、缺可通过 pip或文档允许的等价方式安装的包npu-smi与框架 Ascend 插件已满足或用户确认本机 CANN无需更换继续§4.14.2按environment-setup-objectives.md落实 venv、依赖、set_env、自检更新environment.mdMANUAL_STOP任一成立文档要求的CANN 主版本 / 驱动 / Toolkit与现机不一致且需重新下载或离线安装目标SoC与工具链不匹配需换套件OS/glibc不满足硬门槛README 要求仅官方容器/镜像且当前无法复现停止自动化 NPU 训练/推理与大规模 pip 覆盖系统栈输出手动需求清单包名/链接、版本、芯片、驱动与 CANN 对应、建议顺序写明「待用户完成后再从 4.0.1 刷新environment.md」UNKNOWN关键信息缺失未写 CANN 版本、多份 README 冲突等先提问或标注假设假设未确认前CANN/驱动相关危险操作按 MANUAL_STOP 保守处理须写入记录判定结果、摘录要点MANUAL_STOP 时完整手动需求清单。同步摘要到Mig_report§3环境与Summary.md§4.1。4.0.4 分支仅 AUTO 进入 4.14.2AUTO可进入 §4.1「可直接测试」评估与 §4.2 环境落实。MANUAL_STOP§4.0 之后暂停代码级迁移与 NPU 测试自动化仍可只读刷新environment.md。UNKNOWN在澄清前视同MANUAL_STOP 处理系统级 Ascend 变更。AUTO 通过后仍须核对可与environment.md对照NPU 驱动/设备可见性npu-smi或等价框架 Ascend 插件可导入且版本与 CANN 匹配torch_npu/ MindSpore Ascend 等运行时库路径 / set_env 已按 CANN 说明加载4.1 本机环境检测与执行策略在给任何 NPU 测试命令前先输出「检测结论 执行策略」。必检项npu-smi info、Python 版本、框架 Ascend 插件可导入可选CANN 工具链版本数据集路径与Mig_Readme§3.1 对齐时沙箱策略与 §4.0.1 一致先给沙箱内结论npu-smi/ 插件检测不到或不稳定→必须沙箱外复检沙箱内 FAIL、沙箱外 PASS → 标注「沙箱限制不等同宿主缺失」内外均 FAIL → 按真实缺失处理补齐清单或重新评估 MANUAL_STOP执行策略判定条件策略NPU 可见 框架插件 依赖 数据若需要均就绪可直接执行测试进入 part-04 Phase 1任一关键项缺失不直接执行测试输出environment-setup-objectives.md落地方案 待补齐项建议输出格式检测项 | 沙箱内结果 | 沙箱外结果 | 最终判定 | 影响 | 建议动作4.2 环境准备落地对齐environment-setup-objectives.md逐项标明已完成 / 待用户 / 阻塞原因证据写入mig_docs/working/environment.md。判定4.2 范围AUTOvenv 或等价隔离、按 README/requirements 装依赖、CANN set_env、npu-smi与插件自检、若适用与Mig_Readme§3.1 数据路径核对MANUAL_STOP不宣称环境已可跑 NPU 训练/推理可做只读检测并刷新environment.md指向手动需求清单输出要求在对话或Mig_report§3 给出自检结论表项 → 沙箱内/外 → 采信 → 下一步不在本节粘贴冗长可执行命令块用户未授权本机操作时仅输出目标清单与待用户动作不擅自代跑环境摘要表建议写入Mig_report§3与environment.md互链项值机器/板卡型号npu-smi关键信息驱动/设备CANN / 框架 Ascend 插件版本目标硬件Ascend 型号4.0.3 判定AUTO / MANUAL_STOP / UNKNOWN交付物清单本分册收口交付物内容mig_docs/working/environment.md机器快照、沙箱内/外结果、4.0.2 摘录、4.0.3 判定、手动清单若有对话 /Mig_report§34.0.3 一行结论、执行策略直接测试 / 仅落地方案、自检摘要表快速检查路径上述 明确声明未进入完整迁移关联索引上一环节part-02-feasibility.md下一环节part-04-code-migration.md须 AUTO 或 MANUAL_STOP 已人工闭环并刷新快照环境目标清单docs/environment-setup-objectives.md快照骨架../mig_docs/working/environment.md交付与 Checklistpart-08-checklist-deliverables-output.md命令模板part-07-commands.md流程总览workflow.md 步 3、快速路径【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考