Skip to content

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

Design hand-offs as a tree instead of a chain (#262)

Fei24115a82e3f156c5
diff --git a/docs/plans/2026-10-16-bot-handoffs.md b/docs/plans/2026-10-16-bot-handoffs.md
index da523dc2..251ebb4b 100644
--- a/docs/plans/2026-10-16-bot-handoffs.md
+++ b/docs/plans/2026-10-16-bot-handoffs.md
@@ -1,7 +1,7 @@
-# Bot 之间派活:状态、合并和派活链
+# Bot 之间派活:状态、合并和派活树
- 日期:2026-10-16
-- 相关:#262;取代 #95(PR #136)的未读上限、#129(PR #166)的跳数上限,以及 Bot 在一个群里最多发起 3 轮的上限;群里的活见 #165(PR #257)
+- 相关:#262;取代 #95(PR #136)的未读上限、#129(PR #166)的跳数上限和全团队 40 条上限,以及 Bot 在一个群里最多发起 3 轮的上限;群里的活见 #165(PR #257)
- 一起改:[群聊](2026-10-07-group-chat.md)「Bot 发起的轮次和上限」
## 为什么
@@ -12,12 +12,16 @@ Bot 之间派活原来按数量拦,不看对方的状态:
- **对方没读就拒绝。** 对方积压 10 条未读时,`message_bot` 拒绝发送,发件人不知道对方为什么没读。
- **刷屏按长度和总量拦。** 消息链 6 跳截断;用户上次发言后,全团队最多 40 条;Bot 在一个群里最多发起 3 轮。按数量拦不分正常和空转:每一步都换人、都有结果的长派活链在第 7 手被截断;A→B→A 的绕圈要转满 6 手才停;忙的团队撞上 40 条。
+- **派出去的活,结果交不回来。** B 把一部分活交给 C 后结束回合,B 那句「已交给 C」当场就作为回复交给了 A,这次往来就结束了。C 的结果回到 B 时,B 那一回合说的话不交给任何人;B 只能再发一条新消息给 A。所以 A 拿不到最终结果,或者 Bot 之间一条接一条地补消息。
+
取舍:
- 状态是事实,交给 Bot 自己判断;系统只在结构上不可能正确的地方拦。
-- 绕圈的根本特征是活回到了上游,不是链长。按「目标是否在上游」拦,任意长度的绕圈都拦得住,正常的长链不受影响。
+- 派出去的活是一棵树:下面的活没交回,上面的回复就先不交;下面交回来,上面接着做,做完连同下面的结果一起交上去。结果自己会往上走,Bot 就不需要给上游补消息,也就不需要靠跳数、条数防止绕圈。
+- 唯一要拦的是:给正在等这件活结果的 Bot 发消息。那是在绕圈,而且多余,结果本来就会交上去。同一个 Bot 在一件活里出现几次都可以,只要它不是在等这件活。
- 堆积的根本原因是同一个发件人一条接一条地发给一个读不了的 Bot。把还没读的合成一条,就不会堆积,不需要上限。
-- 参考了 OpenMausBot 和 Hermes Agent 的做法:前者让 `list_bots` 带状态,同一件活在路上不重发,不许派回上游;后者把活做成看板上的卡片,状态写在卡片上。两家都不按总量或链长拦 Bot 之间的派活。
+- 不留兜底上限:用户看得到每个 Bot 在做什么,随时可以停下。
+- 参考了 OpenMausBot 和 Hermes Agent 的做法:前者让 `list_bots` 带状态,派活是一棵树,结果自动唤醒派活的 Bot,不许派回上游;后者把活做成看板上的卡片,状态写在卡片上。两家都不按总量或链长拦 Bot 之间的派活。
## 已定的行为
@@ -30,7 +34,8 @@ Bot 之间派活原来按数量拦,不看对方的状态:
| 等用户批准 | 有一条待批准的请求 | 在哪里、从几点开始 |
| 换新会话中 | 正在写交接、换到新的一段 | 在哪里 |
| 在干活 | 私聊或某个群里有在跑的回合 | 在哪里(私聊或哪个群)、从几点开始、正在做什么(工具和它在处理的文件、搜索或网站,或者它刚说的话)、为谁做(用户,或者派活的 Bot) |
- | 空闲 | 私聊和群里都没有在跑的回合 | — |
+ | 在等别的 Bot | 有一件活在等它派出去的活交回 | 在等谁(Bot 或群)、为谁做 |
+ | 空闲 | 都不是 | — |
- 另外两项和状态一起给出:
- 有一张没答的问题卡片:在等用户回答。
@@ -41,36 +46,46 @@ Bot 之间派活原来按数量拦,不看对方的状态:
### 没读的消息合成一条
-- X 发给 Y 的消息,Y 还没读时 X 又发一条:两条合成一条,原来的在前,新的在后。还是同一次往来,Y 读到的是一条,一次回复答两条。
+- X 发给 Y 的消息,Y 还没读时 X 又发一条,而且两条属于 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 用 `message_bot` 发给另一个 Bot、要对方回复的消息(`reply_to: "user"` 的不算)。B 在回答 A 这件活的回合里,以及之后接着做它的回合里,派出去的活都是这件活下面的活。
+- B 回答这件活的回合结束时:
+ - 下面的活都交回了(或者没有派):B 这一回合的话交回 A,和原来一样。
+ - 下面还有活没交回:先不交。这时 B 的状态是「在等别的 Bot」。
+- 下面的一件活交回来时,B 接着做上面那件活,收到的消息写明这是为谁做的哪件活。这一回合结束时再看一次:都交回了就交给 A,还有没交回的就接着等。
+- 交给 A 的回复是 B 最后一回合的话,后面附上这件活下面交回来的每个结果(谁交回的、原文),按 [长消息](2026-10-16-long-messages.md) 的规则送。B 最后一回合什么都没说时,用 B 为这件活说过的最后一段话。
+- 下面的活失败(对方的模型调用失败)、被停下或对方被删掉,也算交回,结果里写明。
+- 回答这件活的回合被停下(用户停、`stop_bot`):马上告诉 A「B 被停下了」,不再等下面的活;下面的活之后交回来,只交给 B,不再往上交。
+- 等待关系存在 `state.json` 里,DSH 重启后接着等。
- 群:
- - Bot 用 `post_to_group` 开的一轮,链 = 发帖 Bot 的链加上它自己,再加上这个群。成员在这一轮里的工作和做完晚到的结果都沿用这条链。
- - 链上已经有某个群时,同一条链不能再用 `post_to_group` 在这个群开新一轮。
- - 群里的 `@` 接力不受派活链限制,仍按群聊的发言上限。在群里调用的 `message_bot` 等同 `@`(见群聊)。
-- 链的长度不设上限:每一步都要换一个链上没有的 Bot,所以最长就是团队人数。
-- 升级前发出、只带跳数不带派活链的消息,按空链处理。
+ - B 为这件活用 `post_to_group` 发帖并要回报(`report_back`)时,这一轮也是下面的活;群的回报交回时,B 接着做。
+ - 不要回报的发帖不等。
+ - 群里的 `@`、群里调用的 `message_bot`(等同 `@`,见群聊)不进派活树,按群聊的规则。
+
+### 不许发给在等结果的 Bot
+
+- X 在做一件活时,用 `message_bot` 发给正在等这件活结果的 Bot(派活给 X 的 Bot,或者更上游的 Bot):拒绝。工具告诉 X:这个 Bot 在等这件活的结果;做完结束本回合,结果会自动交回。
+- 其他情况都允许。同一个 Bot 可以在一件活里出现几次,例如:
+ - A 自己调度:A 交给 B,B 交回;A 交给 C 审查,C 交回;A 验收。
+ - 接力:A 交给 B,B 交给 C 审查;C 的意见交回 B,B 连同 C 的意见交回 A;A 验收。
+ - 返工:C 的意见是要改,交回 B;B 改完再交给 C;通过后 B 交回 A。
+- 别的活不受影响:用户在 B 的私聊里另派的活,B 照样可以问 A。
-### 兜底
+### 去掉的上限
-- 删掉三个上限:消息链 6 跳、对方 10 条未读、Bot 在一个群里 3 轮。
-- 用户上次发言之后,全团队的 Bot 消息(`message_bot` 和 `post_to_group`)兜底上限从 40 条提高到 200 条,只防出错时停不下来。重置的条件不变:用户在任何 Bot 私聊或群里发言、回答问题卡片、定时任务。到了上限,这两个工具失败,并让 Bot 停下来向用户汇报。
+- 消息链 6 跳、对方 10 条未读、Bot 在一个群里最多发起 3 轮、用户上次发言后全团队 40 条,都去掉,不留兜底。
+- 群聊里的发言上限不变(见群聊)。
### 规则文字
-- 团队规则写明:`list_bots` 能看到每个 Bot 现在在做什么;不要给派活链上游的 Bot 发消息,结束本回合,回复会自动交回。
+- 团队规则写明:`list_bots` 能看到每个 Bot 现在在做什么;把一部分活交出去以后就结束本回合,结果交回时会接着做,全部交回后你的回复才交给派活的 Bot;不要给在等这件活结果的 Bot 发消息。
- 原有的规则保留:只在对方必须动手或需要一个事实时才发;不发感谢、确认和进度回声;收到回复,这次往来就结束。
## 不做什么
@@ -78,11 +93,13 @@ Bot 之间派活原来按数量拦,不看对方的状态:
- 不把状态写进系统提示(缓存)。
- 不主动通知派活的 Bot「对方卡住了」:每条通知都会让派活的 Bot 再跑一次模型;用户在界面上已经看得到在等批准的 Bot。派活的 Bot 下次调 `list_bots` 或 `message_bot` 时能看到。
- 不做看板式的任务对象:活仍在 Bot 的会话里,派活仍是消息。任务对象、进度查询和「只提问不动手」留给独立 app。
+- 不设总量、链长或轮数的兜底上限。
## 已知限制
-- 兄弟 Bot 之间互相问来问去(彼此都不在对方上游)不算绕圈,只受 200 条兜底。
-- 状态只在内存里,DSH 重启后从新的事件重建,和界面上的状态一样。
+- Bot 之间不停地互相提问,或者一件活没完没了地返工,会一直跑到用户停下。
+- 下面的活一直不交回(比如对方在等用户批准),上面就一直等;DSH 没有超时。状态里看得到在等谁。
+- 状态只在内存里,DSH 重启后从新的事件重建,和界面上的状态一样;等待关系除外,它存在 `state.json` 里。
- X 自己把同一件活拆成几条不同的请求、分给不同的 Bot,不算重复。
## 变更
diff --git a/docs/plans/README.md b/docs/plans/README.md
index f5fbbd4f..1f7db9fe 100644
--- a/docs/plans/README.md
+++ b/docs/plans/README.md
@@ -40,4 +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 消息的兜底 |
+| [Bot 之间派活](2026-10-16-bot-handoffs.md) | Bot 看得到对方的状态;没读的消息合成一条;派活树:下面的活交回后才往上交,不许发给在等结果的 Bot;不设总量和链长上限 |