其他
需要按问题类型选择 tldr…
把关于代码库结构、调用关系、复杂度、数据流、影响范围和模式搜索的问题映射到合适的 tldr 命令层。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
需要按问题类型选择 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/`;用于查找代码和结构化搜索。
- 按决策树选择命令层:What exists? 用 tree/structure;How does X connect? 用 context/calls;Why is X complex? 用 cfg;Where does Y flow? 用 dfg;What depends on Z? 用 slice;Find something? 用 search。
- 根据意图检测关键词选择层:Navigation 关键词 "what"、"where"、"find"、"exists" 对应 tree、structure、search;Architecture 关键词 "calls"、"uses"、"connects"、"depends" 对应 context、calls;Complexity 关键词 "complex"、"refactor"、"branches"、"paths" 对应 cfg;Data Flow 关键词 "variable"、"value"、"assigned"、"comes from" 对应 dfg;Impact 关键词 "affects"、"changes"、"slice"、"dependencies" 对应 slice/pdg;Debug 关键词 "bug"、"error"、"investigate"、"broken" 对应 cfg + dfg + context。
- 使用 `tldr-read-enforcer` 和 `tldr-context-inject` hooks:它们会自动从消息中检测意图、路由到合适的层,并把上下文注入工具调用;通常不需要手动运行这些命令。
- 当 hooks 没有提供所需层时,手动覆盖并强制指定分析:运行 `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`。
适用边界 · 注意事项
- 未安装 tldr CLI 或缺少对应子命令/语言分析支持时,这些命令不可用。
- 未启用 `tldr-read-enforcer` / `tldr-context-inject` hooks 时,不会自动检测意图、路由层或注入上下文,只能手动指定分析层。
- 只需简单文本查找或不需要结构/语义分析时,不必使用完整路由。