v2.3.1

v2.3.1

发布日期：2026年9月7日

🚀 本次版本重点

本次更新落地了issue建议的 Agent 可恢复执行 与 agent rag tools 的封装。感谢社区用户 yzw0422 提出 issue #15。

• 🛡️ HITL 人工审批：白名单工具（默认 create_note_tool）执行前自动中断，前端弹出审批卡，approve/reject 后从原中断位置恢复执行；需审批的新工具只需在 DEFAULT_APPROVAL_TOOLS 加一行。
• 💾 Checkpoint 持久化：新增 agent_checkpoints / agent_checkpoint_writes 两张表，中断现场落库，页面刷新、断连或服务重启后可凭 pending_run_id 恢复；对话历史与执行状态分开存储。
• 🔍 审批可追溯：审批完成后现场保留，可查看审批前快照；同一 run 重复恢复会被拒绝，不会重复执行工具。

---

🎉 功能优化

🛡️ 审批与恢复

• 白名单工具执行前中断，approve/reject 后从原位置继续 3276a86
• 会话 pending_run_id 落库，刷新/断连/重启后可恢复 3276a86
• 审批完成后保留现场，新增审批快照查看接口，重复恢复返回 ALREADY_COMPLETED 3276a86
• 前端审批卡、中断帧处理与待审批恢复入口 78d54d7

💾 持久化

• 新增 checkpoint 两表与 MySQL saver，注册到建表流程 de8f258

---

⚒️ 工程化优化

• 新增 saver/中断/恢复端到端测试，审批链路共 95 个相关用例通过 de8f258 3276a86

---

⚠️ 升级注意

1. 新增 agent_checkpoints / agent_checkpoint_writes 数据表，应用启动时会自动创建，注意检查控制台输出
2. 每个审批过的 run 会保留一串 checkpoint 快照（上限约等于历史审批次数），暂无自动清理，介意表增长的可以先观察