[Bug] QQ官方机器人出现重复接收并回复单一消息

[ku1yin]

What happened / 发生了什么

在QQ App中 清空机器人聊天记录后，出现Astrbot重复接收单条信息现象。我观察到已经有类似Issue，但复现规律好像没有我这个详细具体。

Reproduce / 如何复现？

复现方式如下：
1、配置完成QQ官方机器人
2、发送任意消息并等待回复后，进入QQ的机器人聊天设置界面，删除聊天记录
3、此时会发现开始重复接收2次
4、重复第二步，会发现变为重复接收三次
根据初步测试，每次删除聊天记录都会导致重复接收次数+1

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

版本：V4.22
部署方式：包管理器部署
API提供商：腾讯云Coding Plan
适配器：QQ官方机器人

OS

Linux

Logs / 报错日志

[02:45:28.937] [Core] [INFO] [core.event_bus:66]: [QQ] [睦子米(qq_official)] B203BF5685989C80ABC79B54A01FA3D8: [At:qq_official] 晚安喵
[02:45:28.988] [Core] [INFO] [core.event_bus:66]: [QQ] [睦子米(qq_official)] B203BF5685989C80ABC79B54A01FA3D8: [At:qq_official] 晚安喵
[02:45:28.988] [Core] [INFO] [core.event_bus:66]: [QQ] [睦子米(qq_official)] B203BF5685989C80ABC79B54A01FA3D8: [At:qq_official] 晚安喵
[02:45:28.997] [Core] [INFO] [process_stage.follow_up:190]: Captured follow-up message for active agent run, umo=睦子米:FriendMessage:B203BF5685989C80ABC79B54A01FA3D8, order_seq=0
[02:45:28.998] [Core] [INFO] [process_stage.follow_up:190]: Captured follow-up message for active agent run, umo=睦子米:FriendMessage:B203BF5685989C80ABC79B54A01FA3D8, order_seq=1
[02:45:29.373] [Core] [INFO] [core.event_bus:66]: [QQ] [default(qq_official)] B203BF5685989C80ABC79B54A01FA3D8: [At:qq_official] 晚安喵
[02:45:29.378] [Core] [INFO] [core.event_bus:66]: [QQ] [睦子米(qq_official)] B203BF5685989C80ABC79B54A01FA3D8: [At:qq_official] 晚安喵
[02:45:29.388] [Core] [INFO] [process_stage.follow_up:190]: Captured follow-up message for active agent run, umo=睦子米:FriendMessage:B203BF5685989C80ABC79B54A01FA3D8, order_seq=2
[02:45:34.058] [Plug] [INFO] [meme_manager.main:692]: [meme_manager] 去重后的最终表情列表: []
[02:45:34.064] [Core] [INFO] [respond.stage:184]: Prepare to send - /B203BF5685989C80ABC79B54A01FA3D8: 快去睡，别刷手机了。
[02:45:35.946] [Plug] [INFO] [meme_manager.main:692]: [meme_manager] 去重后的最终表情列表: ['sleep']
[02:45:35.948] [Core] [INFO] [respond.stage:184]: Prepare to send - /B203BF5685989C80ABC79B54A01FA3D8: 晚安~我这边下午刚醒。睡个好觉，醒了找我
[02:45:43.213] [Plug] [INFO] [meme_manager.main:692]: [meme_manager] 去重后的最终表情列表: []
[02:45:43.215] [Core] [INFO] [respond.stage:184]: Prepare to send - /B203BF5685989C80ABC79B54A01FA3D8: （叹气）说了晚安还在发。

快去睡，别刷手机了。
[02:45:48.525] [Plug] [INFO] [meme_manager.main:692]: [meme_manager] 去重后的最终表情列表: []
[02:45:48.528] [Core] [INFO] [respond.stage:184]: Prepare to send - /B203BF5685989C80ABC79B54A01FA3D8: 说了晚安还在发。

别刷手机了，快去睡。
[02:45:54.573] [Plug] [INFO] [meme_manager.main:692]: [meme_manager] 去重后的最终表情列表: []
[02:45:54.576] [Core] [INFO] [respond.stage:184]: Prepare to send - /B203BF5685989C80ABC79B54A01FA3D8: （叹气）说了晚安还在发。

