agent_ops/00.目录治理/03.设计文档整合记录.md

设计文档整合记录

迁移批次： 第 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.架构设计/ 下维护。