# 设计整合说明与优先级

**版本：** 2026-08-07  
**范围：** 原 `lineup-app/设计/` 与原 `agent_ops/设计/`

## 1. 当前采用的整合规则

本目录下的“当前有效设计”统一采用以下优先级：

1. `01.当前有效设计/APP架构设计.md`
2. `01.当前有效设计/02.正式方案/*.md`
3. `90.历史设计归档/02.正式方案快照/*.md` 中与当前实现不冲突的补充内容
4. `90.历史设计归档/01.前期分析与设计/*` 与 `00.阶段记录/*` 的历史背景

一句话概括就是：

**如有冲突，在结合项目当前实际实现的前提下，优先采用已经迁入 `01.当前有效设计/` 的原 `lineup-app/设计/` 文档。**

## 2. 为什么这样定

对比两边设计目录后，可以看到：

- 原 `lineup-app/设计/` 已经形成“权威入口 + 正式方案”的稳定结构；
- `APP架构设计.md` 明确声明自己是当前权威设计基线，并声明替代关系；
- 文档内容与当前 `lineup-app` 代码、当前 Host 基线、当前 Runtime 方向更一致；
- 原 `agent_ops/设计/` 中的大量文档属于更早阶段的探索、协议草案或设计快照。

因此，本轮不再让两处旧目录平行竞争“谁代表当前设计”，而是让已迁入 `01.当前有效设计/` 的文档负责当前设计，让 `90.历史设计归档/` 负责背景、来源和历史演进。

## 3. 当前设计资料的角色划分

### 3.1 当前有效设计

主要回答“现在应该按什么实现”的问题：

- App、Runtime、Host 三者边界；
- MiniApp、Tool、Surface、Capability 的正式约束；
- 当前客户端基线；
- 当前 Tool 和运行时语义。

### 3.2 历史设计来源

主要回答“之前为什么那样想、后来怎么演进到现在”的问题：

- 直连 WebSocket 方案；
- 早期工具协议三分法；
- 早期移动端 / Web 方向；
- 阶段记录和早期架构草图。

## 4. 本轮之后应如何使用两套来源

### 4.1 看当前实现时

优先阅读本目录下的新整合文档，再回溯 `lineup-app/设计/` 的细节来源。

### 4.2 查历史背景时

回看 `90.历史设计归档/` 中的前期分析与阶段记录，但默认它们不再自动对当前实现生效。

## 5. 后续清理方向

本轮已经完成物理迁移；后续不再恢复旧的两处分散设计目录。