本页内容
本页内容
工具
apply_patch 工具
使用结构化补丁格式来应用文件更改。这非常适合多文件或多块编辑,因为单次 edit 调用可能不够稳健。
该工具接受一个单独的 input 字符串,其中包含一个或多个文件操作:
*** Move to: 在其 *** Update File: 报头之后直接上线。 *** End of File 跟随它终止的块行,标记该块运行到文件末尾。
参数
input(必填):完整的补丁内容,包括*** Begin Patch和*** End Patch。
说明
- Patch 路径支持相对路径(相对于工作区目录)和绝对路径。
- 将
./~/file用于~目录中的文件;~/file保留其主目录含义。 tools.exec.applyPatch.workspaceOnly默认为true(包含工作区)。仅当您有意希望工作区目录之外的apply_patch为 write/delete 时,才将其设置为false。- 该设置与
tools.exec.mode无关。设置tools.exec.mode: "full"不会提升apply_patch工作区边界。 tools.fs.workspaceOnly独立包含apply_patch,因此清除一个设置可以使另一个设置保持有效。- 显式会话权限模式会覆盖这两个配置设置:
full删除其遏制,guarded和workspace包含apply_patch,而read-only省略该工具。 - 所需的工作空间根目录和沙箱限制仍然适用于
full模式。将补丁路径保留在所需的根目录内;更改配置设置或会话模式都无法解除它。 - 当主机工作区边界拒绝补丁时,操作员日志会命名配置、会话策略、工作线程默认值或所需的根负责人。 OpenClaw 和 Codex harness均提供此建议;模型可见的拒绝保持不变。沙盒桥拒绝保留了自己的解释。
- 内存刷新运行仅公开
read和仅附加write,因此即使在full模式下,apply_patch也不可用。 - 运行其整个代理在工作线程上执行(
worker-turn) 忽略这两个配置设置。在无权限模式下,它们包含apply_patch只要有空就可以;明确的full模式会禁用该工具的遏制。仅用于远程命令的工作人员(remote-exec) 遵循本地运行代理的文件工具策略。 *** Add File:和非自身的*** Move to:要求目标路径不存在。若要有意替换某个路径,请在同一个补丁中先删除该路径,然后再添加或移动替换内容。- 对于工作区包含的主机路径,更新可以遵循工作区内的目录别名。添加并移动到新文件拒绝别名父级;删除最终符号链接会删除链接本身。通过别名移动到同一文件会就地应用更新。
- 在
*** Update File:块中使用*** Move to:来重命名文件。 *** End of File标记 EOF-only 在需要时插入。- 每个模型默认启用。设置
tools.exec.applyPatch.enabled: false以禁用它,或使用tools.exec.applyPatch.allowModels将其限制为特定模型(接受gpt-5.4等原始 id 或openai/gpt-5.4等完整 id)。 - 该工具的启用和模型设置位于
tools.exec.applyPatch.*下。
示例
相关内容
本页有帮助吗?