项目协调群是日常交流入口。Worker 创建、运行、提问和交付都不要求有任务群。用户向协调者提出直接对话需要后,协调者识别本项目任务并调用:
{"action":"open_group","requestId":"stable-open-id","taskId":"target-worker-id"}同一请求重试核对并复用当前有效群。Worker 可以为自己建群,协调者可以为本项目 Worker 建群。并发调用使用同一创建与恢复路径。Worker 不能为其他任务建群,项目协调群不能作为 Worker 群。原生审批按需自动开群,仍只接受实际用户的认证按钮操作。
无群期间的普通飞书输出标为 dropped,原文和执行事件仍保存在本地。Worker 的普通最终答复不会自动交给协调者。Worker 使用独立的 send_agent_message 主动通知进展、阻塞和成果,无需等待用户请求。任务群内的普通用户消息和问答保留在原任务。影响项目安排的重要用户决定由 Worker 附实际来源发给协调者。
开群只显示欢迎、状态和最近的最终摘要,不补发旧输出。开群后的完整助手过程说明、问题和最终回复默认逐条显示。协调者的普通回复不会自动发群,使用 send_group_message 明确发送给用户。该工具固定接受时的群绑定,重绑后旧消息不会转发到新群。
群被解散、ID 无效或不再满足任务群的所有者与私密性要求时,解除群关联并保留 Thread、状态、输入和待审批。权限或网络错误不是已解散的证据。群重建增加代次,群标记、创建 UUID、审批输出和进度资源不会误用旧群身份。任务群不会自动解散。
普通消息的未知发送结果不自动重发。仍有效的原生审批卡可在未知结果后重试,间隔至少 30 秒,沿用同一消息 UUID。在飞书 UUID 去重窗口之外可能出现第二张相同请求卡,但实际批准仍绑定同一个原生请求,原生决策队列只接受一次,不重复工具执行。旧群卡或过期请求不能批准新请求。
执行前需要独立的用户授权和已经生效的本版 Runtime。API 解散会永久删除飞书聊天记录。禁止先在旧版服务上解散运行任务的群。
- 协调者调用
plan_group_cleanup,携带稳定requestId。返回的计划冻结全部当前任务群,排除所有项目协调群,并在项目群展示一次。计划之后新建的群不加入旧清单。 - 用户核对清单后,发送其中的精确确认文本。协调者调用
confirm_group_cleanup,携带planId和该消息的messageId。代理转述、原生工具批准以及计划前的泛化授权都不能代替此确认。 - 协调者调用
apply_group_cleanup,携带planId和新的稳定requestId。计划逐项保存尝试、成功、已不存在、跳过、失败或未知结果。任一错误停止本批,包括权限错误。已失效的旧绑定不会指向后来重建的新群。 - 修复阻塞后,使用新的 apply 请求继续同一个计划。同一 apply 请求只返回原回执,不重复执行。结果未知的项先检查远端群状态;已解散直接完成,仍存在才继续删除。已成功项不再删除。
需要 im:chat:delete 或更宽的 im:chat。机器人不是群主时,还必须是群创建者并具有 im:chat:operate_as_owner。官方说明见解散群。232009 表示已解散,232006 表示 ID 无效;后者不会作为已成功删除处理。所有计划和逐项结果保存在本地持久记录中。
最终代码包含 PR17 db85f353 的项目身份、GitHub 证据、材料保存、原地晋升和历史恢复实现。
新需求只在项目协调群交办。CLI submit、answer、本机接单服务和私聊接单均已移除。
status --request-id 仅查询旧 CLI 回执,内部 project_action 和工程资源工具继续保留。
未派发的 GitHub 与历史请求无群无正式 Thread,只有协调者决定派发后才执行。
任务群不是任务身份。进度写入在适配器实际调用远端之前再次核对群绑定与代次, 停止退役群尚未发送的排队写入。群核对返回后同样检查绑定,避免旧群链接进入新审批通知。
进度总览、群名变更同步和初始群名摘要不在本次变更内。真实群写入验收、部署和既有群清理需要各自授权;离线行为测试不能代替这些操作的真实验收。