[Bug]gemini循环调用工具

[Yao-lin101]

What happened / 发生了什么

当使用gemini模型供应商时会出现无限循环调用工具的情况，使用openai兼容的gemini端点则完全无法使用工具

Reproduce / 如何复现？

配置一个gemini供应商，并要求bot使用工具即可复现

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

linux，dockercompose部署，AstrBot 版本v4.25.5，消息平台OneBot v1l

OS

Linux

Logs / 报错日志

[2026-06-14 11:43:37.844] [Core][INFO][respond.stage:183]: Prepare to send - 影/1614170952:

[2026-06-14 11:43:37.844] [Core][INFO][runners.tool_loop_agent_runner:983]: Agent 使用工具: ['steal_meme']

[2026-06-14 11:43:37.845] [Core][INFO][runners.tool_loop_agent_runner:1037]: 使用工具：steal_meme，参数：{}

[2026-06-14 11:43:37.851] [Plug][INFO][handlers.meme_stealer:135]: [meme_manager] 人格 甜筒爱丽丝 的表情包收集偏好: 【表情包收集偏好】

允许：

• 像素风
• RPG风格
  -…

[2026-06-14 11:43:37.907] [Plug][INFO][handlers.meme_stealer:239]: [meme_manager] 手动偷图被相似度检测拦截: 与 stolen_1781408477.webp 相似度 0.9977

[2026-06-14 11:43:37.909] [Core][INFO][runners.tool_loop_agent_runner:1234]: Tool steal_meme Result: 该表情包已存在相似度极高的版本（文件名：stolen_1781408477.webp，相似度：99.77%），且当前人格已拥有该表情包使用权限，拒绝重复收录。

[SYSTEM NOTICE] Important: you have executed the same tool steal_meme 18 times consecutively. Repetition is now very high. Continue only if each call is clearly producing new information. Otherwise, change strategy, adjust arguments, or explain the limitation to the user.

[2026-06-14 11:43:45.533] [Core][INFO][respond.stage:183]: Prepare to send - 影/1614170952:

[2026-06-14 11:43:45.534] [Core][INFO][runners.tool_loop_agent_runner:983]: Agent 使用工具: ['steal_meme']

[2026-06-14 11:43:45.534] [Core][INFO][runners.tool_loop_agent_runner:1037]: 使用工具：steal_meme，参数：{}

[2026-06-14 11:43:45.541] [Plug][INFO][handlers.meme_stealer:135]: [meme_manager] 人格 甜筒爱丽丝 的表情包收集偏好: 【表情包收集偏好】

允许：

• 像素风
• RPG风格
  -…

[2026-06-14 11:43:45.596] [Plug][INFO][handlers.meme_stealer:239]: [meme_manager] 手动偷图被相似度检测拦截: 与 stolen_1781408477.webp 相似度 0.9977

[2026-06-14 11:43:45.598] [Core][INFO][runners.tool_loop_agent_runner:1234]: Tool steal_meme Result: 该表情包已存在相似度极高的版本（文件名：stolen_1781408477.webp，相似度：99.77%），且当前人格已拥有该表情包使用权限，拒绝重复收录。

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 @Yao-lin101! I'm Dosu and I'm helping the AstrBotTeam team.

这是一个已知的 Gemini 特有问题。AstrBot 的重复检测机制只是在工具返回结果中附加警告文本（即你日志中看到的 [SYSTEM NOTICE]），但这只是"软引导"——如果 Gemini 忽略这些警告，循环不会被强制停止 [1]。唯一的硬性限制是 max_agent_step（默认 30 轮）[2]。

根本原因： 目前有两个未合并的 PR 正在修复 Gemini 特有的无限循环问题：

• PR #8742：修复 assistant 消息带有前缀内容时，历史重建会丢失 tool_calls，导致 Gemini 进入无限循环
• PR #8418：修复 assistant 历史消息解析中 if-elif 链在 content 为字符串时跳过 tool_calls 的问题

临时缓解方案：

1. 降低 max_agent_step：在配置中将"工具调用轮数上限"设为 5-10，限制循环次数 [3]
2. 检查工具返回值：如果 steal_meme 插件在任务完成时返回非 None 的字符串（如你日志中的拒绝消息），agent 会认为"还需继续处理"。理想情况下工具完成后应返回 None [4]
3. 关注 PR fix(gemini): preserve assistant tool calls during history conversion #8742 和 feat: 让Gemini原生工具和函数工具tools兼容 #8418 的合并：这两个 PR 合并后应能从根本上解决此问题

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[zouyonghe]

Follow-up: #8787 covers one Gemini-specific root cause here by preserving assistant tool_calls during history conversion when assistant content is also present. I reviewed and approved #8787. The separate duplicate send_message_to_user mitigation in #8782 currently has changes requested because it can suppress legitimate current-user responses when send_message_to_user targets another session.