用途:查找没有任何非测试调用者的公共函数,识别疑似死代码。命令入口为 /dead-code,参数 [scope] 可用于限定扫描范围:无参数扫描整个仓库,文件路径扫描单个文件,目录扫描子树,subsystem: 前缀扫描 RNA 检测到的子系统。
主要能力:借助 RNA 图数据查询入边(incoming edges),筛选出零非测试调用者的函数,并能沿调用链追查整条死代码链。
使用方式:先运行 search(query="capability", verbose=true, limit=1) 检查能力就绪状态,必须确认 extracted graph、LSP call/reference coverage 以及 global dead-code prerequisites 均为 ready,否则应中止并报告前置条件失败,不能退回到局部 LSP 覆盖或仅结构边扫描。随后用 search(kind="function", file="<scope>", limit=50) 收集函数,记录 ID、名称、入边数、Test 标记和装饰器。再对候选逐个用 search(node="<function-id>", mode="neighbors", direction="incoming", limit=10) 查看来电调用者,过滤测试引用后确认是否为零非测试调用者。候选较多时可用 search(nodes=[...], compact=true) 批量查询,最后以表格形式报告函数、文件、非测试调用者数、置信度和备注。
限制:结果并非编译器判定,属于启发式,存在误报,例如框架回调、trait 实现、FFI 导出、CLI 分发目标等。动态分发、宏生成的调用点、再导出以及跨根调用者可能无法被图边捕获。全局死代码分析依赖仓库级 LSP 覆盖,局部覆盖不足以支撑。