[OSS26] 关键词搜索文件路径 search_files_by_keyword

接口介绍

按文件名或路径关键词在指定代码仓库内检索文件,返回命中文件的路径、文件名、大小与语言标识,支持扩展名过滤。

工具名

search_files_by_keyword

背景与目标

LLM Agent 经常需要先按"业务关键词"找到相关源文件再深入分析。例如要审计登录链路时,先搜 Login / Auth 相关文件;要审计文件上传时搜 Upload。这是代码搜索的"文件维度"补集,与 search_code_by_keyword 配套使用。

输入参数

输出结构

{
  "total_matches": 7,
  "results": [
    {
      "file_path": "src/main/java/com/example/auth/LoginController.java",
      "filename": "LoginController.java",
      "size_bytes": 4821,
      "language": "java"
    }
  ]
}

验收标准

• 1 万文件量级仓库响应 < 1s
• 默认排除 .git/、node_modules/、target/、build/、dist/
• extensions 过滤生效
• 单元测试覆盖:正则模式、空仓库、超大量结果截断

预估工作量

0.5-1 人日(适合新手熟悉项目结构)

Start by locating the search_files_by_keyword tool entry point and the existing search_code_by_keyword implementation to understand how tools accept parameters and return results. Add the specified filename/path matching, extension filtering, directory exclusions, result limit, and metadata, then add unit tests for regex mode, an empty repository, and truncation of large result sets. Confirm the tool meets the stated response-time target on a repository of about 10,000 files.