执行摘要

• 一句话：新增 NPU 模型迁移指南
• 推荐动作：建议如下：
  • NPU 适配开发人员：精读全文，重点关注训推一致性对齐、性能优化和 DSA 定制化适配章节。
  • 文档维护者：关注后续更新，确保配置和链接不过时。
  • 其他开发者：可快速浏览结构，了解 NPU 迁移全貌。

功能与动机

根据 PR 标题和描述，目的是为 Ascend NPU 增加模型迁移指导文档，降低开发者从 GPU 迁移至 NPU 的适配成本，提供标准化的实践流程。

实现拆解

实现过程如下：

1. 在 docs/ascend_tutorial/dev_guide/model_dev/ 创建了 transfer_to_npu_guide.md 文件，包含七大部分：前期准备、各组件联调打通（推理/训练引擎/Megatron-Bridge）、训推一致性对齐、高性能适配与调优（图模式、KV Cache 等）、长跑评测标准、DSA 定制化适配示例以及附录。
2. 在 docs/index.rst 的 toctree 中添加了该文件的引用，使其出现在文档索引中。
3. 经历了 7 次提交，根据审核反馈进行了迭代：修正了配置参数拼写错误（max_response_length）、清除了代码块中的 diff 留守前缀、调整了文档结构（如先通用概念后以 GLM5 为例、修改章节标题），并统一了语言风格（删除第一人称、采用官方口吻）。

关键文件：

• docs/ascend_tutorial/dev_guide/model_dev/transfer_to_npu_guide.md（模块 NPU 指南；类别 docs；类型 documentation；符号 DSAIndexer, forward_with_scores）: 新增的 NPU 模型迁移指南，是 PR 的核心内容，完整覆盖迁移全流程。
• docs/index.rst（模块 文档索引；类别 docs；类型 documentation）: 修改索引以链接新文档，确保新指南出现在文档目录中。

关键符号：DSAIndexer, forward_with_scores

评论区精华

审核中有 41 条评论，主要来自 gemini-code-assist[bot] 和 beirong8kmiles。关键讨论包括：

• 术语与格式修正：bot 指出 max_response_lenth 拼写错误、代码块含 diff 前缀、DeepSeekV32 术语错误，均在后续提交中修复。
• 文档结构优化：beirong8kmiles 建议先阐述通用理论再以 GLM5 为例，将“训练引擎选型”改为“训练引擎适配开发”，性能优化部分补充 profiling 工具引用。
• 语言风格统一：去掉“我们”等主观表述，改为官方口吻。

• 内容删减：删除 MindSpeed-LLM 等用户不应感知的细节。
  最终所有评论均已采纳并关闭。

• 配置参数拼写错误 (correctness): 在后续提交中已修正。

• 代码块格式清理 (style): 已修正为干净代码块。
• 文档结构通用性建议 (design): 这些建议被采纳，最终版本中增强了阐述的通用性。
• 语言风格统一 (style): 文档改为第三人称客观表述。

风险与影响

• 风险：风险较低。主要风险包括：

  • 术语/参数准确度：文档中引用的配置参数可能因版本更新而失效，需持续维护。
  • 外部链接失效：文档引用多个外部链接，长期可能失效。
  • 示例过时：以 GLM5 为例，若 GLM5 适配 PR 尚未合入，部分内容不具备直接参考性。
    建议建立文档定时审查机制。

• 影响：对 NPU 模型迁移开发者有重要参考价值：

  • 提供了一套完整、可复现的迁移流程，降低从 GPU 切换到 NPU 的学习和调试成本。
  • 覆盖了精度对齐和训推不一致等常见疑难问题，可减少开发者排查时间。
  • 作为团队内部培训材料，有助于统一迁移实践。
    影响范围仅限于文档模块，不涉及任何代码逻辑。

• 风险标记：术语与参数准确度, 格式与风格, 外部链接时效

关联脉络

• PR #6353 [doc] chore: verl Ascend doc refactor: 同为 Ascend 文档重构工作，与此 PR 重叠文件 docs/index.rst 和文档目录结构。
• PR #6347 [doc] refactor: added the document that collects statistics on models and algorithms that support the NPU: NPU 模型支持文档，与此 PR 的迁移指南相辅相成。
• PR #6339 [doc] chore: add npu advanced features: NPU 高级特性文档，与此 PR 的性能优化部分关联。