快去睡，别让我明天发现你又通宵了。

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

Hi @ku1yin! I'm Dosu and I’m helping the AstrBot team.

这是一个已知问题！你的问题与 Issue #5848 和 Issue #6857 描述的情况类似。

问题根源：

1. QQ 官方适配器缺少完善的消息去重机制 - 消息在 _commit 方法中直接放入队列，未基于 message_id 进行去重
2. QQ 官方 Webhook 重试机制 - 腾讯服务器在判断通知未被正确接收时会重试发送，最多重试三次
3. 清空聊天记录触发重连 - 删除聊天记录可能导致适配器重连或事件处理器残留，每次操作都会增加一个额外的消息监听实例

已有修复方案（PR #5899）建议实现多层去重：

• Event Bus 层：短时间窗口事件指纹去重
• Platform Manager 层：防止同一平台 ID 存在多个实例
• QQ 官方适配器层：分离 message_id 去重（长 TTL）和 sender+content 去重（短 TTL）

临时解决方案：

• 完全重启 AstrBot 进程，而不是只在界面关闭适配器
• 避免清空聊天记录或频繁启停适配器

如果你愿意提交 PR，可以参考上述去重策略进行修复。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[ku1yin]

如何完全重启AstrBot进程

[dosubot]

由于你使用的是 Linux 包管理器部署，可以通过 systemctl 命令完全重启 AstrBot：

systemctl --user restart astrbot.service

或者先停止再启动：

systemctl --user stop astrbot.service
systemctl --user start astrbot.service

可以通过以下命令确认服务状态：

systemctl --user status astrbot.service

这样可以确保旧的事件处理器被完全清理，解决消息重复接收的问题。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[Soulter]

无法复现

[BillionClaw]

Looking into this — the QQ adapter's event deduplication logic is likely failing after chat history is cleared. Happy to submit a fix.

[bugkeep]

