63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
# 设计整合说明与优先级
|
|
|
|
**版本：** 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. 后续清理方向
|
|
|
|
本轮已经完成物理迁移；后续不再恢复旧的两处分散设计目录。
|