Skip to content

Latest commit

 

History

History
49 lines (41 loc) · 3.9 KB

README.md

File metadata and controls

49 lines (41 loc) · 3.9 KB

Release Notes 与版本号规范

本目录按版本一册:v<主>.<API 变化>.<漏洞修复>.md。预发布候选用 v1.10.0-rc0.1.md 形式。 读者:查版本变更与版本号规则的调用者。本分册定位见 README.md;历史归档在 ../history/history.md。 状态:现行。

1. 版本号定义

格式:v1.<API 变化>.<漏洞修复>(例:v1.13.0、v1.8.2)

位 名称 递增条件 例
第 1 位 主版本 极少动:模型文件格式不兼容、项目定位级重构 v0.x → v1.0
第 2 位 API 变化 任何对外接口的新增或语义变更(头文件 API、CLI 选项、文件格式键、CMake 开关);允许带破坏性变更,须附迁移章节 v1.9.0 → v1.10.0
第 3 位 漏洞修复 不改 API 的缺陷修复、数值修正、性能修复;行为只允许从"错"变"对" v1.8.1 → v1.8.2

细则:

  1. 破坏性变更只允许出现在第 2 位递增的版本,且 release note 必须含「破坏性变更 + 迁移指南」章节。
  2. 预发布候选:大版本可发 v1.x.0-rc0、v1.x.0-rc0.1(rc 迭代);rc 期间冻结 API,只收口发布审查发现的问题。
  3. 已发布版本不重打:tag 一旦发布即冻结;发布后发现的问题以勘误块追加在该版本 release note 顶部,并指向修复版本(例:见 v1.10.0.md 勘误)。
  4. 子仓库编号规则已随 2026-11-01 子仓合并回主仓而失效(历史版本号仍按各自 tag 冻结,见各历史 release note)。
  5. 每册 release note 的头部固定给出:发布范围(上一 tag → 本 tag)、主题、兼容性评级、验收基线。
  6. 发布治理:版本号的定档与发布必须由人明确提出,agent 不得擅自决定版本号或执行发布(git tag / gh release 等);dev 与功能分支不写版本号,定档与发布只发生在 main。正文见 ../contributors/release-policy.md。

2. 目录索引

版本 主题
v1.16.0 int8 训练显存优化(W1.58A8 激活量化 + AdamWInt8 + 免 latent 部署构建);正式版承接 rc0(引擎 .so 化 / JIT / C++ 模块 / 子仓合并)+ 发布门禁全量重跑(四编译器矩阵)
v1.15.0-rc0 预发布候选:引擎 .so 化(双引擎 .so + MIT 抽象层)+ 运行期 JIT 算子缓存(.nnk + kernelgen)+ C++20 模块加载路径 + 5 子仓合并回主仓 + 文档工具链
v1.14.1 漏洞修复(补写):断点续训无半提交 + 优化器 t 取权威值
v1.14.0 训练骨架(TrainState/BatchSource/RunDriver)+ 开放规格(ModelSpecBase)+ Embedding/CrossAttention + 宿主桥公开 API + 全仓格式化基线
v1.13.0 子仓拆分(core / threadpool / kvrecord / dataset / tokenizer → extern/ submodule)
v1.12.0 RL 与可组合训练基础设施(具名多输出 / experience / objectives / TrainingGroupSession)
v1.11.0 batch/step 计数语义统一 + 梯度累积归一化修复
v1.10.0 对象生命周期 v3 + TrainingSession + TextTrainer
v1.10.0-rc0.1 预发布候选:Session 层 P2b(TrainState 归属)
v1.10.0-rc0 预发布候选:生命周期 v3 core
v1.9.0 (见该册)
v1.8.2 漏洞修复
v1.8.1 漏洞修复(补写)
v1.8.0 (见该册;2026-10-18 补写)
v1.7.1 漏洞修复(补写)
v1.7.0 (见该册)
v1.6.1 漏洞修复(补写)
v1.6.0 (见该册)
v1.5.1 漏洞修复(补写)
v1.5.0 (见该册)