初始化 agent_ops 文档治理体系

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

@@ -0,0 +1,85 @@
+# 设计文档整合记录
+
+**迁移批次：** 第 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.架构设计/` 下维护。