From a070cb563dbbfcb40fb7e94e0f5503fbb6797a8e Mon Sep 17 00:00:00 2001 From: JianFeeeee Date: Sat, 12 Sep 2026 08:39:05 +0800 Subject: [PATCH] =?UTF-8?q?docs(git):=20=E5=88=86=E6=94=AF=E5=AF=B9?= =?UTF-8?q?=E9=BD=90=E6=9B=B4=E6=96=B0=E5=88=B0=202026-09-12=EF=BC=881.2.x?= =?UTF-8?q?=20=E7=BA=BF=E5=BC=80=E5=90=AF=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - main 路牌调到 1.3.0；release/v1.2.x 承载 1.2.0（vendored SDK 定版 1.2.0） - release/v1.1.x 按 §2.6 退役（保留供追溯）；两个历史 feature 分支 （memory-media / plugin-proc-migration）已从远端删除，旧表待删项清掉 - 新增「1.2.x 发布线 tag 历史」表（当前尚无 tag），并写明它与存量插件 **不兼容**（RPC 协议 2、fd3 布局改变、不支持滚动升级）以及 **不满足 §2.4 跳级条件**的理由（改动面大，非单点修复） - SDK 仓的 release/v1.2.x 尚未创建：按 §七.3 随核心**正式** tag 一起做 --- docs/git-branching.md | 32 ++++++++++++++++++++++---------- 1 file changed, 22 insertions(+), 10 deletions(-) diff --git a/docs/git-branching.md b/docs/git-branching.md index a57c00a..1524c75 100644 --- a/docs/git-branching.md +++ b/docs/git-branching.md @@ -130,26 +130,27 @@ main ──────────────── E ──────── --- -## 三、当前分支对齐（2026-09-04 执行） +## 三、当前分支对齐（2026-09-12 更新） ### 主仓（TrueAgent） | 分支 | 状态 | 处理 | |---|---|---| -| `main` | 含全部 hotfix（逐个 cherry-pick），`meta.Version` = 下一个未发布中版本（现为 `1.2.0`） | ✅ 保持 | -| `release/v1.0.x` | 承载 v1.0.0 / v1.0.1 / v1.0.3 全部 tag | ✅ **由 `release/v1.0.1` 重命名而来**（2026-09-04） | -| `release/v1.0.0` | `9b92a04`，已被 1.0.x 线完全包含（`merge-base --is-ancestor` 验证通过） | 🗑️ **已删除**（本地 + 远端），tag `v1.0.0` 保留全部历史 | -| `release/v1.0.1` | 旧 patch 号命名 | 🗑️ **已重命名为 `release/v1.0.x`**（远端旧名删除） | -| `feature/memory-media` | 记忆系统媒体（多模态）支持，进行中 | ⏳ 完成后合回 main 并删除 | -| `feature/plugin-proc-migration` | 已合入 main（`525aa1f`） | ⏳ 待删（规范要求合回后删除） | -| `release/v1.1.x` | 承载 v1.1.0 / v1.1.0-beta.1 / v1.1.1 全部 tag | ✅ 1.1 线的唯一发布分支 | +| `main` | 含全部回流修复；`meta.Version` = 下一个未发布中版本（现为 `1.3.0`） | ✅ 保持 | +| `release/v1.2.x` | **本条发布线**，`meta.Version` = `1.2.0`，vendored SDK 定版 `1.2.0`；已载入两个发布前修复（GUI 输出目录、知识库同名覆盖） | 🆕 2026-09-12 从 main 切出；**尚无 tag** | +| `release/v1.1.x` | 承载 `v1.1.0-beta.1` / `v1.1.0` / `v1.1.1` | 📦 已退役（§2.6：下个中版本发布即退役），保留供追溯 | +| `release/v1.0.x` | 承载 1.0.x 全部 tag | 📦 保留 | +| `feature/multimodal-embedding` | 已合入 main（`eb4762a`，43 提交，`--no-ff`） | ⏳ 待删（删远端分支需用户确认，§执行守则 3） | + +> `feature/memory-media`、`feature/plugin-proc-migration` 均已从远端删除（旧表里的待删项已处理）。 ### SDK 仓（homeagent-sdk） | 分支 | 状态 | 处理 | |---|---|---| -| `main` | `meta.Version` = 下一个未发布中版本（现为 `1.2.0`） | ✅ 保持 | -| `release/v1.1.x` | `meta.Version` = `1.1.0`，承载 tag `v1.1.0` | ✅ 与核心 `release/v1.1.x` 对应 | +| `main` | `meta.Version` = 下一个未发布中版本（现为 `1.3.0`，与核心 main 同步） | ✅ 保持 | +| `release/v1.1.x` | `meta.Version` = `1.1.0`，承载 tag `v1.1.0` | ✅ 与核心对应 | +| `release/v1.2.x` | **尚未创建** | ⏳ 随核心**正式** tag 一起建（§七.3：分支上把版本定为 `1.2.0` 再打 `v1.2.0`；beta 阶段不发 SDK） | | `release/v1.0.0` | 旧 patch 号命名形态，内容已被 main 完全包含 | 📦 保留（供追溯 1.0 线构建） | ### 1.0.x 发布线 tag 历史 @@ -174,6 +175,17 @@ main ──────────────── E ──────── > 而 semver 预发布语义里 `1.1.0-beta.1 < 1.1.0`。这是「一条发布分支 + tag 区分通道」的 > 已知代价：beta 是为验证**打包链路**而补打的，不代表源码更旧。发布说明里已注明。 +### 1.2.x 发布线 tag 历史 + +| tag | 提交 | 通道 | SDK | 说明 | +|---|---|---|---|---| +| （尚无） | — | — | — | `release/v1.2.x` 已切出（`01232a6`），tag 通道待定 | + +> 1.2.x 与存量插件**不兼容**：RPC 协议升到 2（fd3 布局改变），存量外部插件必须用 +> 新版 plugindev 重编为 `plugin.bin`——**不支持滚动升级**，内核与插件须同批重建、同批安装。 +> 按 §2.4，跳级直发正式版需在发布说明里列明「单点修复 / 反向验证 / 全类审计」三项； +> 本次改动面大（统一多模态向量空间 + 协议 2 + 数据面全量迁移），不满足跳级条件。 + --- ## 四、现网部署与版本对应（运维纪律）