初始化 agent_ops 文档治理体系

2026-08-07 16:56:51 +08:00
commit 10840909ab
75 changed files with 15750 additions and 0 deletions
@@ -0,0 +1,62 @@
+# 设计整合说明与优先级
+
+**版本：** 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. 后续清理方向
+
+本轮已经完成物理迁移；后续不再恢复旧的两处分散设计目录。