Skip to content

A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.

Design Bot hand-offs by state and chain instead of counts (#262)

Fei24116bc140f189e3
diff --git a/docs/plans/2026-10-16-bot-handoffs.md b/docs/plans/2026-10-16-bot-handoffs.md
new file mode 100644
index 00000000..da523dc2
--- /dev/null
+++ b/docs/plans/2026-10-16-bot-handoffs.md
@@ -0,0 +1,90 @@
+# Bot 之间派活:状态、合并和派活链
+
+- 日期:2026-10-16
+- 相关:#262;取代 #95(PR #136)的未读上限、#129(PR #166)的跳数上限,以及 Bot 在一个群里最多发起 3 轮的上限;群里的活见 #165(PR #257)
+- 一起改:[群聊](2026-10-07-group-chat.md)「Bot 发起的轮次和上限」
+
+## 为什么
+
+Bot 之间派活原来按数量拦,不看对方的状态:
+
+- **Bot 看不到对方在做什么。** DS Bot 为界面记录了每个 Bot 的状态,`list_bots` 却只给名字、角色、模型和文件夹。只有 `message_bot` 发出以后,结果里才有一两句(在忙 / 等批准 / 几条没读)。#95:连发 5 条,5 条「已送达」,0 条回复。
+- **对方没读就拒绝。** 对方积压 10 条未读时,`message_bot` 拒绝发送,发件人不知道对方为什么没读。
+- **刷屏按长度和总量拦。** 消息链 6 跳截断;用户上次发言后,全团队最多 40 条;Bot 在一个群里最多发起 3 轮。按数量拦不分正常和空转:每一步都换人、都有结果的长派活链在第 7 手被截断;A→B→A 的绕圈要转满 6 手才停;忙的团队撞上 40 条。
+
+取舍:
+
+- 状态是事实,交给 Bot 自己判断;系统只在结构上不可能正确的地方拦。
+- 绕圈的根本特征是活回到了上游,不是链长。按「目标是否在上游」拦,任意长度的绕圈都拦得住,正常的长链不受影响。
+- 堆积的根本原因是同一个发件人一条接一条地发给一个读不了的 Bot。把还没读的合成一条,就不会堆积,不需要上限。
+- 参考了 OpenMausBot 和 Hermes Agent 的做法:前者让 `list_bots` 带状态,同一件活在路上不重发,不许派回上游;后者把活做成看板上的卡片,状态写在卡片上。两家都不按总量或链长拦 Bot 之间的派活。
+
+## 已定的行为
+
+### 状态
+
+- 每个 Bot 的状态是下面之一,从上往下取第一个符合的:
+
+ | 状态 | 条件 | 附带的信息 |
+ |---|---|---|
+ | 等用户批准 | 有一条待批准的请求 | 在哪里、从几点开始 |
+ | 换新会话中 | 正在写交接、换到新的一段 | 在哪里 |
+ | 在干活 | 私聊或某个群里有在跑的回合 | 在哪里(私聊或哪个群)、从几点开始、正在做什么(工具和它在处理的文件、搜索或网站,或者它刚说的话)、为谁做(用户,或者派活的 Bot) |
+ | 空闲 | 私聊和群里都没有在跑的回合 | — |
+
+- 另外两项和状态一起给出:
+ - 有一张没答的问题卡片:在等用户回答。
+ - 收件箱里还没读的 Bot 消息,按发件人列出条数。
+- `list_bots` 每个 Bot 一行,带上状态和这两项。
+- `message_bot` 的结果带上对方发出时的状态。
+- 状态不写进系统提示:系统提示要逐字节稳定,才能复用缓存。Bot 要看状态就调 `list_bots`。
+
+### 没读的消息合成一条
+
+- X 发给 Y 的消息,Y 还没读时 X 又发一条:两条合成一条,原来的在前,新的在后。还是同一次往来,Y 读到的是一条,一次回复答两条。
+- 两条里有一条是插进当前工作的(`when: "now"`),合成的就插进当前工作,否则排在当前工作之后。
+- 合成的消息按 [长消息](2026-10-16-long-messages.md) 的规则存和送。
+- 结果告诉 X:Y 还没读上一条,已经合在一起,以及 Y 现在的状态。
+- Y 已经读了(消息进了 Y 正在跑的回合),X 再发就是一条新消息,和原来一样。
+- 所以收件箱里每个发件人最多一条没读的消息,不再有未读上限。
+
+### 派活链
+
+- Bot 发出的每条请求带一条派活链:这件活一路经过的 Bot。用户开的回合,链是空的。
+- X 在一个回合里用 `message_bot` 发给 Y:
+ - Y 在这个回合的链上(派活给 X 的 Bot,或者更上游的 Bot):拒绝。工具告诉 X:Y 在这件活的上游,结束本回合,你的回复会自动交回给派活的 Bot。
+ - 否则发出。Y 收到的链 = X 的链,再加上 X。
+- 回复不加新的一环:Y 的回复回到 X,X 接着做时的链和发出请求时一样。
+- 一个回合同时处理几条请求(工作中读到的其他请求)时,几条链都算上游。
+- 群:
+ - Bot 用 `post_to_group` 开的一轮,链 = 发帖 Bot 的链加上它自己,再加上这个群。成员在这一轮里的工作和做完晚到的结果都沿用这条链。
+ - 链上已经有某个群时,同一条链不能再用 `post_to_group` 在这个群开新一轮。
+ - 群里的 `@` 接力不受派活链限制,仍按群聊的发言上限。在群里调用的 `message_bot` 等同 `@`(见群聊)。
+- 链的长度不设上限:每一步都要换一个链上没有的 Bot,所以最长就是团队人数。
+- 升级前发出、只带跳数不带派活链的消息,按空链处理。
+
+### 兜底
+
+- 删掉三个上限:消息链 6 跳、对方 10 条未读、Bot 在一个群里 3 轮。
+- 用户上次发言之后,全团队的 Bot 消息(`message_bot` 和 `post_to_group`)兜底上限从 40 条提高到 200 条,只防出错时停不下来。重置的条件不变:用户在任何 Bot 私聊或群里发言、回答问题卡片、定时任务。到了上限,这两个工具失败,并让 Bot 停下来向用户汇报。
+
+### 规则文字
+
+- 团队规则写明:`list_bots` 能看到每个 Bot 现在在做什么;不要给派活链上游的 Bot 发消息,结束本回合,回复会自动交回。
+- 原有的规则保留:只在对方必须动手或需要一个事实时才发;不发感谢、确认和进度回声;收到回复,这次往来就结束。
+
+## 不做什么
+
+- 不把状态写进系统提示(缓存)。
+- 不主动通知派活的 Bot「对方卡住了」:每条通知都会让派活的 Bot 再跑一次模型;用户在界面上已经看得到在等批准的 Bot。派活的 Bot 下次调 `list_bots` 或 `message_bot` 时能看到。
+- 不做看板式的任务对象:活仍在 Bot 的会话里,派活仍是消息。任务对象、进度查询和「只提问不动手」留给独立 app。
+
+## 已知限制
+
+- 兄弟 Bot 之间互相问来问去(彼此都不在对方上游)不算绕圈,只受 200 条兜底。
+- 状态只在内存里,DSH 重启后从新的事件重建,和界面上的状态一样。
+- X 自己把同一件活拆成几条不同的请求、分给不同的 Bot,不算重复。
+
+## 变更
+
+- 2026-10-16:定下(#262)。
diff --git a/docs/plans/README.md b/docs/plans/README.md
index 03ebb96c..f5fbbd4f 100644
--- a/docs/plans/README.md
+++ b/docs/plans/README.md
@@ -40,3 +40,4 @@
| [角色与权限](2026-10-07-roles-and-permissions.md) | 用户、Main Bot、群管理员、普通 Bot 各能做什么;Bot 的权限预设和群的统一权限 |
| [群聊](2026-10-07-group-chat.md) | 谁来回答、按顺序发言、@ 提及、轮数上限、干活中的进度和迟到的回复、审批 |
| [长消息](2026-10-16-long-messages.md) | state.json 只存开头;超过 2 万字的 Bot 消息转成 DSH 文件;成员和界面怎么读全文 |
+| [Bot 之间派活](2026-10-16-bot-handoffs.md) | Bot 看得到对方的状态;没读的消息合成一条;不许把活派回上游(派活链);全团队 Bot 消息的兜底 |