agent_ops/02.架构设计/00.整合说明/01.设计整合说明与优先级.md

设计整合说明与优先级

版本： 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. 后续清理方向

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