跳到主要内容

文件与搜索

核心文件工具(默认目录始终包含):

工具作用
builtin_read_file / builtin_read_currently_open_file读取
builtin_create_new_file / builtin_write_file / builtin_edit_file创建和编辑
builtin_apply_patchUnified-diff / Apply Patch hunks
builtin_view_subdirectory列目录(模型省略 maxFiles 时默认上限 1000 个文件)
builtin_glob按模式找路径
builtin_exact_search精确 / 正则搜索(ripgrep 风格)
builtin_view_repo_map结构地图

延迟:builtin_enhanced_search、builtin_view_diff、builtin_generate_tests。

apply_patch 模糊匹配​

Hunk 可容忍缩进、行尾空白、引号/破折号漂移、过期上下文(git 风格 fuzz)、残缺的首/末行,以及 unified-diff 的 --- / +++ 包装。Add File 在路径已存在时会覆盖(与 write 相同)。

补丁仍失败时,2.1.3+ 会更紧地重试写入;你也可以从对话应用(Alt+A / ⌥A)或用 Cmd+I。

Review edits​

打开 Review edits 时,文件工具在 内存 里暂存。Apply 才写盘(Apply all 会先打检查点)。Shell 仍看到 真实 磁盘,不是暂存树。

路径策略​

始终:

  • 硬拒绝:~/.ssh、~/.gnupg、**/.ssh/**(词面 和 解析后的路径)
  • 机密文件(.env*、*.pem、id_*)即使 Auto 也 询问
  • 工作区 之外 的路径询问或拒绝(解析符号链接)
  • Cargo registry 写入 拒绝;允许读 ~/.cargo/registry/src

.knoxignore 影响检查点和部分遍历;不能替代在不信任树上使用 Ask。

下一步​

工具目录 · 终端与 git · Review edits