第5章：工具调度算法

Tue, 09 Jun 2026 00:00:00 +0800

“When a tool is called, the real challenge isn’t executing it — it’s everything that happens before and after.”

5.1 问题引入

当LLM生成一段包含 tool_use 块的响应——例如"我需要读取文件 src/main.ts"——系统面临一连串精密的调度决策：

工具发现：从40余个注册工具中，根据名称（或别名）精确定位到 FileReadTool；
输入验证：用 Zod Schema 验证 LLM 生成的参数是否合法——模型并不总能生成正确的类型；
权限裁决：经过 PreToolUse Hook → 规则匹配 → 分类器 → 用户交互的多级权限链，决定是否允许执行；
并发编排：如果 LLM 同时请求了5次文件读取和1次写入，系统需要判断哪些可以并行、哪些必须串行；
流式执行：工具在执行过程中通过 AsyncGenerator 逐步报告进度，而非等到完成才返回；
结果注入：将工具执行结果编排为 tool_result 消息，按正确顺序注入回消息流，形成下一轮对话的上下文；
推测执行：在用户还未确认提示建议时，系统就在后台预执行可能的工具调用，以减少端到端延迟。

这不是一个简单的"查表→调用→返回"的过程。它是一个涉及并发控制、流式处理、权限安全、容错回退的完整调度系统。本章将逐一拆解这些算法。

5.2 工具注册与发现算法

5.2.1 注册表的构建

Claude Code 的工具注册采用静态声明 + 动态过滤的两阶段模型。所有工具在 src/tools.ts 中被集中声明，形成一个"全量工具池"：

源码位置：src/tools.ts — getAllBaseTools()

function getAllBaseTools() -> Tool[]:
 baseTools = [
 AgentTool, BashTool, FileReadTool, FileEditTool,
 FileWriteTool, GlobTool, GrepTool, WebFetchTool,
 WebSearchTool, NotebookEditTool, ...
 ]

 // 特性门控：根据环境变量和 feature flag 动态注入
 if feature('AGENT_TRIGGERS'):
 baseTools.append(CronCreateTool, CronDeleteTool, CronListTool)
 if isWorktreeModeEnabled():
 baseTools.append(EnterWorktreeTool, ExitWorktreeTool)
 if isToolSearchEnabledOptimistic():
 baseTools.append(ToolSearchTool)
 // ... 更多条件注入

 return baseTools

关键设计决策有三个：

反馈闭环 on Last Stand

第5章：工具调度算法

5.1 问题引入

5.2 工具注册与发现算法

5.2.1 注册表的构建