内置工具
apply_patch 工具
使用结构化补丁格式应用文件更改。它很适合多文件或多 hunk 编辑，在这些场景中单个 edit 调用会比较脆弱。
该工具接受单个 input 字符串，其中包装一个或多个文件操作：
*** Begin Patch
*** Add File: path/to/file.txt
+line 1
+line 2
*** Update File: src/app.ts
@@
-old line
+new line
*** Delete File: obsolete.txt
*** End Patch
参数
input（必需）：完整补丁内容，包括*** Begin Patch和*** End Patch。
说明
- 补丁路径支持相对路径（从工作区目录开始）和绝对路径。
tools.exec.applyPatch.workspaceOnly默认值为true（限制在工作区内）。仅当你有意让apply_patch在工作区目录外写入/删除时，才将它设为false。- 在
*** Update File:hunk 中使用*** Move to:来重命名文件。 *** End of File在需要时标记仅 EOF 插入。- 默认可用于 OpenAI 和 OpenAI Codex 模型。设置
tools.exec.applyPatch.enabled: false可禁用它。 - 可选择通过
tools.exec.applyPatch.allowModels按模型设置门控。 - 配置仅位于
tools.exec下。
示例
{
"tool": "apply_patch",
"input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"
}