86 lines
3.4 KiB
Markdown
86 lines
3.4 KiB
Markdown
# 设计文档整合记录
|
||
|
||
**迁移批次：** 第 2 批
|
||
**日期：** 2026-08-07
|
||
**范围：** `agent_ops/设计/` 与 `lineup-app/设计/`
|
||
|
||
## 1. 本批整合原则
|
||
|
||
本批不做“两个目录简单合并”，而是按以下优先级整合：
|
||
|
||
1. 如设计结论与当前实现存在冲突，优先采用 `lineup-app/设计/`；
|
||
2. `lineup-app/设计/` 中由 `APP架构设计.md` 明确声明为当前权威入口的结论，作为主基线；
|
||
3. `lineup-app/设计/02.正式方案/` 中的文档作为主基线的细化来源；
|
||
4. `agent_ops/设计/02.正式方案/` 主要视为历史同步快照，只有在与当前实现不冲突、且能补充背景时才吸收；
|
||
5. `agent_ops/设计/01.前期分析与设计/` 与 `00.records/` 主要作为历史来源，不再直接作为当前实现依据。
|
||
|
||
## 2. 为什么以 `lineup-app/设计/` 为主
|
||
|
||
经过本轮对比，`lineup-app/设计/` 具备更高确定性，原因包括：
|
||
|
||
- 更新时间更晚；
|
||
- 明确声明“当前权威设计基线”；
|
||
- 与 `lineup-app` 当前实际代码结构更一致；
|
||
- 已经主动声明取代若干旧设计文档；
|
||
- 在 Runtime、MiniApp、Host、Tool、Surface、Capability 等边界上更收敛。
|
||
|
||
相比之下，`agent_ops/设计/` 中较早的文档仍保留了：
|
||
|
||
- 局域网直连 WebSocket 的早期主线；
|
||
- 未来移动端 / 纯 Web 设想；
|
||
- 工具分类与协议草案的早期形态；
|
||
- 尚未收敛到当前 `lineup-app` Runtime 架构前的阶段性判断。
|
||
|
||
这些内容仍有背景价值，但不能继续和当前有效设计平级。
|
||
|
||
## 3. 本轮主要源文档
|
||
|
||
### 3.1 当前主来源
|
||
|
||
- `lineup-app/设计/README.md`
|
||
- `lineup-app/设计/APP架构设计.md`
|
||
- `lineup-app/设计/02.正式方案/app_final_design.md`
|
||
- `lineup-app/设计/02.正式方案/lineup-runtime-sdk-architecture.md`
|
||
- `lineup-app/设计/02.正式方案/lineup-ui-surface-protocol.md`
|
||
- `lineup-app/设计/02.正式方案/运行时与智能体工具.md`
|
||
|
||
### 3.2 历史补充来源
|
||
|
||
- `agent_ops/设计/01.前期分析与设计/architecture-design.md`
|
||
- `agent_ops/设计/01.前期分析与设计/tool-action-design.md`
|
||
- `agent_ops/设计/02.正式方案/*.md`
|
||
|
||
## 4. 本轮输出
|
||
|
||
本轮在 `02.架构设计/` 下新增：
|
||
|
||
- `01.设计整合说明与优先级.md`
|
||
- `02.当前权威架构基线.md`
|
||
- `03.Agent工具与运行时边界.md`
|
||
|
||
后续迁移已进一步完成：
|
||
|
||
- 原 `lineup-app/设计/` 已整体迁入 `agent_ops/02.架构设计/01.当前有效设计/`
|
||
- 原 `agent_ops/设计/` 已整体迁入 `agent_ops/02.架构设计/90.历史设计归档/`
|
||
- 两处旧设计目录已不再保留为有效入口
|
||
|
||
## 5. 冲突判断摘要
|
||
|
||
### 5.1 已明确放弃作为当前主线的旧结论
|
||
|
||
- “局域网 App 直连 Agent 插件 WebSocket 端口”作为当前主连接主线；
|
||
- “未来移动端 App”作为当前客户端基线；
|
||
- 将工具协议理解为独立于 Runtime / MiniApp 的外层薄协议设计；
|
||
- 用早期 `app / toolset / action` 三分法直接代表当前 Runtime Tool 模型。
|
||
|
||
### 5.2 仍保留背景价值的旧结论
|
||
|
||
- 产品不是任务管理系统；
|
||
- Agent 与 App 之间需要结构化工具调用，而不是自然语言裸发；
|
||
- 工具调用、消息传输、连接管理应分层；
|
||
- 设计应保持 Agent 与 UI 渲染解耦。
|
||
|
||
## 6. 后续处理建议
|
||
|
||
迁移完成后，所有设计过程、整合结论、当前有效方案和历史来源，统一在 `agent_ops/02.架构设计/` 下维护。
|