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