用途:作为在项目中定位文件与代码内容的主要入口,并支持跨多文件的批量替换重构。
主要能力:smart_find 按文件名或路径查找文件,支持正则或 glob 模式、extension 过滤(如 py、rs、md)、exclude 排除,search_mode 可选 filename(fd)或 content(rg -l);smart_search 搜索文件内文本或正则,支持 file_globs 过滤(如 "*.py .ts")、case_sensitive 与 context_lines 上下文行数;batch_replace 执行多文件查找替换,参数为 pattern、replacement、file_glob(默认 **/)、dry_run(默认 True,先预览)。
使用方式:不确定文件位置时先用 smart_find;需要理解匹配上下文时用 smart_search 并设置 context_lines;批量改名或重构用 batch_replace,先看 dry-run 结果再执行。示例意图:查找所有 Python 文件用 smart_find(extension="py");定位类定义用 smart_search(pattern="class Kernel");查找包含 API_KEY 的文件用 smart_find(pattern="API_KEY", search_mode="content");重命名变量用 batch_replace。
适用场景:代码库探索、按名称找文件、按内容搜索、正则定位模式、跨文件批量重构。
限制:所有工具自动遵循 .gitignore;建议使用具体正则以减少噪声。具体安装命令、性能数据与平台支持暂未提供。