文档摘要

OpenCode · 第 5 章 工具系统:从定义到注册运行时 章节摘要:Agent 能「动手」,靠的是工具——读文件、写文件、改代码、执行命令、搜索、抓网页、跑子任务。但 OpenCode 的工具系统不是把一堆函数塞进一个数组那么简单,它是一套三层抽象:最底层是工具定义(一个带参数 Schema 的描述,定义时编译一次校验器,执行时自动加校验、截断、链路追踪);中间是注册表(汇总内置工具、自定义工具、插件工具,还按模型特性过滤——比如某些模型系列用补丁式工具而非读写工具);最上是 LLM 侧的工具运行时(管本地工具的派发与结算、控制工具输出的大小边界)。本章要回答:一个工具从「定义」走到「模型可调用」,中间发生了什么?三层各管什么?为什么这样切?

---