初始化 agent_ops 文档治理体系

2026-08-07 16:56:51 +08:00
commit 10840909ab
75 changed files with 15750 additions and 0 deletions
@@ -0,0 +1,69 @@
+# 项目总览
+
+**版本：** 2026-08-07 整合版  
+**来源整合：** 根 `README.md`、`仓库职责说明.md`、`程序文件清单与功能说明.md`
+
+## 1. 项目一句话定义
+
+LineUp 是一个连接用户设备、消息服务与远程 Agent 的协作运行体系。用户通过客户端与 Agent 协作，Agent 的执行、工具调用和交互请求通过统一协议与运行时能力落到用户侧。
+
+当前更准确的理解方式是：
+
+```text
+用户侧 Host / Runtime
+  ←→ AppServer / Message Transport
+  ←→ Hermes Adapter / Agent Platform
+```
+
+它不是单纯的聊天客户端，也不是任务管理系统。项目长期核心资产是：
+
+- LineUp 协议；
+- Runtime 与 Host 边界；
+- Agent 适配层；
+- 交互与工具的标准化运行方式。
+
+## 2. 当前主线定位
+
+从现有根文档整合后，可以把项目主线收敛为以下结构：
+
+```text
+lineup-app/                 客户端 Runtime、Host、Interact 与 MiniApp
+lineup-adapter/             Agent 平台适配层，当前主线为 Hermes
+lineup-app-server/          登录、同步、消息收发和 Web Reference Host 服务端边界
+infra/wukongim-v3/          本地运行配置
+wukongim/                   上游 IM 基线源码
+agent_ops/                  文档治理、迁移、设计与阶段资料整理目录
+```
+
+## 3. 当前产品边界
+
+根文档里最稳定、且跨多份文档一致的结论包括：
+
+- 产品定位是“远程 Agent 操作交互端”；
+- 当前主交互仍围绕 IM 展开，但目标不止于聊天；
+- Agent 任务拆解和执行属于 Agent 自己，不由 LineUp 变成任务管理系统；
+- 客户端长期核心是 Runtime，而不是某一个具体聊天页面；
+- AppServer 负责传输与服务边界，不负责高层交互语义；
+- Adapter 负责平台私有协议到 LineUp 标准协议的桥接，不把平台特判下沉进 Runtime。
+
+## 4. 当前实现基线
+
+截至本轮整合，可以认为以下内容仍然是当前主线基线：
+
+- 客户端主仓是 `lineup-app/`；
+- 主要 Agent 适配路径是 `lineup-adapter/hermes/`；
+- 服务端主仓是 `lineup-app-server/`；
+- 通讯基础设施主线围绕 WuKongIM 3.0；
+- 当前客户端唯一有效实现/验收基线是 Tauri Desktop Host + Web Reference Host；
+- 不再规划独立 Android/Kotlin 客户端作为当前产品主线；
+- 历史唐僧叨叨相关材料仅保留背景参考，不再作为当前运行主线。
+
+## 5. 阅读顺序建议
+
+如果第一次进入项目，推荐从这里继续看：
+
+1. [当前状态与阶段判断](./02.当前状态与阶段判断.md)
+2. [仓库职责与协作边界](./03.仓库职责与协作边界.md)
+3. [跨仓程序清单与功能说明](../04.程序清单/01.跨仓程序清单与功能说明.md)
+
+设计与迭代文档现已迁入 `agent_ops/02.架构设计/` 与 `agent_ops/03.迭代规划/`，后续可直接从这两个目录继续深入。