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

设计冲突与演进顺序

版本： 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. 这份文档的作用

这份文档不是简单说明“哪个文件更新”，而是明确：

• 哪些冲突是设计演进带来的；
• 现在为什么优先采用当前有效设计；
• 早期文档应该怎样被使用，而不是继续和当前设计平级竞争。