先定义一个核心词——turn（回合）：你发一条消息后，模型可能来回调用好几轮工具，直到给出不含工具调用的最终回答。这"一来一回若干轮直到收尾"整体，就是一个 turn。

这个循环在代码里分成清晰的三层，各司其职（三层用 generator 的 yield* 串起来）：

把一次 turn 拆成 8 步（对应真实代码位置，Day 06 再逐行）：

把上面 8 步套到一个具体输入上，像调试器一样单步走一遍——需求是「把 config.json 里的 debug 改成 false」：

你可能以为"看模型返回的 stop_reason 是不是 tool_use 就行"。但代码里明确注释说这个不可靠（query.ts:751）。它改用一个更硬的判据：

// query.ts:1090 —— 唯一的"继续循环"信号
const msgToolUseBlocks = content.filter(c => c.type === 'tool_use')
if (msgToolUseBlocks.length > 0) {
  toolUseBlocks.push(...msgToolUseBlocks)
  needsFollowUp = true          // ← 流式过程中只要出现过 tool_use block，就必须再来一轮
}

这是循环能"转起来"的关键——工具跑完，结果要变成模型下一轮能看到的输入。每个工具产出一条 user 角色、含 tool_result 块的消息（query.ts:1673），回合末尾拼进下一轮：

// query.ts:2043 —— 三者拼成下一轮输入
const next = {
  messages: messagesForQuery.concat(assistantMessages, toolResults),
  //          历史             +  模型这轮的回复   +  工具执行结果
}
state = next    // continue → 下一轮 callModel 就带着 tool_result 再问模型

健壮性细节：如果已经告诉模型"我调了工具"却因异常没产出结果，yieldMissingToolResultBlocks（query.ts:149）会为每个悬空的 tool_use 补一条 is_error 的结果——否则 API 会报"tool_use 没有对应 tool_result"的错。

循环层返回一个 Terminal 类型（src/query/transitions.ts），穷举了所有停止原因。主要几类：

其中最有意思的是 Stop hook 能"逼"模型继续干（query.ts:1557）：模型说"我完事了"，但如果配置了 Stop hook 且它返回"还没达标"，循环会把错误插回消息并 continue——相当于对模型说"不行，接着做"。还有 token budget（query.ts:1598）：没花够预算时会插一条 nudge 让模型继续用满。这些"续命"机制 Day 10 细讲。

你在终端看到的"逐字蹦出来"的打字机效果，来自 API 层对 SSE 流的处理（claude.ts:2075 的 switch(part.type)）：

• content_block_delta：文字增量 push 进缓冲、工具入参 JSON 一段段拼（claude.ts:2150）。
• content_block_stop：一个块结束，拼成完整的 assistant 消息 yield 出去（claude.ts:2270）。
• 每处理完一个流事件，还无条件再 yield 一条原始 stream_event（claude.ts:2408）。

✋ 动手

# 1. 看会话层怎么消费循环层
sed -n '217,260p' src/QueryEngine.ts
sed -n '688,700p' src/QueryEngine.ts

# 2. 看循环层的 while(true) 主体（核心中的核心）
sed -n '460,470p' src/query.ts        # 循环开始
sed -n '1079,1103p' src/query.ts      # 检测 tool_use
sed -n '2032,2045p' src/query.ts      # 拼回下一轮

# 3. 看 API 层流式 switch
sed -n '2075,2090p' src/services/api/claude.ts

# 4. 看所有停止原因
sed -n '1,20p' src/query/transitions.ts