# 仓库职责与协作边界

**版本：** 2026-08-07 整合版  
**主要来源：** 根 `仓库职责说明.md`，辅以根 `README.md`

## 1. 核心结论

当前 LineUp 主线的长期稳定分层，不是按“前后端”粗分，而是按能力边界分为三层：

```text
lineup-app/            LineUp Runtime / Host / Interact / MiniApp
lineup-adapter/hermes/ Agent 平台适配层
lineup-app-server/     登录、同步、消息收发和服务接入层
```

其中最应避免的事情是：为了图快，把某个层的问题一路下沉到不该负责的仓库。

## 2. `lineup-app/` 的职责

`lineup-app/` 是客户端主仓，负责用户真正使用到的交互运行时。

它长期应该承接：

- Runtime；
- Interact 与主交互模式；
- MiniApp SDK；
- Tool Router；
- App Workspace；
- Surface / Capability 承载边界；
- Tauri / Web Host 装配。

它不应该承接：

- Hermes 或其他 Agent 平台的私有 prompt / approval 语义；
- 登录、同步、消息中转服务逻辑；
- 平台专属网关状态机。

## 3. `lineup-adapter/hermes/` 的职责

`lineup-adapter/hermes/` 负责把具体 Agent 平台接到 LineUp 标准协议上。

它长期应该承接：

- 平台私有协议与 LineUp 协议之间的桥接；
- approval / clarify / confirm 等平台私有交互的映射；
- `call_id`、选项 id、内部 request id 的解析与账本；
- 白名单化、安全化的 Agent 输出规范化。

它不应该承接：

- Runtime 的长期业务状态机；
- MiniApp 工作区快照；
- AppServer 的登录、同步和服务职责；
- 直接修改客户端展示层语义。

## 4. `lineup-app-server/` 的职责

`lineup-app-server/` 是传输与服务边界层。

它长期应该承接：

- 登录与鉴权；
- 消息发送与同步；
- Webhook 和基础服务端 API；
- 与 WuKongIM 等基础设施对接；
- Web Reference Host 的服务端部分。

它不应该承接：

- 高层 `lineup.v1` 交互语义解析；
- Runtime Tool 生命周期；
- Agent 平台私有协议兼容逻辑；
- 前端具体展示决策。

## 5. 改动落点判断顺序

整合根文档后，可以把跨仓改动判断顺序压缩为三步：

1. 如果是 LineUp 自己的标准能力、运行时能力、交互协议或工作区语义，优先落在 `lineup-app/`。
2. 如果是某个 Agent 平台的私有兼容问题，优先落在 `lineup-adapter/hermes/`。
3. 如果是登录、同步、消息收发或服务接入问题，优先落在 `lineup-app-server/`。

## 6. 为什么这份文档仍具有时效性

与“某个服务今天是否在线”不同，仓库职责文档主要表达的是边界约束。只要主线架构未重组，这类判断就比运行状态更稳定。

因此，本轮整合后认为以下内容仍然具有较强时效性：

- 三仓主边界划分；
- Runtime / Adapter / AppServer 的分层原则；
- 跨仓改动的优先判断顺序。

## 7. 后续如何使用本文件

后续在维护 `agent_ops/02.架构设计/` 和 `agent_ops/03.迭代规划/` 时，这份文档可以作为边界校验基线：

- 设计方案是否把平台私有逻辑错误下沉到了 Runtime；
- 迭代目标是否混淆了客户端、适配层和服务端职责；
- 文档命名和归档是否按这条边界来组织。