初始化 agent_ops 文档治理体系

02.架构设计/00.整合说明/02.设计冲突与演进顺序.md

@@ -0,0 +1,130 @@
+# 设计冲突与演进顺序
+
+**版本：** 2026-08-07  
+**用途：** 说明两处设计文档的先后关系、冲突点和整合后的取舍依据
+
+## 1. 设计演进的三个阶段
+
+当前已迁入 `02.架构设计/` 的材料，大致对应三个阶段。
+
+### 第一阶段：早期探索阶段
+
+主要来源：
+
+- `90.历史设计归档/00.阶段记录/`
+- `90.历史设计归档/01.前期分析与设计/`
+
+这一阶段的特征是：
+
+- 仍以局域网直连 WebSocket、未来移动端等思路为主；
+- 工具协议与消息协议处于早期草案阶段；
+- 主要目标是确认产品定位和最小可行方向。
+
+这一阶段保留了很多重要背景，但不再直接作为当前实现依据。
+
+### 第二阶段：正式方案快照阶段
+
+主要来源：
+
+- `90.历史设计归档/02.正式方案快照/`
+
+这一阶段已经开始形成 Runtime、App、SDK、Surface、Capability 的正式方案，但它仍然是一次较早的设计快照，并不完全等于今天的代码基线。
+
+### 第三阶段：当前有效设计阶段
+
+主要来源：
+
+- `01.当前有效设计/README.md`
+- `01.当前有效设计/APP架构设计.md`
+- `01.当前有效设计/02.正式方案/`
+
+这一阶段与当前 `lineup-app` 实现最贴近，也明确声明了权威入口和替代关系，因此作为今天的主设计基线。
+
+## 2. 主要冲突点与取舍
+
+### 2.1 连接主线
+
+早期设计强调：
+
+- 局域网 App 直连 Agent 插件 WebSocket
+
+当前有效设计强调：
+
+- `Tauri Desktop Host + Web Reference Host`
+- `AppServer / Runtime / Adapter` 的运行时模型
+
+整合结论：
+
+- 保留早期直连方案作为历史探索背景；
+- 当前实现和后续设计都以 Runtime 中心化的 Host / AppServer / Adapter 主线为准。
+
+### 2.2 客户端形态
+
+早期设计强调：
+
+- Web / 未来移动端
+
+当前有效设计强调：
+
+- Tauri Desktop Host 与 Web Reference Host 的统一代码基线；
+- 不再以独立 Android/Kotlin 客户端作为当前主线。
+
+整合结论：
+
+- 早期移动端方向作为历史背景保留；
+- 当前产品和实现基线以 `lineup-app` 当前 Host 体系为准。
+
+### 2.3 工具模型
+
+早期设计强调：
+
+- `app / toolset / action` 三分法；
+- 工具协议作为较独立的一层来描述。
+
+当前有效设计强调：
+
+- Agent Tool、Inventory、Tool Call、进度、结果、activation、operation；
+- Tool 是 Runtime 模型的一部分，而不是脱离 Runtime 的独立漂浮协议。
+
+整合结论：
+
+- 早期三分法保留为历史理解工具；
+- 当前实现与后续文档统一采用 Runtime 中心化 Tool 模型。
+
+### 2.4 设计重心
+
+早期设计更关注：
+
+- 能否连通；
+- 消息长什么样；
+- 工具如何被粗粒度定义。
+
+当前有效设计更关注：
+
+- Runtime 的唯一所有权；
+- MiniApp、Surface、Capability 的边界；
+- 生命周期、恢复、子会话、工作区和 Agent 调用闭环。
+
+整合结论：
+
+- 现在的设计讨论必须站在第三阶段的视角进行；
+- 第一、二阶段只用于解释“为什么演进到这里”。
+
+## 3. 当前采用的统一排序
+
+当同一主题在多份文档中出现冲突时，当前采用的优先顺序是：
+
+1. `01.当前有效设计/APP架构设计.md`
+2. `01.当前有效设计/02.正式方案/*.md`
+3. `02.整合结论/` 中已经写明的整合判断
+4. `90.历史设计归档/02.正式方案快照/`
+5. `90.历史设计归档/01.前期分析与设计/`
+6. `90.历史设计归档/00.阶段记录/`
+
+## 4. 这份文档的作用
+
+这份文档不是简单说明“哪个文件更新”，而是明确：
+
+- 哪些冲突是设计演进带来的；
+- 现在为什么优先采用当前有效设计；
+- 早期文档应该怎样被使用，而不是继续和当前设计平级竞争。