# 项目总览

**版本：** 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.迭代规划/`，后续可直接从这两个目录继续深入。