9. 搜索工具 Grep 与 Glob所属分组工具系统概述GrepTool 与 GlobTool 是 Claude Code 的两个搜索工具——前者基于 ripgrep 做内容搜索后者基于rg --files --glob做文件名匹配。两者在 prompt 设计上各自侧重GrepTool 详细说明 ripgrep 语法与三种 output modeGlobTool 则强调按修改时间排序与开放式搜索用 AgentTool。在 UI 层面两者高度复用——GlobTool 直接 re-export GrepTool 的renderToolResultMessage因为它们共享 SearchResultSummary 组件。底层utils/ripgrep.ts是一个完整的 ripgrep 进程管理器它处理 system/builtin/embedded 三种 rg 模式、EAGAIN 重试、超时 SIGKILL 升级、流式输出等。utils/glob.ts则把rg --files --glob包装成简洁的glob()函数。本文从 prompt、UI、底层 utils 三个层面剖析这对搜索双胞胎。源码位置[tools/GrepTool/prompt.ts](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/tools/GrepTool/prompt.ts)[tools/GrepTool/UI.tsx](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/tools/GrepTool/UI.tsx)[tools/GlobTool/prompt.ts](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/tools/GlobTool/prompt.ts)[tools/GlobTool/UI.tsx](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/tools/GlobTool/UI.tsx)[utils/ripgrep.ts](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/utils/ripgrep.ts)[utils/glob.ts](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/utils/glob.ts)核心实现分析1. GrepTool prompt明确NEVER invoke grep or rg as a Bash commandgetDescription()短小但语义密集returnA powerful search tool built on ripgrep Usage: - ALWAYS use${GREP_TOOL_NAME}for search tasks. NEVER invoke \grep\ or \rg\ as a${BASH_TOOL_NAME}command. The${GREP_TOOL_NAME}tool has been optimized for correct permissions and access. - Supports full regex syntax (e.g., log.*Error, function\\s\\w) - Filter files with glob parameter (e.g., *.js, **/*.tsx) or type parameter (e.g., js, py, rust) - Output modes: content shows matching lines, files_with_matches shows only file paths (default), count shows match counts - Use${AGENT_TOOL_NAME}tool for open-ended searches requiring multiple rounds - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use \interface\\{\\}\ to find \interface{}\ in Go code) - Multiline matching: By default patterns match within single lines only. For cross-line patterns like \struct \\{[\\s\\S]*?field\, use \multiline: true\几个值得关注的点① 直接禁止模型用 Bash 调用 grep/rg理由是optimized for correct permissions and access——权限和访问路径已在工具内做了正确处理② 三种 output mode 明确列出content / files_with_matches / count让模型按需选择③ 专门提示 Go 代码中interface{}的转义陷阱ripgrep 字面括号需转义④ 跨行匹配需显式multiline: true避免默认贪婪匹配误伤。2. GlobTool prompt四条短描述GlobTool 的 prompt 极简exportconstDESCRIPTION- Fast file pattern matching tool that works with any codebase size - Supports glob patterns like **/*.js or src/**/*.ts - Returns matching file paths sorted by modification time - Use this tool when you need to find files by name patterns - When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead第三条sorted by modification time是关键特性——--sortmodified让最近修改的文件排在前这对模型定位最近改过的文件非常有用。第五条把开放式多轮搜索引导到 AgentTool与 GrepTool 形成职责切分。3. SearchResultSummary搜索结果的统一渲染GrepTool UI 中定义的SearchResultSummary组件被三种 output mode 共享functionSearchResultSummary({count,countLabel,secondaryCount,secondaryLabel,content,verbose}){// primary: Found 3 files// secondary: across 5 directories// verbose: 显示 ⎿ 缩进的 content// non-verbose: 单行 CtrlOToExpand 提示}它的精妙之处在于复数处理——当 count 为 1 时把countLabel.slice(0, -1)去掉尾部 ‘s’让显示从1 files变成1 file。secondaryCount/secondaryLabel用于 count 模式Found 5 matches across 3 files。verbose 模式额外渲染⎿缩进的 content非 verbose 模式仅显示一行带 CtrlOToExpand 提示。4. GrepTool 的 renderToolResultMessage 三分支exportfunctionrenderToolResultMessage({modefiles_with_matches,filenames,numFiles,content,numLines,numMatches},_progress,{verbose}){if(modecontent){returnSearchResultSummary count{numLines??0}countLabellinescontent{content}verbose{verbose}/}if(modecount){returnSearchResultSummary count{numMatches??0}countLabelmatchessecondaryCount{numFiles}secondaryLabelfilescontent{content}verbose{verbose}/}// files_with_matches modeconstfileListContentfilenames.map(filenamefilename).join(\n)returnSearchResultSummary count{numFiles}countLabelfilescontent{fileListContent}verbose{verbose}/}content 模式报 lines 数count 模式报 matchesfiles 双重计数files_with_matches 模式报 files 数——三种模式各自选择最有信息量的统计维度。5. GlobTool UI完全复用 GrepTool 渲染GlobTool 的 UI 文件极其精简最有意思的是这一行// Note: GlobTool reuses GrepTools renderToolResultMessageexportconstrenderToolResultMessageGrepTool.renderToolResultMessage;直接 re-export GrepTool 的渲染函数——因为 GlobTool 的输出也走files_with_matches形态一串文件路径完美匹配 GrepTool 的默认分支。userFacingName()返回Search而不是Glob让 UI 上 Glob 与 Grep 显示一致——对用户而言两者都是搜索。6. utils/ripgrep.ts三种 rg 模式getRipgrepConfig()根据运行环境选择三种 ripgrep 实现之一constgetRipgrepConfigmemoize(():RipgrepConfig{constuserWantsSystemRipgrepisEnvDefinedFalsy(process.env.USE_BUILTIN_RIPGREP)if(userWantsSystemRipgrep){const{cmd:systemPath}findExecutable(rg,[])if(systemPath!rg){// SECURITY: Use command name rg instead of systemPath to prevent PATH hijackingreturn{mode:system,command:rg,args:[]}}}if(isInBundledMode()){return{mode:embedded,command:process.execPath,args:[--no-config],argv0:rg}}constrgRootpath.resolve(__dirname,vendor,ripgrep)constcommandprocess.platformwin32?path.resolve(rgRoot,${process.arch}-win32,rg.exe) : path.resolve(rgRoot,${process.arch}-${process.platform},rg)return{mode:builtin,command,args:[]}})注释里有一处安全细节找到系统 rg 后仍用rg字面名而非完整路径防止恶意 ./rg.exe 在当前目录被 PATH 解析命中——OS 的NoDefaultCurrentDirectoryInExePath保护会让rg安全解析。三种模式分别是system用户系统装的 rgUSE_BUILTIN_RIPGREPfalse时启用embeddedbun 打包模式下rg 静态编译进 bun通过argv0rg派生builtinvendored 的预编译 rg 二进制按 arch-platform 分目录存放7. ripGrepRaw 的 SIGTERM→SIGKILL 升级embedded 模式下用spawn而非execFile因为 execFile 不支持 argv0。超时处理做了 SIGTERM→SIGKILL 升级letkillTimeoutId:ReturnTypetypeofsetTimeout|undefinedconsttimeoutIdsetTimeout((){if(process.platformwin32){child.kill()}else{child.kill(SIGTERM)killTimeoutIdsetTimeout(cc.kill(SIGKILL),5_000,child)}},timeout)注释解释ripgrep 在不可中断 I/O深度文件系统遍历状态下SIGTERM 可能被忽略。5 秒后升级到 SIGKILL 才能保证进程结束。Windows 上child.kill(SIGTERM)会抛错所以用默认 signal。8. EAGAIN 重试的单线程降级ripGrep()在处理 EAGAIN 错误时做了一次性单线程重试if(!isRetryisEagainError(stderr)){logForDebugging(rg EAGAIN error detected, retrying with single-threaded mode (-j 1))logEvent(tengu_ripgrep_eagain_retry,{})ripGrepRaw(args,target,abortSignal,(retryError,retryStdout,retryStderr){handleResult(retryError,retryStdout,retryStderr,true)},true)// Force single-threaded mode for this retry onlyreturn}注释强调Persisting single-threaded mode globally caused timeouts on large repos where EAGAIN was just a transient startup error——EAGAIN 是 Docker/CI 资源受限环境的瞬时启动错误全局降级到单线程会让大仓库超时。所以只对当次调用降级。9. RipgrepTimeoutError 与部分结果保留超时时不直接 reject而是判断是否有部分输出if(isTimeoutlines.length0){reject(newRipgrepTimeoutError(Ripgrep search timed out after${getPlatform()wsl?60:20}seconds. The search may have matched files but did not complete in time. Try searching a more specific path or pattern.,lines,))return}resolve(lines)有部分输出时丢弃最后一行可能不完整后返回——让模型至少能看到部分匹配而不是完全失败。WSL 默认 60 秒其他平台 20 秒反映了 WSL2 文件读取 3-5x 性能惩罚。10. ripGrepStream 的流式输出ripGrepStream()是为交互式搜索优化的流式版本exportasyncfunctionripGrepStream(args,target,abortSignal,onLines){// ...letremainderchild.stdout?.on(data,(chunk:Buffer){constdataremainderchunk.toString()constlinesdata.split(\n)remainderlines.pop()??if(lines.length)onLines(lines.map(stripCR))})// ...}注释提到这是 fzf 的change:reload模式——“first results paint while rg is still walking the tree”。remainder跨 chunk 保留半行避免行被切断。AbortSignal 用于提前停止例如用户输入变化触发新搜索。11. countFilesRoundedRg 的隐私化文件计数countFilesRoundedRg()用于遥测把文件数 round 到最近的 10 的幂constmagnitudeMath.floor(Math.log10(count))constpowerMath.pow(10,magnitude)returnMath.round(count/power)*power注释示例“8 → 10, 42 → 100, 350 → 100, 750 → 1000”。这是隐私保护——避免把仓库确切文件数上报。函数还跳过 home 目录计数避免触发 macOS TCC 权限对话框Desktop/Downloads/Documents 等需要用户授权。12. utils/glob.ts把 rg --files 包装成 glob()glob()函数把 ripgrep 的--files模式包装成简洁的文件名匹配 APIconstargs[--files,--glob,searchPattern,--sortmodified,...(noIgnore?[--no-ignore]:[]),...(hidden?[--hidden]:[]),]// Add ignore patternsfor(constpatternofignorePatterns){args.push(--glob,!${pattern})}// Exclude orphaned plugin version directoriesfor(constexclusionofawaitgetGlobExclusionsForPluginCache(searchDir)){args.push(--glob,exclusion)}constallPathsawaitripGrep(args,searchDir,abortSignal)注释说明--no-ignore默认 true不遵守 .gitignore--hidden默认 true包含隐藏文件——这与 BashTool prompt 里用 Glob 而非 find的设计意图一致让模型看到完整文件集避免被 .gitignore 误隐藏。getGlobExclusionsForPluginCache排除孤立插件版本目录是 plugin 系统的卫生措施。13. extractGlobBaseDirectory绝对路径拆分ripgrep 的--glob只接受相对模式所以extractGlobBaseDirectory把绝对路径拆成 baseDir relativePatternexportfunctionextractGlobBaseDirectory(pattern:string){constglobChars/[*?[{]/constmatchpattern.match(globChars)if(!match||match.indexundefined){constdirdirname(pattern)constfilebasename(pattern)return{baseDir:dir,relativePattern:file}}conststaticPrefixpattern.slice(0,match.index)constlastSepIndexMath.max(staticPrefix.lastIndexOf(/),staticPrefix.lastIndexOf(sep))// ...}Windows 下还处理了C:vsC:/的语义差异——C:是驱动器 C 的当前目录相对路径C:/才是驱动器根。这是跨平台兼容性的硬性细节。关键设计要点UI 复用极致化GlobTool 直接 re-export GrepTool 的renderToolResultMessageuserFacingName也统一为Search对用户隐藏工具边界。三种 rg 模式自适应system / embedded / builtin 三种 ripgrep 实现按环境择优security 注释明确防止 PATH 劫持。SIGTERM→SIGKILL 升级超时杀进程时先 SIGTERM5 秒后升级到 SIGKILL应对 ripgrep 在不可中断 I/O 中的杀不掉问题。EAGAIN 一次性单线程重试资源受限环境的瞬时错误用-j 1重试一次但绝不全局降级避免大仓库超时。部分结果保留超时和 buffer overflow 时丢弃可能不完整的最后一行后返回部分结果让模型至少能利用已得信息。ripgrep 隐私化计数countFilesRoundedRg把文件数 round 到 10 的幂跳过 home 目录避免触发 TCC 对话框体现遥测的隐私意识。与其他模块的关系AgentToolGrepTool 和 GlobTool 的 prompt 都把开放式多轮搜索引导到 AgentTool形成精确单次搜索用 Grep/Glob探索性搜索用 Agent的分工。BashToolGrepTool prompt 明确禁止模型用 Bash 调 grep/rg把搜索流量集中到工具系统内。permissions/filesystemgetFileReadIgnorePatterns给 glob 提供 ignore 模式normalizePatternsToPath把它们规范化到 searchDir 下。plugins/orphanedPluginFiltergetGlobExclusionsForPluginCache排除孤立插件版本目录避免搜索结果污染。components/CtrlOToExpand非 verbose 模式下搜索结果展示CtrlO 展开提示与 FileWriteTool 等共享同一交互范式。execFileNoThrowtestRipgrepOnFirstUse、codesignRipgrepIfNecessary都用这个安全包装调用子进程。小结GrepTool 与 GlobTool 是一对职责互补 UI 共享的搜索双胞胎。GrepTool 用详细 prompt 教模型 ripgrep 语法和三种 output modeGlobTool 用极简 prompt 强调按修改时间排序与开放式搜索转 AgentTool。底层utils/ripgrep.ts是一个完整的 rg 进程管理器处理三种实现模式、EAGAIN 重试、SIGTERM→SIGKILL 升级、流式输出、隐私化计数等真实工程问题。utils/glob.ts则把rg --files --glob包装成简洁 API处理绝对路径拆分与跨平台 Windows 驱动器语义。这套搜索基础设施让 Claude Code 在百万行代码库上也能秒级响应模型查询。
09-搜索工具Grep与Glob
发布时间：2026/7/17 1:33:36
9. 搜索工具 Grep 与 Glob所属分组工具系统概述GrepTool 与 GlobTool 是 Claude Code 的两个搜索工具——前者基于 ripgrep 做内容搜索后者基于rg --files --glob做文件名匹配。两者在 prompt 设计上各自侧重GrepTool 详细说明 ripgrep 语法与三种 output modeGlobTool 则强调按修改时间排序与开放式搜索用 AgentTool。在 UI 层面两者高度复用——GlobTool 直接 re-export GrepTool 的renderToolResultMessage因为它们共享 SearchResultSummary 组件。底层utils/ripgrep.ts是一个完整的 ripgrep 进程管理器它处理 system/builtin/embedded 三种 rg 模式、EAGAIN 重试、超时 SIGKILL 升级、流式输出等。utils/glob.ts则把rg --files --glob包装成简洁的glob()函数。本文从 prompt、UI、底层 utils 三个层面剖析这对搜索双胞胎。源码位置[tools/GrepTool/prompt.ts](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/tools/GrepTool/prompt.ts)[tools/GrepTool/UI.tsx](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/tools/GrepTool/UI.tsx)[tools/GlobTool/prompt.ts](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/tools/GlobTool/prompt.ts)[tools/GlobTool/UI.tsx](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/tools/GlobTool/UI.tsx)[utils/ripgrep.ts](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/utils/ripgrep.ts)[utils/glob.ts](file:///e:/2026plan/AI_Lab/claude-code-sourcemap-main/restored-src/src/utils/glob.ts)核心实现分析1. GrepTool prompt明确NEVER invoke grep or rg as a Bash commandgetDescription()短小但语义密集returnA powerful search tool built on ripgrep Usage: - ALWAYS use${GREP_TOOL_NAME}for search tasks. NEVER invoke \grep\ or \rg\ as a${BASH_TOOL_NAME}command. The${GREP_TOOL_NAME}tool has been optimized for correct permissions and access. - Supports full regex syntax (e.g., log.*Error, function\\s\\w) - Filter files with glob parameter (e.g., *.js, **/*.tsx) or type parameter (e.g., js, py, rust) - Output modes: content shows matching lines, files_with_matches shows only file paths (default), count shows match counts - Use${AGENT_TOOL_NAME}tool for open-ended searches requiring multiple rounds - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use \interface\\{\\}\ to find \interface{}\ in Go code) - Multiline matching: By default patterns match within single lines only. For cross-line patterns like \struct \\{[\\s\\S]*?field\, use \multiline: true\几个值得关注的点① 直接禁止模型用 Bash 调用 grep/rg理由是optimized for correct permissions and access——权限和访问路径已在工具内做了正确处理② 三种 output mode 明确列出content / files_with_matches / count让模型按需选择③ 专门提示 Go 代码中interface{}的转义陷阱ripgrep 字面括号需转义④ 跨行匹配需显式multiline: true避免默认贪婪匹配误伤。2. GlobTool prompt四条短描述GlobTool 的 prompt 极简exportconstDESCRIPTION- Fast file pattern matching tool that works with any codebase size - Supports glob patterns like **/*.js or src/**/*.ts - Returns matching file paths sorted by modification time - Use this tool when you need to find files by name patterns - When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead第三条sorted by modification time是关键特性——--sortmodified让最近修改的文件排在前这对模型定位最近改过的文件非常有用。第五条把开放式多轮搜索引导到 AgentTool与 GrepTool 形成职责切分。3. SearchResultSummary搜索结果的统一渲染GrepTool UI 中定义的SearchResultSummary组件被三种 output mode 共享functionSearchResultSummary({count,countLabel,secondaryCount,secondaryLabel,content,verbose}){// primary: Found 3 files// secondary: across 5 directories// verbose: 显示 ⎿ 缩进的 content// non-verbose: 单行 CtrlOToExpand 提示}它的精妙之处在于复数处理——当 count 为 1 时把countLabel.slice(0, -1)去掉尾部 ‘s’让显示从1 files变成1 file。secondaryCount/secondaryLabel用于 count 模式Found 5 matches across 3 files。verbose 模式额外渲染⎿缩进的 content非 verbose 模式仅显示一行带 CtrlOToExpand 提示。4. GrepTool 的 renderToolResultMessage 三分支exportfunctionrenderToolResultMessage({modefiles_with_matches,filenames,numFiles,content,numLines,numMatches},_progress,{verbose}){if(modecontent){returnSearchResultSummary count{numLines??0}countLabellinescontent{content}verbose{verbose}/}if(modecount){returnSearchResultSummary count{numMatches??0}countLabelmatchessecondaryCount{numFiles}secondaryLabelfilescontent{content}verbose{verbose}/}// files_with_matches modeconstfileListContentfilenames.map(filenamefilename).join(\n)returnSearchResultSummary count{numFiles}countLabelfilescontent{fileListContent}verbose{verbose}/}content 模式报 lines 数count 模式报 matchesfiles 双重计数files_with_matches 模式报 files 数——三种模式各自选择最有信息量的统计维度。5. GlobTool UI完全复用 GrepTool 渲染GlobTool 的 UI 文件极其精简最有意思的是这一行// Note: GlobTool reuses GrepTools renderToolResultMessageexportconstrenderToolResultMessageGrepTool.renderToolResultMessage;直接 re-export GrepTool 的渲染函数——因为 GlobTool 的输出也走files_with_matches形态一串文件路径完美匹配 GrepTool 的默认分支。userFacingName()返回Search而不是Glob让 UI 上 Glob 与 Grep 显示一致——对用户而言两者都是搜索。6. utils/ripgrep.ts三种 rg 模式getRipgrepConfig()根据运行环境选择三种 ripgrep 实现之一constgetRipgrepConfigmemoize(():RipgrepConfig{constuserWantsSystemRipgrepisEnvDefinedFalsy(process.env.USE_BUILTIN_RIPGREP)if(userWantsSystemRipgrep){const{cmd:systemPath}findExecutable(rg,[])if(systemPath!rg){// SECURITY: Use command name rg instead of systemPath to prevent PATH hijackingreturn{mode:system,command:rg,args:[]}}}if(isInBundledMode()){return{mode:embedded,command:process.execPath,args:[--no-config],argv0:rg}}constrgRootpath.resolve(__dirname,vendor,ripgrep)constcommandprocess.platformwin32?path.resolve(rgRoot,${process.arch}-win32,rg.exe) : path.resolve(rgRoot,${process.arch}-${process.platform},rg)return{mode:builtin,command,args:[]}})注释里有一处安全细节找到系统 rg 后仍用rg字面名而非完整路径防止恶意 ./rg.exe 在当前目录被 PATH 解析命中——OS 的NoDefaultCurrentDirectoryInExePath保护会让rg安全解析。三种模式分别是system用户系统装的 rgUSE_BUILTIN_RIPGREPfalse时启用embeddedbun 打包模式下rg 静态编译进 bun通过argv0rg派生builtinvendored 的预编译 rg 二进制按 arch-platform 分目录存放7. ripGrepRaw 的 SIGTERM→SIGKILL 升级embedded 模式下用spawn而非execFile因为 execFile 不支持 argv0。超时处理做了 SIGTERM→SIGKILL 升级letkillTimeoutId:ReturnTypetypeofsetTimeout|undefinedconsttimeoutIdsetTimeout((){if(process.platformwin32){child.kill()}else{child.kill(SIGTERM)killTimeoutIdsetTimeout(cc.kill(SIGKILL),5_000,child)}},timeout)注释解释ripgrep 在不可中断 I/O深度文件系统遍历状态下SIGTERM 可能被忽略。5 秒后升级到 SIGKILL 才能保证进程结束。Windows 上child.kill(SIGTERM)会抛错所以用默认 signal。8. EAGAIN 重试的单线程降级ripGrep()在处理 EAGAIN 错误时做了一次性单线程重试if(!isRetryisEagainError(stderr)){logForDebugging(rg EAGAIN error detected, retrying with single-threaded mode (-j 1))logEvent(tengu_ripgrep_eagain_retry,{})ripGrepRaw(args,target,abortSignal,(retryError,retryStdout,retryStderr){handleResult(retryError,retryStdout,retryStderr,true)},true)// Force single-threaded mode for this retry onlyreturn}注释强调Persisting single-threaded mode globally caused timeouts on large repos where EAGAIN was just a transient startup error——EAGAIN 是 Docker/CI 资源受限环境的瞬时启动错误全局降级到单线程会让大仓库超时。所以只对当次调用降级。9. RipgrepTimeoutError 与部分结果保留超时时不直接 reject而是判断是否有部分输出if(isTimeoutlines.length0){reject(newRipgrepTimeoutError(Ripgrep search timed out after${getPlatform()wsl?60:20}seconds. The search may have matched files but did not complete in time. Try searching a more specific path or pattern.,lines,))return}resolve(lines)有部分输出时丢弃最后一行可能不完整后返回——让模型至少能看到部分匹配而不是完全失败。WSL 默认 60 秒其他平台 20 秒反映了 WSL2 文件读取 3-5x 性能惩罚。10. ripGrepStream 的流式输出ripGrepStream()是为交互式搜索优化的流式版本exportasyncfunctionripGrepStream(args,target,abortSignal,onLines){// ...letremainderchild.stdout?.on(data,(chunk:Buffer){constdataremainderchunk.toString()constlinesdata.split(\n)remainderlines.pop()??if(lines.length)onLines(lines.map(stripCR))})// ...}注释提到这是 fzf 的change:reload模式——“first results paint while rg is still walking the tree”。remainder跨 chunk 保留半行避免行被切断。AbortSignal 用于提前停止例如用户输入变化触发新搜索。11. countFilesRoundedRg 的隐私化文件计数countFilesRoundedRg()用于遥测把文件数 round 到最近的 10 的幂constmagnitudeMath.floor(Math.log10(count))constpowerMath.pow(10,magnitude)returnMath.round(count/power)*power注释示例“8 → 10, 42 → 100, 350 → 100, 750 → 1000”。这是隐私保护——避免把仓库确切文件数上报。函数还跳过 home 目录计数避免触发 macOS TCC 权限对话框Desktop/Downloads/Documents 等需要用户授权。12. utils/glob.ts把 rg --files 包装成 glob()glob()函数把 ripgrep 的--files模式包装成简洁的文件名匹配 APIconstargs[--files,--glob,searchPattern,--sortmodified,...(noIgnore?[--no-ignore]:[]),...(hidden?[--hidden]:[]),]// Add ignore patternsfor(constpatternofignorePatterns){args.push(--glob,!${pattern})}// Exclude orphaned plugin version directoriesfor(constexclusionofawaitgetGlobExclusionsForPluginCache(searchDir)){args.push(--glob,exclusion)}constallPathsawaitripGrep(args,searchDir,abortSignal)注释说明--no-ignore默认 true不遵守 .gitignore--hidden默认 true包含隐藏文件——这与 BashTool prompt 里用 Glob 而非 find的设计意图一致让模型看到完整文件集避免被 .gitignore 误隐藏。getGlobExclusionsForPluginCache排除孤立插件版本目录是 plugin 系统的卫生措施。13. extractGlobBaseDirectory绝对路径拆分ripgrep 的--glob只接受相对模式所以extractGlobBaseDirectory把绝对路径拆成 baseDir relativePatternexportfunctionextractGlobBaseDirectory(pattern:string){constglobChars/[*?[{]/constmatchpattern.match(globChars)if(!match||match.indexundefined){constdirdirname(pattern)constfilebasename(pattern)return{baseDir:dir,relativePattern:file}}conststaticPrefixpattern.slice(0,match.index)constlastSepIndexMath.max(staticPrefix.lastIndexOf(/),staticPrefix.lastIndexOf(sep))// ...}Windows 下还处理了C:vsC:/的语义差异——C:是驱动器 C 的当前目录相对路径C:/才是驱动器根。这是跨平台兼容性的硬性细节。关键设计要点UI 复用极致化GlobTool 直接 re-export GrepTool 的renderToolResultMessageuserFacingName也统一为Search对用户隐藏工具边界。三种 rg 模式自适应system / embedded / builtin 三种 ripgrep 实现按环境择优security 注释明确防止 PATH 劫持。SIGTERM→SIGKILL 升级超时杀进程时先 SIGTERM5 秒后升级到 SIGKILL应对 ripgrep 在不可中断 I/O 中的杀不掉问题。EAGAIN 一次性单线程重试资源受限环境的瞬时错误用-j 1重试一次但绝不全局降级避免大仓库超时。部分结果保留超时和 buffer overflow 时丢弃可能不完整的最后一行后返回部分结果让模型至少能利用已得信息。ripgrep 隐私化计数countFilesRoundedRg把文件数 round 到 10 的幂跳过 home 目录避免触发 TCC 对话框体现遥测的隐私意识。与其他模块的关系AgentToolGrepTool 和 GlobTool 的 prompt 都把开放式多轮搜索引导到 AgentTool形成精确单次搜索用 Grep/Glob探索性搜索用 Agent的分工。BashToolGrepTool prompt 明确禁止模型用 Bash 调 grep/rg把搜索流量集中到工具系统内。permissions/filesystemgetFileReadIgnorePatterns给 glob 提供 ignore 模式normalizePatternsToPath把它们规范化到 searchDir 下。plugins/orphanedPluginFiltergetGlobExclusionsForPluginCache排除孤立插件版本目录避免搜索结果污染。components/CtrlOToExpand非 verbose 模式下搜索结果展示CtrlO 展开提示与 FileWriteTool 等共享同一交互范式。execFileNoThrowtestRipgrepOnFirstUse、codesignRipgrepIfNecessary都用这个安全包装调用子进程。小结GrepTool 与 GlobTool 是一对职责互补 UI 共享的搜索双胞胎。GrepTool 用详细 prompt 教模型 ripgrep 语法和三种 output modeGlobTool 用极简 prompt 强调按修改时间排序与开放式搜索转 AgentTool。底层utils/ripgrep.ts是一个完整的 rg 进程管理器处理三种实现模式、EAGAIN 重试、SIGTERM→SIGKILL 升级、流式输出、隐私化计数等真实工程问题。utils/glob.ts则把rg --files --glob包装成简洁 API处理绝对路径拆分与跨平台 Windows 驱动器语义。这套搜索基础设施让 Claude Code 在百万行代码库上也能秒级响应模型查询。
相关文章
5个核心功能揭秘：为什么League Akari能彻底改变你的英雄联盟游戏体验？
5个核心功能揭秘：为什么League Akari能彻底改变你的英雄联盟游戏体验？ 【免费下载链接】League-Toolkit An all-in-one toolkit for LeagueClient. Gathering power 🚀. 项目地址: https://gitcode.com/gh_mirrors/le/League-Toolkit …
Python函数定义def关键字全解析
为了达成单一, 或者相关联功能, 代码段被组织好, 且可重复使用, 这便是函数。于编程语言之内, def关键字构成了定义函数的基础。凭借函数, 程序员能够创建出可重复使用的代码块, 进而提升代码的模块性以及重用性, 并且提高应用的模块性, 还有代码的重复利用率。一、def关键字的…
GreatSQL复制中断问题分析与解决方案
1. 问题现象与背景分析 最近在排查一个GreatSQL异步复制环境的问题时，遇到了一个典型的IO线程中断案例。主从复制环境运行一段时间后，从库的IO线程突然停止工作，错误日志中出现了这样的报错： 2026-02-16T12:36:40.08662008:00 1…
豆包Pro深度解析：5088元买的是专业级知识工作流系统
1. 豆包收费公告背后的三层信号：不是涨价，是产品定位的彻底转向“确认了，豆包开始收费，最高5088元一年！”——这条消息在社交平台刷屏时，我正用豆包整理一份200页的行业研报PDF。三分钟内完成摘要、提取关键…
新版C4升级遇阻：配置变更与兼容性故障排查指南
1. 先搞清楚“新版C4”到底指什么，以及为什么会被“炸”看到这个标题，很多人的第一反应可能是“C4”是不是指某种软件、工具、模型或者代码库的新版本。但根据实际工程经验，我更倾向于认为这里的“C4”指的是某种配置、规则、策略或数据格式的…
5分钟快速上手：GBFR Logs - 碧蓝幻想Relink免费战斗数据分析神器
5分钟快速上手：GBFR Logs - 碧蓝幻想Relink免费战斗数据分析神器 【免费下载链接】gbfr-logs GBFR Logs lets you track damage statistics with a nice overlay DPS meter for Granblue Fantasy: Relink. 项目地址: https://gitcode.com/gh_mirrors/gb/gbfr-logs…
Windows 11系统优化全攻略：从基础到高级技巧
1. Windows 11系统优化基础准备在开始优化Windows 11之前，我们需要做好一些基础准备工作。就像盖房子需要打好地基一样，系统优化也需要从基础开始。1.1 系统版本确认与更新首先按下WinR组合键，输入"winver"查看当前系统版本。我建议…
FPGA上跑的4×4键盘扫描方案：按键实时显示十六进制码+单击蜂鸣反馈
本文还有配套的精品资源，点击获取 简介：一套开箱即用的VHDL键盘扫描工程，专为FPGA教学与基础开发设计。支持标准44矩阵键盘（16个键，对应0-F十六进制字符），按下任意键立即锁存并显示当前键值&…
SpringBoot+Vue美食商城完整工程包：含前后端代码、MySQL建表脚本与傻瓜式部署文档
本文还有配套的精品资源，点击获取 简介：直接可跑的美食类电商系统，后端用SpringBoot（JDK 1.8兼容），集成MyBatis-Plus操作MySQL 5.7数据库；前端基于Vue.js Element UI，实现用户注…
VS Code 高效配置与个性化定制全攻略
1. VS Code 高效配置基础作为一款轻量级但功能强大的代码编辑器，VS Code 的默认配置已经能满足基本需求，但通过合理调整设置可以大幅提升编码效率。我使用 VS Code 已经有五年多时间，期间尝试过各种配置方案，总结出这套适合大多数…
HarmonyOS 应用开发《掌上英语》第19篇:3D 翻转动画实现——ArkTS 动画系统全解析
3D 翻转动画实现——ArkTS 动画系统全解析引言 在移动应用中，卡片翻转动画是最受欢迎的交互动效之一，它能给用户带来直观的"物理世界"操作感。在我们的英语学习 App 的单词学习页面（CourseHomePage.ets）中，就…
BiSheng JDK-build性能调优：构建速度提升30%的优化策略
BiSheng JDK-build性能调优：构建速度提升30%的优化策略 【免费下载链接】bishengjdk-build BiSheng JDK build and test scripts - common across all releases/versions 项目地址: https://gitcode.com/openeuler/bishengjdk-build 前往项目官网免费下载&am…
MQ-2 烟雾传感器 ESP32-S3 驱动实战：ADC 读取与阈值校准 3 步完成
MQ-2 烟雾传感器 ESP32-S3 驱动实战：ADC 读取与阈值校准 3 步完成在智能家居和工业安全监测领域，烟雾检测是一个至关重要的环节。MQ-2 作为一款高性价比的半导体烟雾传感器，因其对多种可燃气体（如液化气、丙烷、氢气等）…
SPEC CPU 2006 v1.0.1 基准测试实战：ARM/X86/MIPS 三平台配置与 3 轮测试结果解读
SPEC CPU 2006 跨平台基准测试深度实战：ARM/X86/MIPS 架构配置优化与结果分析方法论在当今多元化的计算架构时代，如何客观评估不同处理器平台的真实性能成为系统工程师和性能优化专家的核心挑战。SPEC CPU 2006 作为业界公认的计算密集型基准测试套件&am…
每天60s读懂世界：2026年7月11日重点要闻解读
🔥 个人主页：杨利杰YJlio❄️ 个人专栏：《Windows 疑难杂症与工单复盘案例库》 《Sysinternals实战教程》《WINDOWS教程》 《Windows PowerShell 实战》 《人工智能实战合集》《超简单：用Python让Excel飞起来》🌟…
FAE放射组学分析工具：医学影像特征探索的完整解决方案
FAE放射组学分析工具：医学影像特征探索的完整解决方案 【免费下载链接】FAE FeAture Explorer 项目地址: https://gitcode.com/gh_mirrors/fae/FAE 你是否曾经面对海量医学影像数据感到无从下手？想要从CT、MRI等影像中提取有价值的定量特征&#…
0.69B参数实现中文多模态AI：揭秘Qwen3-SmVL模型融合技术的完整实战指南
0.69B参数实现中文多模态AI：揭秘Qwen3-SmVL模型融合技术的完整实战指南 【免费下载链接】happy-llm 📚 从零开始构建大模型 项目地址: https://gitcode.com/GitHub_Trending/ha/happy-llm 还在为大型多模态模型动辄数十亿参数、显存占用高而烦恼&…
解锁AMD Ryzen处理器性能潜力的SMU调试神器：从新手到专家的完整指南
解锁AMD Ryzen处理器性能潜力的SMU调试神器：从新手到专家的完整指南 【免费下载链接】SMUDebugTool A dedicated tool to help write/read various parameters of Ryzen-based systems, such as manual overclock, SMU, PCI, CPUID, MSR and Power Table. 项目地址…