## 简介

昇腾全面支持 Verl 使用与开发，本文档全面介绍了如何在华为昇腾芯片 NPU 上使用 Verl。

Last updated: 05/14/2026.

## 目录结构

```
ascend_tutorial/
├── get_start/                     # 快速入门指南
├── feature_support/               # 特性支持说明
├── model_support/                 # 模型支持说明
├── dev_guide/                     # 开发指南
├── faq/                           # 常见问题解答
└── contribution_guide/            # 社区贡献指南
```
## 最新消息
- [verl-ascend-recipe 建仓](https://github.com/verl-project/verl-ascend-recipe) - 新增昇腾recipe
- [verl on ascend 2026Q2 roadmap](https://github.com/verl-project/verl/issues/5526) - 2026Q2 RoadMap 已发布

## 快速开始
- [Docker 构建使用指南](./get_start/dockerfile_build_guidance.rst) - 构建并使用昇腾环境的 Docker 镜像  
- [自定义环境安装](./get_start/install_guidance.rst) - 在昇腾 NPU 上自定义安装 Verl                                                    
- [快速上手](./get_start/quick_start.rst) - 快速上手在昇腾 NPU 上运行 Verl

## 特性支持说明

- [verl特性支持](./dev_guide/model_dev/parameter_and_metrics.md) - 支持的verl框架特性/参数列表
- [NPU特性支持](./feature_support/npu_advance_features.md) - NPU相关常用特性/环境变量说明

## 模型支持说明

- [模型与算法支持说明](./model_support/model_and_algorithm_support.md) - 支持的模型/算法列表
- [最佳实践示例](./model_support/examples) - 最佳实践与模型部署示例


## 开发指南

- [模型开发](./dev_guide/model_dev) 
    - [模型迁移](./dev_guide/model_dev/transfer_to_npu_guide.md) - 模型迁移指南
    - [训练参数与指标](./dev_guide/model_dev/parameter_and_metrics.md) - 训练参数与指标
    - [模型评测](./dev_guide/model_dev/evaluation.md) - 模型评测指南
- [精度调试](./dev_guide/precision_analysis) 
    - [精度分析](./dev_guide/precision_analysis/precision_alignment_zh.md) - 精度对齐指南
    - [精度调试器](./dev_guide/precision_analysis/precision_debugger_zh.md) - 精度问题排查工具
- [性能调优](./dev_guide/performance) 
    - [性能分析](./dev_guide/performance/ascend_performance_analysis_guide.md) - 性能分析指南
    - [性能调优](./dev_guide/performance/perf_tuning_on_ascend.rst) - 性能调优指南
    - [profiling采集](./dev_guide/performance/ascend_profiling_zh.rst) - profiling 工具使用指南


## 支持与反馈

如果您在使用过程中遇到问题，欢迎通过以下方式获取帮助：

1. 查看 [FAQ](./faq/faq.rst)
2. 在 GitHub Issues 中提交问题
3. 联系昇腾技术支持

## 贡献指南
- [verl 社区贡献](../contributing) - Verl 社区贡献指南
- [昇腾 CI 指南](./contribution_guide/ascend_ci_guide_zh.rst) - 昇腾环境 CI 配置与测试

## 相关资源

- [Verl 官方文档](https://verl.readthedocs.io/)
- [昇腾开发者社区](https://www.hiascend.com/)