版本：V4.22.2 模型是本地部署的deepseek-r1：7b,此模型不支持函数调用 该问题还是没有能够被解决，以下是日志： ```[2026-03-29 20:43:03.523] [Core] [INFO] [qqofficial.qqofficial_platform_adapter:546]: QQ 官方机器人接口 适配器已被优雅地关闭 [2026-03-29 20:43:05.764] [Core] [INFO] [routes.config:307]: Saving config, is_core=True [2026-03-29 20:43:05.766] [Core] [INFO] [platform.manager:125]: 载入 qq_official(default) 平台适配器 ... [2026-03-29 20:43:51.383] [Core] [INFO] [routes.config:307]: Saving config, is_core=True [2026-03-29 20:43:51.384] [Core] [INFO] [platform.manager:263]: 正在尝试终止 default 平台适配器 ... [2026-03-29 20:43:51.384] [Core] [INFO] [qqofficial.qqofficial_platform_adapter:546]: QQ 官方机器人接口 适配器已被优雅地关闭 [2026-03-29 20:43:52.818] [Core] [INFO] [routes.config:307]: Saving config, is_core=True [2026-03-29 20:43:52.820] [Core] [INFO] [platform.manager:125]: 载入 qq_official(default) 平台适配器 ... [2026-03-29 20:44:06.874] [Core] [INFO] [core.event_bus:66]: [default] [default(qq_official)] 41305301DA9B6611ECDF39A4C4A61CD1: [At:qq_official] 你在干嘛 [2026-03-29 20:44:06.877] [Core] [INFO] [core.event_bus:66]: [default] [default(qq_official)] 41305301DA9B6611ECDF39A4C4A61CD1: [At:qq_official] 你在干嘛 [2026-03-29 20:44:06.919] [Core] [INFO] [process_stage.follow_up:190]: Captured follow-up message for active agent run, umo=default:FriendMessage:41305301DA9B6611ECDF39A4C4A61CD1, order_seq=0 [2026-03-29 20:44:06.961] [Core] [INFO] [sources.openai_source:951]: deepseek-r1:7b 不支持函数工具调用，已自动去除，不影响使用。 [2026-03-29 20:44:07.272] [Core] [INFO] [core.event_bus:66]: [default] [default(qq_official)] 41305301DA9B6611ECDF39A4C4A61CD1: [At:qq_official] 你在干嘛 [2026-03-29 20:44:07.276] [Core] [INFO] [process_stage.follow_up:190]: Captured follow-up message for active agent run, umo=default:FriendMessage:41305301DA9B6611ECDF39A4C4A61CD1, order_seq=1 [2026-03-29 20:44:13.748] [Core] [INFO] [respond.stage:184]: Prepare to send - /41305301DA9B6611ECDF39A4C4A61CD1: 为了更好地理解您的健身需求和计划调整，您能具体说明您当前的学习目标或遇到的问题吗？这样我可以根据您的反馈为您定制更精准的计划！😊 [2026-03-29 20:44:14.089] [Core] [INFO] [sources.openai_source:951]: deepseek-r1:7b 不支持函数工具调用，已自动去除，不影响使用。 [2026-03-29 20:44:20.773] [Core] [INFO] [respond.stage:184]: Prepare to send - /41305301DA9B6611ECDF39A4C4A61CD1: 我一直在努力理解您的健身需求，并根据您的反馈调整训练计划和建议。如果您有任何新的目标或问题，请随时告诉我！😊 [2026-03-29 20:44:21.110] [Core] [INFO] [sources.openai_source:951]: deepseek-r1:7b 不支持函数工具调用，已自动去除，不影响使用。 [2026-03-29 20:44:26.918] [Core] [INFO] [respond.stage:184]: Prepare to send - /41305301DA9B6611ECDF39A4C4A61CD1: 我在根据您的健身目标和提供的信息（如身高体重、年龄等）制定并调整训练计划。如果您有一个新的目标或需要调整当前计划，请随时告诉我！😊 [2026-03-29 20:44:29.180] [Core] [INFO] [core.event_bus:66]: [default] [default(qq_official)] 41305301DA9B6611ECDF39A4C4A61CD1: [At:qq_official] 为什么 [2026-03-29 20:44:29.244] [Core] [INFO] [sources.openai_source:951]: deepseek-r1:7b 不支持函数工具调用，已自动去除，不影响使用。 [2026-03-29 20:44:29.618] [Core] [INFO] [core.event_bus:66]: [default] [default(qq_official)] 41305301DA9B6611ECDF39A4C4A61CD1: [At:qq_official] 为什么 [2026-03-29 20:44:29.622] [Core] [INFO] [process_stage.follow_up:190]: Captured follow-up message for active agent run, umo=default:FriendMessage:41305301DA9B6611ECDF39A4C4A61CD1, order_seq=0 [2026-03-29 20:44:29.641] [Core] [INFO] [core.event_bus:66]: [default] [default(qq_official)] 41305301DA9B6611ECDF39A4C4A61CD1: [At:qq_official] 为什么 [2026-03-29 20:44:29.644] [Core] [INFO] [process_stage.follow_up:190]: Captured follow-up message for active agent run, umo=default:FriendMessage:41305301DA9B6611ECDF39A4C4A61CD1, order_seq=1 [2026-03-29 20:44:37.740] [Core] [INFO] [respond.stage:184]: Prepare to send - /41305301DA9B6611ECDF39A4C4A61CD1: 我在根据您提供的健身目标和身体数据（如身高、体重、年龄、性别等）为您制定并调整您的训练计划和饮食建议。以下是大致的工作流程：

1. 分析您的数据：根据您的身高、体重、年龄、性别和健身目标，我计算出您的体脂率和所需的肌肉增长量。
2. 制定训练计划：基于您的目标（如增肌、减脂或全能训练），我为每个主要肌群（上肢、下肢、核心）设计每周的训练天数、重量和组数。
3. 生成饮食建议：根据您的活动水平和训练需求，我提供适合您的热量摄入、蛋白质摄入量、碳水化合物等的饮食指导。
4. 设定营养补充：如果需要，我会建议补充剂（如蛋白质粉）以辅助肌肉生长。
5. 动态调整计划：根据您的训练恢复情况和体能测试结果，我随时调整训练计划和饮食建议，确保效果最大化并避免受伤。

如果您有任何新的目标、需求或问题，请随时告诉我！😊
[2026-03-29 20:44:38.141] [Core] [INFO] [sources.openai_source:951]: deepseek-r1:7b 不支持函数工具调用，已自动去除，不影响使用。
[2026-03-29 20:44:46.562] [Core] [INFO] [respond.stage:184]: Prepare to send - /41305301DA9B6611ECDF39A4C4A61CD1: 我在根据您的健身目标和提供的身体数据（如身高、体重、年龄、性别等）为您制定并调整您的训练计划和饮食建议。以下是大致的工作流程：

1. 分析您的数据：根据您的身高、体重、年龄、性别和健身目标，我计算出您的体脂率和所需的肌肉增长量。
2. 制定训练计划：基于您的目标（如增肌、减脂或全能训练），我为每个主要肌群（上肢、下肢、核心）设计每周的训练天数、重量和组数。
3. 生成饮食建议：根据您的活动水平和训练需求，我提供适合您的热量摄入、蛋白质摄入量、碳水化合物等的饮食指导。
4. 设定营养补充：如果需要，我会建议补充剂（如蛋白质粉）以辅助肌肉生长。
5. 动态调整计划：根据您的训练恢复情况和体能测试结果，我随时调整训练计划和饮食建议，确保效果最大化并避免受伤。

如果您有任何新的目标、需求或问题，请随时告诉我！😊
[2026-03-29 20:44:46.930] [Core] [INFO] [sources.openai_source:951]: deepseek-r1:7b 不支持函数工具调用，已自动去除，不影响使用。
[2026-03-29 20:44:54.248] [Core] [INFO] [respond.stage:184]: Prepare to send - /41305301DA9B6611ECDF39A4C4A61CD1: 我按照您的健身目标、身体数据（如身高、体重、年龄、性别等）以及当前的健康状况，为您制定并调整训练计划和饮食建议。这个过程可以帮助您更好地实现增肌、减脂或全能训练的目标，并确保训练安全和效果最大化。

1. 分析您的数据：通过身高、体重和体脂率等信息，我能更好地了解您的身体状况，以及如何帮助您实现增肌、减脂或全能训练。
2. 制定训练计划：根据您的目标（如增肌、减脂或全能训练），我能为您设计专门的训练计划，确保每个主要肌群（上肢、下肢、核心等）都能得到充分的关注和负荷。
3. 生成饮食建议：饮食是训练成功的前提，我会根据您的活动水平和训练需求，为您制定适合的热量摄入、蛋白质摄入量、碳水化合物等饮食指导。
4. 设定营养补充：在合适的时机，我可能会建议补充剂（如蛋白质粉或碳水化合物补充剂）以辅助肌肉生长或提高训练效果。
5. 动态调整计划：根据您的恢复情况、训练效果和体能测试结果，我随时调整训练计划和饮食建议，确保训练效果最大化并避免受伤。

如果您有任何新的目标、需求或问题，请随时告诉我！😊

## 猜测：
- 1.qq_official 入站链路去重好像没有实现。
当前这条路径收到消息后会直接 _commit() 到事件队列，没有按 message_id 或内容做去重。只要上游重复投递，同一条消息就会被完整处理多次。
- 2.重复投递是在热重载后更容易触发的。
- 3.active agent 的 follow-up 机制把重复入站进一步放大了。同一句消息第一次进入正常问答，后续重复消息到来时，如果 agent 还在运行，就会被当作 follow-up 捕获，而不是被识别为重复事件。
- 4，私聊 sender 标识不统一，进一步增加了误判和漏判风险。
当前 qq_official 里：C2CMessage 用 user_openid,DirectMessage/Message 用 author.id
这意味着将来做 sender 维度去重或会话识别，这种不一致会导致一部分重复识别不到，或者把本来同一用户拆成两类。