用途:tldr-router 是一个“问题到命令”的路由器,把关于代码库的提问映射到最合适的 tldr 命令层,帮助在探索、架构理解、复杂度分析、数据流、影响分析和搜索等场景中选对工具。
主要能力与映射:
- “有哪些文件/函数?”→ tldr tree . --ext .py 或 tldr structure src/ --lang python,用于起步探索与定位。
- “X 调用了谁/谁调用了 X?”→ tldr context <function> --project . --depth 2 或 tldr calls src/,用于理解架构与入口点。
- “X 有多复杂?”→ tldr cfg <file> <function>,用于识别重构候选与难度。
- “变量 Y 从哪来?”→ tldr dfg <file> <function>,用于调试与数据流理解。
- “什么影响了第 Z 行?”→ tldr slice <file> <function> <line>,用于影响分析与安全重构。
- “搜索模式 P”→ tldr search "pattern" src/,用于查找代码与结构化搜索。
决策树:从“存在什么”走向 tree/structure;“如何连接”走向 context/calls;“为何复杂”走向 cfg;“数据如何流动”走向 dfg;“依赖什么”走向 slice;“查找某物”走向 search。
意图关键词:导航类(what、where、find、exists)对应 tree、structure、search;架构类(calls、uses、connects、depends)对应 context、calls;复杂度类(complex、refactor、branches、paths)对应 cfg;数据流类(variable、value、assigned、comes from)对应 dfg;影响类(affects、changes、slice、dependencies)对应 slice/pdg;调试类(bug、error、investigate、broken)对应 cfg + dfg + context。
自动集成:tldr-read-enforcer 与 tldr-context-inject 钩子会自动从消息中检测意图、路由到相应层,并把上下文注入工具调用,通常无需手动执行这些命令。
手动覆盖:若钩子未提供所需层,可手动运行,例如 tldr cfg path/to/file.py function_name、tldr dfg path/to/file.py function_name、tldr slice path/to/file.py function_name 42。
限制:资料未提供安装方式、依赖要求、支持语言范围、收费与平台信息,暂未提供。