docs(branch): 第二代快照说明——端云协同编程智能体（v2核心+v3 Web+v4模型池）

2026-09-15 10:02:06 +08:00
parent 747d85c3ba
commit 8d77c8c0c0
1 changed files with 32 additions and 0 deletions
@@ -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` 分支