排错指南

1) memo 为空

• 没有触发 resize：设置 every_n_turns，或手动 session.resize()
• memo_update_handler 没返回 dict：确保返回结构化字典
• 模型没输出 JSON：加强 output 约束或使用 ensure_keys

2) 设置了 mode=memo，但仍然走 lite

这是默认策略行为。mode=memo 只是启用 memo 更新， 是否 lite/deep 取决于策略。

解决方式：

• 提高 every_n_turns 的频率
• 调低 max_messages_text_length
• 或直接 resize(force="deep")

3) 对话越来越长

Quick Session 会无限增长历史。若需控制长度：

agent.enable_session_lite(chars=12000, messages=8)

4) 结构化解析失败

建议：

• output 只允许 JSON
• 用 ensure_keys=["memo"]
• 失败时回退到旧 memo