精确修改文件

使用方式

每条替换都以原始文件为匹配基础，不是以上一条替换后的文本为基础。oldText 必须唯一定位原始文件中一段互不重叠的文本。同一文件多个分离位置宜在一次调用中提交；同块或邻近修改应合并，不能为了连接远距离修改而包含大量不变文本。

在对话中描述需求，由 Agent 决定是否调用。以下是 Agent 工具参数，不是公开 HTTP API。

输入参数

调用示例

在已读取的目标文件中，将唯一出现的指定原文替换为新文本，保留其他内容。

{
  "tool": "edit",
  "arguments": {
    "path": "<目标文件路径>",
    "edits": [
      {
        "oldText": "<原文件中唯一匹配的文本>",
        "newText": "<替换后的文本>"
      }
    ]
  }
}

示例仅用于说明结构，不会在浏览此页时执行。

返回结果

成功时返回替换块数量的确认，details 提供显示用 diff、标准统一补丁 patch，以及可用时的 firstChangedLine。

执行范围与限制

• 文件必须已存在且可读、可写；edits 在运行时必须至少包含一项。
• 每项 oldText 都必须唯一匹配且互不重叠，不能把多个替换当成顺序执行的编辑链。
• 示例原文占位符需要替换为实际读取到的精确文本；结构有效并不代表能匹配实际文件。