# 设计冲突与演进顺序

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

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

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