# 版本发布策略

## 版本编号

Triton-Ascend 遵循 [PEP 440](https://peps.python.org/pep-0440/) 版本规范，版本号与上游 Triton 对齐：`vMAJOR.MINOR.PATCH[rcN][.postN]`

- **MAJOR.MINOR**：与上游 Triton 版本一一对应，例如 Triton-Ascend `3.2` 基于 Triton `3.2`
- **PATCH**：Triton-Ascend 的 `PATCH` 版本可能高于上游 Triton，用于 `MAJOR.MINOR` 级别的问题修复或改进，例如 Triton-Ascend `3.2.0` 和 `3.2.1` 均基于 Triton `3.2.0`
- **rcN**：发布候选版本，根据需要发布以供社区早期测试和反馈
- **postN**：已发布版本的后续补丁，根据需要发布以修复稳定版本中的问题

## 分支策略

- `main` 分支为最新开发分支，跟踪最新上游 Triton 版本
- 每个发布版本创建对应的发布开发分支（如 `release/3.2.x`），与社区发布具有相同的 commit id
- 功能开发应在 fork 仓库中进行，通过 `PR` 合入 Triton-Ascend 仓库

**`main` 分支映射：**

| Triton-Ascend | Triton commit hash                                           | Python    | CANN  | PyTorch | LLVM commit hash                                             | 补丁                                                        |
| ------------- | ------------------------------------------------------------ | --------- | ----- | ------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| `main`        | [cfc0a9d](https://github.com/triton-lang/triton-ascend/commit/cfc0a9d) | `3.9~3.13` | `9.0.0` | `2.7.1`   | [fad3272](https://github.com/llvm/llvm-project/commit/fad3272) | [fad3272.patch](https://github.com/triton-lang/triton-ascend/blob/main/third_party/ascend/llvm_patch/fad3272.patch) |

## 维护分支与生命周期

维护分支状态包括：

- **活跃（Active）**：持续接受缺陷修复、功能改进和安全补丁；将继续演进功能或发布新版本
- **维护（Maintenance）**：仅接受关键缺陷修复和安全补丁；不再发布功能改进
- **停止维护（End of Life）**：不再接受任何修复；分支维护已停止

| 分支              | 状态     | Triton 版本 | Triton-Ascend 发布              | 维护截止 |
| ----------------- | -------- | ------------ | ----------------------------------- | -------- |
| `main`            | `活跃`   | `3.5.0`      | /                                   | /        |
| `release/3.2.1` | `活跃`   | `3.2.0`      | `3.2.1`                             | /        |
| `release/3.2.x` | `维护`   | `3.2.0`      | `3.2.0rc2`，`3.2.0rc3`，`3.2.0rc4`，`3.2.0` | /        |

## 发布周期

- **稳定版本**：按照项目版本节奏发布，并非每个上游 Triton 版本都会有对应的稳定发布
- **rc 版本**：与上游 Triton 版本节奏同步发布，供用户早期测试
- **post 版本**：根据需要发布，用于修复现有稳定版本中的问题

### 发布时间线

| 日期       | 事件                     |
| ---------- | ------------------------ |
| 2026-05-06 | 发布稳定版本 `3.2.1`     |
| 2026-01-21 | 发布稳定版本 `3.2.0`     |
| 2025-11-14 | 发布预览版本 `3.2.0rc4`  |
| 2025-11-12 | 发布预览版本 `3.2.0rc3`  |
| 2025-05-26 | 发布预览版本 `3.2.0rc2`  |

## 版本兼容性矩阵

| Triton-Ascend | Triton | Python              | CANN  | PyTorch | LLVM commit hash | LLVM 补丁 |
| ------------- | ------ | ------------------- | ----- | ------- | ---------------- | --------- |
| `3.2.1`       | `3.2.0` | `3.9`(x86), `3.10-3.13` | `9.0.0` | `2.7.1`   | `b5cc222`        | -         |
| `3.2.0`       | `3.2.0` | `3.9-3.11`          | `8.5.0` | `2.6.0`   | `b5cc222`        | -         |
| `3.2.0rc4`    | `3.2.0` | `3.9-3.11`          | `8.5.0` | `2.6.0`   | `b5cc222`        | -         |
| `3.2.0rc3`    | `3.2.0` | `3.9-3.11`          | `8.5.0` | `2.6.0`   | `86b69c3`        | -         |
| `3.2.0rc2`    | `3.2.0` | `3.9-3.11`          | `8.5.0` | `2.6.0`   | `86b69c3`        | -         |