CANN/torchtitan-npu版本策略
版本策略（Versioning Policy）
【免费下载链接】torchtitan-npuAscend Extension for torchtitan项目地址: https://gitcode.com/cann/torchtitan-npu
torchtitan-npu采用“分支 + commit 基线”的方式与上游torchtitan保持对齐。 本政策用于定义发布兼容性约束，以及分支同步信息的唯一事实来源（source of truth）。
发布兼容性表
下表列出了已发布torchtitan-npu版本对应的上游torchtitan基线及关键运行时兼容范围。
| torchtitan-npu | torchtitan | Python | Stable CANN | PyTorch/torch_npu |
|---|---|---|---|---|
| v0.2.2 | v0.2.2 (73a0e6979dd10b6b1904098eb3c8f62c18ab87ce) | >= 3.10 | 8.0+ | 2.6+ / torch-npu matching CANN |
对于活跃开发分支，请始终以分支同步表为准。
分支同步表
本表是torchtitan-syncskill 的唯一事实来源。 在执行同步前，必须先读取与当前torchtitan-npu分支对应的数据行。
| torchtitan_npu_branch | torchtitan_repo_url | torchtitan_branch | torchtitan_commit | updated_at | notes |
|---|---|---|---|---|---|
| master | https://github.com/pytorch/torchtitan.git | v0.2.2 | 73a0e6979dd10b6b1904098eb3c8f62c18ab87ce | 2026-03-11 | Baseline adapted to torchtitan v0.2.2 tag. Update after each sync. |
格式规则：
torchtitan_commit必须仅包含纯 commit hash。- 不得在
torchtitan_commit中附加说明性文本（例如, v0.2.2 tag）。
分支策略
master：长期集成分支，应跟踪稳定上游基线。releases/vX.Y.Z（如使用）：发布维护分支，使用固定上游基线。feature/*或dev_*：开发分支，仍必须维护同步元数据的准确性与时效性。
常规流程应先将变更合入master，再按需回移（backport）到维护分支。
同步更新策略
每次完成上游同步后，必须同步更新本文件：
- 将
torchtitan_commit更新为本次同步目标 commit。 - 更新
updated_at。 - 在
notes中记录 commit 区间与主要适配点。 - 若兼容性发生变化，同步更新
发布兼容性表。
若当前分支在表中无映射行，必须先补充该行后再执行同步。
【免费下载链接】torchtitan-npuAscend Extension for torchtitan项目地址: https://gitcode.com/cann/torchtitan-npu
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考