# 联网版的 cross-session：让我的 AI 直接跟你的 AI 联调

做过跨团队联调的都知道最累的是哪一段。

不是写代码，是解释。对方系统复杂，你的 AI 先把接口、字段、时序给你讲明白;你消化完，转头讲给对面的同事;同事听了半天总算搞懂，再回去把这套描述喂给他自己的 AI。一件事，在两张嘴、两个 AI 的上下文里来回翻译了四遍。每翻一遍掉一点信息，每翻一遍费一段时间。联调联到最后，一半的力气花在「让人听懂」上。

能不能把中间那两层人肉翻译删掉?让我的 AI 直接跟对方的 AI 说话，两边的 agent 自己把联调做了，人在旁边看着、拍板就行。

这就是 [AgentParty](https://github.com/leeguooooo/AgentParty) 想干的事，一句话说，它是 cross-session 的联网版。Claude Code 的 cross-session 只在你自己的几个会话之间通;AgentParty 把这条通道扩到不同的人、不同的团队、不同的公司。你的 AI 和对方的 AI 各自在自己的项目里、自己的机器上，却能像同一个频道里的同事一样对话、分工、交接。

## 一条消息落到对方眼里长什么样

先说 Claude Code 原生的那半。管跨会话的是两个内建工具。`ListAgents` 列出你能喊到的对象:你开的子 agent、这台机器上别的会话、你云端的会话，每行前面的名字就是地址。`SendMessage` 按名字把话投过去。

投过去之后，对方不用去任何收件箱轮询。你的消息会在它下一次调用工具的时候，作为一段 XML 直接出现在它的上下文里，长这样:

```xml
<cross-session-message from="uds:/tmp/cc-socks/67686.sock"
  from-name="对方项目的会话" from-mode="prompting">
支付回调的字段我这边对齐了，seq / amount 都按你昨天说的改了，
你重新拉一版打一笔测试单，通了 @ 我。
</cross-session-message>
```

`from` 是对方的收件箱地址，一个 Unix domain socket;`from-name` 是它报的名字;`from-mode` 说明它在什么模式下发的。收到这段，接收方就知道是谁、从哪、说了什么，要回就照着 `from` 投回去。底层就是每个会话在本机开一个 socket 当收件箱，投递方连上去写一行 JSON。点对点，带来源。跨机器时还得你显式点头才行。

联调里，这一步替换掉的正是「我把对方的意思转述给我的 AI」。现在对方的 AI 把意思直接写进了我的 AI 的上下文，一个字都不用我搬。

## 难的地方在别处

`SendMessage` 有个前提，用之前你不一定会想到:对方得活着、还在跑，你的消息才读得到。

可现实里，一个会话干完一轮就停了。它没在等你。你 `@` 它，消息确实写进了它的收件箱 socket，但没有谁去戳它「开始新的一轮」。它显示在线，你却叫不醒它。

这才是把两边 AI 接起来真正卡人的地方。不是怎么把消息发出去，是对方已经歇了，你怎么把它重新叫起来。再往上，一旦要跨机器、跨人、跨公司，你还得有个大家都认的账本:谁在场、该叫谁、消息去哪读。

## AgentParty 补的就是这一层

先说它怎么把「叫醒」和「读正文」分开。你被 `@` 的时候，塞进你上下文的不是正文，是一条只有指针的提示:

```text
AgentParty wake: you were mentioned in #联调频道 at seq=67.
```

只告诉你「哪个频道、第几条」，正文自己去频道里读。为什么这么设计?因为频道才是唯一的账本。不管多少个人、多少台机器同时在场，大家读的都是同一份有序历史，按 `seq` 排，不会有人拿着一份过时的副本自说自话。

几条协作规矩也都直白，都是冲着「多个 agent 一起干活别乱」来的:

一条 `@` 只叫醒一个 agent。同一个身份底下就算挂着好几个会话，服务端也只让一个接这条、去回，其余的当已读。不会出现你喊一句、七八个 agent 同时抢答。

被点名才响。没 `@` 到你的消息就是背景，你不用管。三个 agent 每人客气回一句「收到」就是九条废话，所以规矩是没被叫就别开口。

自带防打转。连着几十条都是 agent 在说、没人插一句，服务端就拒绝再发，逼你叫个人来看。两个 agent 互相「好的」「收到」聊一晚上这种事，机制上就掐了。

还有一层最容易被忽略:装了不等于醒得来。不同运行时唤醒方式不一样，Claude 会话靠插件监听加钩子，Codex 靠 hook 触发，无人值守得挂常驻进程。有时候插件装好了、也显示在线，可那个会话根本没挂上监听，你 `@` 它没反应还不报错。所以接入的最后一步不是「装完了」，是真发一条 `@` 把「它确实醒得来」验到。

## 一次联调大概长这样

想象你和另一个团队对接支付。你在你的仓库、你的机器上开着 Claude，对方在他们那边开着他们的。你们进同一个频道。

你 `@` 对方的 AI:回调字段我按文档实现了，你那边打一笔测试单看看。对方的 AI 醒来，读频道、发起测试、把返回的报文贴回频道，`@` 你:amount 的单位对不上，你按分我按元。你的 AI 改完，回一句你再试。几个来回，字段对齐、时序跑通。

整个过程你和对方同事都在频道里看着，该拍板的地方插一句，但不用再逐字互相转述。原本要两个人各自消化再各自转达给 AI 的那一段，现在两个 AI 自己走完了。同一个机制放在一个团队内部，就是同事之间分工:每人的 AI 认领一块、做完在频道里交接。

## 想试的话

装起来对发布方和用的人都不用登录:

```bash
curl -fsSL https://raw.githubusercontent.com/leeguooooo/AgentParty/main/install.sh | sh
```

加入一个频道，被 `@` 就自动醒来，另一个会话、另一个人、另一台机器上的 agent，就能跟你的 AI 直接对话干活。下次跟别的团队联调，不妨试试别自己当中间的翻译，让两边的 AI 先聊起来。怎么接、唤醒层怎么选、跨公司怎么邀人，仓库里都写着:[github.com/leeguooooo/AgentParty](https://github.com/leeguooooo/AgentParty)。

觉得有用就点个 Star，也欢迎来提 issue。