Agent 对话可配置最大工具调用次数 + Token 优化 + 循环检测升级

[cyfung1031]

Checklist / 检查清单

• Fixes Issues [Feature] 建议暴露 AI Agent 最大工具调用限制并优化多轮 Tool Calling 下的 Token 消耗 #1545
• Code reviewed by human / 代码通过人工检查
• Changes tested / 已完成测试

背景

关联 #1545，解决内置 Agent 在长时间、高频 Tool Calling 场景中的三个问题：

1. 最大迭代次数固定为 50，复杂任务容易被强制中断；
2. 历史工具结果会在后续请求中重复携带，导致 Token 消耗持续增长；
3. 检测到重复/循环调用后仅提示模型，无法让用户及时介入。

实现内容

1. 可配置最大工具调用次数，并支持原会话继续执行

• 新增 AgentConfigRepo，通过 chrome.storage.local 持久化 chatMaxIterations：
  • 默认值：50
  • 可配置范围：1–1000
  • 对设置页输入、直接传参和异常/损坏的存储值统一进行取整、范围截断和默认值回退
• Agent Settings 新增“对话”分类及“最大工具调用次数”配置项。
• 达到迭代上限时：
  • 持久化带 errorCode: "max_iterations" 的错误消息；
  • UI 显示“继续对话”按钮；
  • 点击后在原会话中追加继续指令，并复用已持久化的历史继续执行，无需新建会话。
• 重建 LLM 上下文时跳过仅供 UI 展示的错误占位消息，避免将空的 assistant error message 重放给 Provider。

2. 降低长 Tool Loop 的 Token 消耗

Anthropic Prompt Cache

• 在 Anthropic 请求的最后一条消息上追加 cache_control 断点，使下一轮能够复用已经生成的消息前缀。
• 与已有的 system、tools 缓存断点配合，减少长 Tool Loop 中重复输入的计费 Token。

execute_script 大结果截断

• 序列化结果超过 30000 字符时，仅保留首尾各 15000 字符。
• 返回值附带 truncated: true 和 original_length，并提示 Agent 缩小返回结果或将大数据写入 OPFS。

Tool Result 滑动窗口裁剪

• 根据实际上下文占用，在 40%、60% 阈值分批触发裁剪；达到 60% 后，每新增 5 轮工具调用再滑动一次窗口。
• 保留最近 5 轮 assistant/tool 消息原文，更早的 tool result 替换为占位文本。
• 仅修改当前请求中传给 LLM 的内存消息，不影响 OPFS 中的完整历史和 UI 展示。
• 80% 以上仍优先使用现有 auto-compact 流程。
• Anthropic 的上下文占用计算会合并普通输入、cache creation 和 cache read Token，避免缓存用量导致阈值判断失真。

3. Loop Guard 支持用户介入

• 保留现有 tool_call_guard 的模型提醒和 system_warning 展示。
• 自上次确认后累计触发 2 次警告时，暂停 UI 对话并询问用户：
  • Continue：继续执行，并重置警告计数；
  • Stop：持久化停止说明并以 done 正常结束，而不是报错。
• 普通 UI 会话和后台会话均支持该交互；后台会话可在重新 attach 后恢复待回答的问题。
• 5 分钟无人回答时默认继续，并同步清理过期的 pendingAskUser 状态。
• 定时任务和子代理不传入交互回调，继续保持“只告警、不暂停”，避免无人值守任务被阻塞。
• 等待用户回答期间支持通过 AbortSignal 立即停止。

兼容性

• 默认最大迭代次数仍为 50，未修改设置的用户行为保持不变。
• 上下文裁剪不改写持久化消息，因此刷新页面、继续对话和历史展示不会丢失原始工具结果。
• 新增文案已覆盖全部 8 个 locale：zh-CN、en-US、zh-TW、ja-JP、ru-RU、de-DE、vi-VN、tr-TR。

Test plan

• 按 TDD 流程为新增行为和审查修复补充回归测试
• npm run test:ci — 3041/3041 tests passed（289 个测试文件）
• npm run lint — prettier / tsc / eslint 全部通过
• 覆盖配置边界值、继续对话、Anthropic cache、结果截断、上下文裁剪、Loop Guard 暂停/继续/停止/超时/中止等场景

调查过程与技术方案细节见 issue-1545-proposal.md。