From 8d77c8c0c0d8bc15cc4f0e373a77224c8950f03d Mon Sep 17 00:00:00 2001
From: tzt <14718231+flying-travel@user.noreply.gitee.com>
Date: Tue, 15 Sep 2026 10:02:06 +0800
Subject: [PATCH] =?UTF-8?q?docs(branch):=20=E7=AC=AC=E4=BA=8C=E4=BB=A3?=
 =?UTF-8?q?=E5=BF=AB=E7=85=A7=E8=AF=B4=E6=98=8E=E2=80=94=E2=80=94=E7=AB=AF?=
 =?UTF-8?q?=E4=BA=91=E5=8D=8F=E5=90=8C=E7=BC=96=E7=A8=8B=E6=99=BA=E8=83=BD?=
 =?UTF-8?q?=E4=BD=93=EF=BC=88v2=E6=A0=B8=E5=BF=83+v3=20Web+v4=E6=A8=A1?=
 =?UTF-8?q?=E5=9E=8B=E6=B1=A0=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 BRANCH.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 BRANCH.md

diff --git a/BRANCH.md b/BRANCH.md
new file mode 100644
index 0000000..5d2be9a
--- /dev/null
+++ b/BRANCH.md
@@ -0,0 +1,32 @@
+# 分支：v2-coding-agent — 端云协同编程智能体（第二代）
+
+> **快照点**：`747d85c`（v2 核心 + v3 Web 应用化 + v4 模型池与工具智能体全部完成、测试全绿时点）。
+> 历史路标，冻结不再演进；集成主线见 `master`。
+
+## 这一代是什么
+
+**命题**：《基于端云协同的编程智能体系统设计与实现》——大模型（API）任务分析/决策/终审 +
+小模型（本地 llama.cpp）实现/自验证 +「交流文本」结构化共享工作区 + 人工检验队列。
+
+- **v2 核心**：`Workspace` 交流文本协议（schema/锚点/rollup/双渲染）→ `ArchitectClient`
+  （brief/decide/final_review，JSON 约束）→ `WorkerLoop`（工具化实现+接地验证+自修≤2）
+  → `CollaborativePipeline`（快路径/协作循环/双护栏熔断/终审）+ 运维层（llama-server 进程管理、
+  三档硬件模板）+ `ReviewQueue` 人工检验 + 打包分发
+- **v3 Web 应用化**：异步任务 + SSE 实时协作可视化 + Vue3 SPA（对话/协作过程/检验/指标）+ 网关安全加固
+- **v4 增补**：多价位模型池（local/budget/premium 角色指派）+ 工具智能体（harness 级工具/工作区选择/
+  两级智能体/审批流/token 级流式）
+- v1 保留为 legacy（`POST /chat/legacy`），离线降级可用
+
+## 基线
+
+测试 281 项全绿（T31 时点）；E1 token 经济学实测：交流文本较全量上下文降 ~61%（含缓存计费）。
+
+## 文档
+
+`实现方案_v2_端云协同编程智能体系统.md`、`实现方案_v3_Web应用化.md`、
+`实现方案_v4_模型池与工具智能体.md`、`毕业设计_进度记录.md`
+
+## 与其他分支的关系
+
+- 第一代（规则路由）以 legacy 形式包含在本快照内
+- 第三代（校园缓存代理层）在本快照之后的 master 上演进 → 见 `campus-cache-proxy` 分支