Codex 为什么不把所有工具都交给模型？讲透 tool_search、BM25 与模型替换

Sat, 08 Aug 2026 00:00:00 +0000

把模型想成只有一张小桌子的工程师。工具说明书有几百本时，全部摊在桌上既贵又难找；更好的办法是先给它一本目录，需要什么再取出最相关的几本。本文就讲清 Codex 怎样做这件事、为什么使用 BM25 排序，以及怎样把同一办法搬到 Python、Go 和其他模型上。

本文固定在 2026-08-07 发布的稳定版 rust-v0.147.0，源码 commit 为 be6e8eac；另复查了 2026-08-09 的 main commit 646f7c0a。先给两个不会误导人的结论：

模型第一次能看到哪些工具，不是一张永远不变的名单。 它会随模型、接入方式、运行环境和功能开关变化。
tool_search 和背后的 BM25 排序代码都已经写好，普通直连方式可以使用；但这个稳定版给 GPT-5.6 采用的 exec 集中调用方式漏掉了搜索入口。 这不是功能没开发，而是一条接线没有接通。

这篇文章写给谁
#

默认读者只需要知道“大模型可以调用外部工具”。不要求会 Rust，也不要求读过 Codex 源码。 如果你主要写 Python 或 TypeScript，后面的 Rust 连写可以直接理解成“筛选列表 → 改造每一项 → 收集结果”。

有两条阅读路线：

只想理解做法：读小桌子问题、机场图、工具搜索过程、跨语言复用和模型替换；
想跟进源码：继续读伪代码、Rust 对照、完整查询实例和源码索引。

先只记住四句大白话
#

先把 Rust 函数名和 OpenAI 的专有叫法全部擦掉，一个会使用工具的模型仍逃不开四件事：

Why Codex Does Not Give the Model Every Tool: tool_search, BM25, and Model Replacement

Sat, 08 Aug 2026 00:00:00 +0000

Think of the model as an engineer with a small desk. If hundreds of tool manuals cover it, every request becomes expensive and the right manual is harder to find. Codex instead provides a short catalog and retrieves only the most relevant manuals. This article explains that design, BM25 ranking, reuse in Python or Go, and model replacement.

This article is pinned to stable rust-v0.147.0, released on August 7, 2026, at commit be6e8eac. I also rechecked main at commit 646f7c0a on August 9. Two conclusions matter up front:

Tool Search on 卓琪的开发笔记

Codex 为什么不把所有工具都交给模型？讲透 tool_search、BM25 与模型替换

这篇文章写给谁 #

先只记住四句大白话 #

Why Codex Does Not Give the Model Every Tool: tool_search, BM25, and Model Replacement

这篇文章写给谁
#

先只记住四句大白话
#