For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /changelog/search-backend-unify.md.
  • 简体中文
  • 搜索后端统一与只读路径放宽

    • 日期:2026-08-06
    • 提交refactor(search): find 改为单一 Rust backend 并放宽只读路径
    • 版本0.12.1-alpha.3

    此前,find 工具在系统没有 fd 时会尝试下载受管的 fd 二进制,否则退回内置 fallback;而 read / grep / find / list_dir / view_image 等只读工具只能访问当前工作区内的路径,工作区之外一律失败。本次更新将搜索路径访问统一为单一 Rust 后端,并放宽了只读工具的路径边界。

    主要变化

    1. find 改为单一 Rust 后端
      find 不再依赖系统或受管的 fd 二进制,统一使用内置的 ignore + globset 后端实现路径查找。无论环境里有没有 fdfind 都能一致工作,也少了一项需要下载/授权的二进制。

    2. 只读工具可访问工作区外已存在路径
      read / grep / find / list_dir / view_image 等只读工具现在可以访问工作区之外且已存在的路径,不再强制限定在工作区内。write / edit / bash(工作目录)的边界保持不变,仍然只允许在工作区内操作。

    3. 删除 allow_managed_fd 配置
      配置项 allow_managed_fd 已移除,只保留 allow_managed_rgallow_managed_rg 现在有三种取值:缺省表示实际需要下载时询问;true 允许下载/重建;false 禁用受管 rg(此时仍优先使用 PATH/bundled 的 rg,两者都不可用时退回 Rust 后端)。

    4. grep 内置 fallback 流式化
      grep 的内置 fallback 改用 grep-searcher 流式实现,并支持外部搜索根目录,搜索大目录时更省内存、更快出结果。

    相关说明

    • 文件类工具的路径边界与使用建议见文件类工具
    • 若文档中 config.toml 示例仍包含 allow_managed_fd,以本条目描述为准,后续会同步更新。