apply_diff

apply_diff 工具通过指定要替换的确切内容，对文件进行精确、精准的修改。它使用一种复杂的策略来查找和应用更改，同时保持正确的代码格式和结构。

参数

该工具接受以下参数：

path（必需）：相对于当前工作目录的目标文件路径。
diff（必需）：使用特定于活动 diff 策略的格式定义更改的搜索/替换块。
start_line（可选）：搜索内容开始位置的提示。注意：此顶级参数似乎未被当前主要策略使用，该策略依赖于 diff 内容中的 :start_line:。
end_line（可选）：搜索内容结束位置的提示。注意：此顶级参数似乎未被当前主要策略使用。

功能说明

此工具使用模糊匹配（基于行号提示引导）和行号提示来精确定位和替换内容，从而对现有文件应用有针对性的更改。与简单的搜索替换不同，它基于提供的内容和位置提示识别用于替换的确切块。

使用场景

当 Roo 需要对现有代码进行精确更改而不重写整个文件时。
当重构代码的特定部分同时保持周围上下文时。
当以精准的方式修复现有代码中的错误时。
当实现仅修改文件某些部分的功能增强时。

主要特性

使用模糊匹配（归一化字符串上的 Levenshtein 距离）并由 :start_line: 提示引导，具有可配置的置信度阈值（通常为 0.8-1.0）。
使用 BUFFER_LINES（默认为 40）提供匹配周围的上下文。
在提示的起始行周围使用可配置上下文窗口（bufferLines）进行从中间开始的搜索。
通过替换精确块被动地保持代码格式和缩进。
在 diff 视图中显示更改，供用户审查和编辑后再应用。
跟踪每个文件的连续错误次数（consecutiveMistakeCountForApplyDiff）以防止重复失败。
根据 .rooignore 规则验证文件访问。
有效处理多行编辑。

局限性

在具有唯一、独特代码部分的情况下效果最佳，以实现可靠的识别。
在处理非常大的文件或高度重复的代码模式时，性能可能有所不同。
如果内容模糊，模糊匹配有时可能选择错误的位置。
每个 diff 策略都有特定的格式要求。
复杂的编辑可能需要仔细的策略选择或手动审查。

工作原理

当调用 apply_diff 工具时，它遵循以下过程：

参数验证：验证必需的 path 和 diff 参数。
RooIgnore 检查：根据 .rooignore 规则验证目标文件路径是否被允许。
文件分析：加载目标文件内容。
匹配查找：使用模糊匹配算法（Levenshtein 归一化字符串）并由 :start_line: 提示引导，在上下文窗口（BUFFER_LINES）内进行从中间开始的搜索，根据置信度阈值定位目标内容。
更改准备：通过替换已识别的块生成建议的更改。
用户交互：
- 在 diff 视图中显示更改。
- 允许用户审查并可能编辑建议的更改。
- 等待用户批准或拒绝。
应用更改：如果获得批准，将应用更改（可能包括用户编辑）到文件。
错误处理：如果发生错误（例如，匹配失败、部分应用），增加文件的 consecutiveMistakeCountForApplyDiff 并报告失败类型。
反馈：返回结果，包括任何用户反馈或错误详细信息。

Diff 格式要求

<diff> 参数需要特定的格式，支持在单个请求中进行一个或多个更改。每个更改块都需要原始内容的行号提示。

要求：SEARCH 块内容必须完全匹配（在模糊阈值内），包括空白和缩进。每个块内必须包含 :start_line: 数字提示。:end_line: 提示是可选的（但解析器支持）。文件内容中必须转义（\\）的标记（如 <<<<<<<）在 SEARCH 块中必须转义。

<diff> 块的示例格式：

<<<<<<< SEARCH
:start_line:10
:end_line:12
-------
    // Old calculation logic
    const result = value * 0.9;
    return result;
=======
    // Updated calculation logic with logging
    console.log(`Calculating for value: ${value}`);
    const result = value * 0.95; // Adjusted factor
    return result;
>>>>>>> REPLACE

<<<<<<< SEARCH
:start_line:25
:end_line:25
-------
    const defaultTimeout = 5000;
=======
    const defaultTimeout = 10000; // Increased timeout
>>>>>>> REPLACE

实验性功能：多文件编辑（`MULTI_FILE_APPLY_DIFF`）

apply_diff 的一个实验性版本允许在单个工具调用中对多个文件应用更改。此功能通过 MULTI_FILE_APPLY_DIFF 实验标志激活。

实验模式的主要特性

多文件操作：在一次请求中编辑多个文件，简化复杂的重构任务。
批量批准 UI：当目标是多个文件时，会向用户显示单个 UI 以批准或拒绝所有更改，或单独管理每个文件的权限。
新 XML 格式：引入使用 <args> 和 <file> 标签的新结构化 XML 格式来处理多个操作。
向后兼容性：实验性工具仍与传统的单文件 path 和 diff 参数格式兼容。

实验模式的工作原理

实验检查：工具首先检查 MULTI_FILE_APPLY_DIFF 实验是否已启用。如果未启用，则回退到传统的 apply_diff 实现。
参数解析：解析新的 <args> XML 格式以识别所有目标文件及其相应的 diff 操作。它也可以处理传统的 path/diff 参数。
验证和批准：
- 它验证所有目标文件是否存在且可访问（未被 .rooignore 阻止）。
- 如果要修改多个文件，它会向用户显示批量批准对话框。
Diff 应用：对于每个已批准的文件，它使用 MultiFileSearchReplaceDiffStrategy 应用指定的 diff。此策略可以对单个文件应用多个不重叠的更改。
结果：返回总结所有尝试操作结果的综合结果消息。

新 Diff 格式（实验性）

实验模式在 <apply_diff> 工具调用中使用新的 XML 结构。

<args>：所有文件操作的容器。
<file>：要修改的每个文件的块。包含 <path> 和一个或多个 <diff> 标签。
<path>：文件的相对路径。
<diff>：包含更改的块。
- <content>：SEARCH/REPLACE 块。
- <start_line>：（可选）行号提示。

示例：一次调用中修改两个文件

<apply_diff>
  <args>
    <file>
      <path>src/services/auth.service.ts</path>
      <diff>
        <content>
<<<<<<< SEARCH
:start_line:50
-------
    const token_expiration = '15m';
>>>>>>> REPLACE
        </content>
      </diff>
    </file>
    <file>
      <path>src/config/auth.config.ts</path>
      <diff>
        <content>
<<<<<<< SEARCH
:start_line:12
-------
    rateLimit: 5,
=======
    rateLimit: 10,
>>>>>>> REPLACE
        </content>
      </diff>
    </file>
  </args>
</apply_diff>

参数​

功能说明​

使用场景​

主要特性​

局限性​

工作原理​

Diff 格式要求​

实验性功能：多文件编辑（MULTI_FILE_APPLY_DIFF）​

实验模式的主要特性​

实验模式的工作原理​

新 Diff 格式（实验性）​

参数