AgentScope Java 源码图解：从一次调用，看

调通 AgentScope Java 后，我顺手把源码跑了一遍。结果发现：一次 call()，可能已经跑了多轮模型、执行了一批工具。

最容易绕进去的，是同一个入口既管问答，又管工具循环和暂停恢复。顺着方法往下翻，很快会撞上 Reactor、中间件、权限和持久化。

所以我按一条主线重排了阅读顺序：输入进会话，模型定下一步，框架执行工具，结果回上下文，直到产生终态。项目里按这个拆了十章，从模块地图一路讲到迁移问题。

真正跑起来，主循环就两件事：reasoning() 请求模型，acting() 处理工具。模型返回文本且没有工具调用才算普通结束；遇到工具就把结果写回上下文，再让模型接着判断。默认 maxIters=10，但到上限后会进入总结阶段，因此实际模型调用次数可能超过 10 次。

还有个反直觉的点：重新 call()，不一定是新提问。框架会先查有没有没配对的工具调用——比如上次停在人工确认，这次带确认结果回来，直接从原工具继续，不让模型重新生成动作。

模型调用那边，Model.stream() 返回的是分片。一边推给前端看，一边在本地拼完整消息。前端已经看到文本，不等于这段进了历史上下文。

工具执行前也过了好几关：坏 JSON 被单独隔离，不会悄悄变成空对象；过完中间件和权限才进批次。批量调用也不是全并行，只有标记并发安全的才会一起跑。

源码地址：https://github.com/liulangjietou/AgentScope-source-analysis