SuperAPI AI 工具集

tldr-deep

编程与开发

查看项目

更新于 10-16 03:15

技能介绍

用途:对指定函数做完整五层分析,适合调试、重构、代码审查和排查性能热点(高圈复杂度)。

主要能力(五层):L1 AST 结构(tldr extract <file>);L2 调用图(tldr context <func> --depth 2);L3 控制流 CFG(tldr cfg <file> <func>);L4 数据流 DFG(tldr dfg <file> <func>);L5 程序切片(tldr slice <file> <func> <line>)。输出按 Deep Analysis 格式给出签名、文档字符串、调用与被调用、基本块数量与圈复杂度(大于 10 标记为热点)、分支位置、变量定义与使用行号、切片关键依赖以及相对原始文件的 token 节省量。

使用方式:可通过命令 /tldr-deep <function_name> 或自然语言“analyze function X in detail”“I need to deeply understand how Y works”触发。执行时先定位文件:tldr search "def <function_name>" .,再依次运行各层命令。也提供 Python API:from tldr.api import extract_file, get_relevant_context, get_cfg_context, get_dfg_context, get_slice;示例调用 extract_file("src/processor.py")、get_relevant_context("src/", "process_data", depth=2)、get_cfg_context("src/processor.py", "process_data")、get_dfg_context("src/processor.py", "process_data")、get_slice("src/processor.py", "process_data", target_line=42)。

适用场景:调试需理解函数全部路径、重构需知依赖关系、代码审查复杂函数、定位高复杂度性能热点。

限制:资料未提供支持的编程语言范围、安装方式、依赖要求、收费与平台信息;切片需指定目标行号,圈复杂度阈值固定为 10。