用途:search-router 用于在代码搜索时按查询类型选择最合适的搜索工具,目标是提升 token 效率。适用场景包括查找代码模式、定位功能实现位置、查找特定标识符、理解代码工作方式。
主要能力与决策规则:代码探索(符号、调用链、数据流)默认使用 TLDR Search,命令为 tldr search "query" .,可加 --layer call_graph;结构查询(AST 模式,如 def foo、class Bar、import X、@decorator)使用 AST-grep(/ast-grep-find);语义查询(概念性问题,如认证如何工作)使用 TLDR Semantic,命令为 tldr semantic search "query";字面查询(精确文本、正则)才用 Grep,属最后手段;需要完整上下文时用 Read,输出约 1500+ token,应在定位到正确文件后使用。
token 效率对比:TLDR 约 50-500,适合代码符号、调用图、数据流;TLDR Semantic 约 100-300,适合概念查询;AST-grep 约 50,适合函数/类定义、导入、装饰器;Grep 约 200-2000,适合非代码文本与正则;Read 约 1500+,适合完整理解。
推荐流程:先用 AST-grep 找异步函数得到少量文件行匹配,再只 Read 最匹配项,跳过无关文件以节省 token。相关技能包括 /tldr-search、/ast-grep-find、/morph-search。限制:资料未提供安装方式、收费、平台支持与效果保证等信息。