# 发布说明

发布（release）为代码库提供一个稳定的快照，并向社区正式公告新特性、已完成的改进以及可能
影响用户的变更（包括破坏性变更）。

```{note}
Triton-distributed-ascend 尚未发布稳定版本。当前项目通过源码构建，参见
[从源码构建](build.md)。下面的表格记录了版本与分支策略，将随版本发布逐步填充。
```

## 发布兼容性矩阵

以下是各 Triton-distributed-ascend 版本的兼容性矩阵：

| Triton-distributed-ascend 版本 | Python 版本 | 硬件平台 | 硬件产品 |
| --- | --- | --- | --- |
| _未发布_ | >=3.8 | 昇腾 NPU | A2/A3、Ascend 950 |

## 发布计划

以下是 Triton-distributed-ascend 的发布计划。补丁版本为可选发布。

| 主版本 | 发布分支切出日期 | 发布日期 | 补丁发布日期 |
| --- | --- | --- | --- |
| — | — | — | — |

## 发布亮点

发布亮点将随版本发布在此补充。每个条目应总结关键特性、已知限制以及所需的迁移步骤。

### 未发布

**当前开发状态**

项目当前面向 Atlas A2/A3 与 Ascend 950，基于 CANN 9.1.0 或更高版本从源码构建。

#### 关键特性

1. **分布式通信原语**

   - AllReduce、AllGather、ReduceScatter 与 All2All

2. **计算通信掩盖**

   - 计算与通信的重叠执行

3. **基于 AscendNPU IR 的编译器优化**

   - 直接面向昇腾硬件特性的优化

4. **Python 友好的接口**

   - 可集成到现有深度学习框架的 Python API

#### 已知限制

1. **分发方式**：尚未发布二进制包；仅支持源码安装
2. **硬件覆盖**：已在 Atlas A2 与 Ascend 950 上验证

## 发布策略

### 版本号规则

Triton-distributed-ascend 遵循 [PEP 440](https://peps.python.org/pep-0440/) 版本规范：
`vMAJOR.MINOR.PATCH[rcN][.postN]`

- **MAJOR.MINOR**：跟踪项目所基于的 Triton 版本
- **PATCH**：用于 `MAJOR.MINOR` 级别的缺陷修复或改进
- **rcN**：候选版本，按需发布，供社区提前测试与反馈
- **postN**：后置版本，按需发布，用于修复稳定版本中的问题

### 分支策略

- `master` 分支是最新的开发分支
- 每个发布版本都会创建对应的发布分支（例如 `release/3.2.2`）
- 特性开发应在仓库 fork 中进行，并通过 pull request 合入

### 维护分支与生命周期

维护分支状态：

- **Active**：持续接受缺陷修复、特性改进与安全补丁
- **Maintenance**：仅接受关键缺陷修复与安全补丁，不再发布特性改进
- **End of Life**：不再接受任何修复，分支维护已停止

| 分支 | 状态 | 发布 | 维护结束 |
| --- | --- | --- | --- |
| `master` | Active | / | / |
| `release/3.2.2` | Active | — | / |

## 发布周期

- **稳定版本**：按项目的版本节奏发布
- **rc 版本**：在稳定版本之前发布，供用户提前测试
- **post 版本**：按需发布，用于修复已有稳定版本中的问题

### 发布时间线

| 日期 | 事件 |
| --- | --- |
| — | — |

## 版本兼容性矩阵

每个已发布版本会记录其构建与验证所依赖的版本：

| Triton-distributed-ascend | Python | CANN | PyTorch | torch_npu |
| --- | --- | --- | --- | --- |
| _未发布_ | >=3.8 | 9.1.0 | 2.7.1 | 2.7.1.post8 |

未发布行中的取值即 `requirements.txt` 中固定的版本，与[安装](installation.md)中的说明一致。