SuperAPI AI 工具集

calldiff

编程与开发

查看项目

更新于 11-06 07:04

技能介绍

用途

calldiff 面向智能体(agentic)代码审查场景,核心作用是对比不同 git 提交之间的调用栈差异,并支持 22 种语言。它可以帮助审查者看清代码改动后调用关系发生了哪些变化,而不只是文本层面的 diff。

主要能力

calldiff 包含三个子命令:

calldiff diff:对比两棵 git 树之间的调用栈。参数 from(前置引用,默认 HEAD)与 to(后置引用,默认工作区)均可省略,paths 用于限定路径前缀。选项包括 --entry(入口点)、--maxDepth(最大调用树深度,默认 12)、--from、--to。语义与 git diff 一致:不传引用时对比 HEAD 与工作区;传一个引用时对比该引用与工作区;传两个引用时对比这两个树。

calldiff reach:查找从某个入口点到目标符号的所有调用路径。参数 ref(git 引用,默认工作区)与 paths 可选。选项包括 --entry(入口点,格式为 functionName 或 ClassName.method)、--to(要到达的目标符号)、--maxDepth。

calldiff tree:查看一个或多个入口点的调用树(不做差异对比)。参数 ref 与 paths 可选,选项包括 --entry、--maxDepth。

使用方式

若 calldiff 命令不可用,可全局安装最新版本:

npm install -g calldiff@latest

运行 calldiff --help 可查看用法详情。

示例:

# HEAD 与工作区对比
calldiff diff

# 一个引用与工作区对比
calldiff diff main

# 两个提交或分支对比
calldiff diff abc123 def456

# 强制指定入口点
calldiff diff main feature --entry createAgentSession

# 查找工作区中的调用路径
calldiff reach --entry runCheckout --to sendEmail

# 在某个提交上查找路径,并限定到某目录
calldiff reach HEAD examples/checkout --entry runCheckout --to sendEmail

# 查看工作区中的调用树
calldiff tree --entry createAgentSession

# 查看某个提交中的调用树
calldiff tree HEAD --entry PiService.createAgentSession

向用户展示 calldiff 输出时,建议用带 diff 标记的代码块包裹,以便增删内容获得彩色语法高亮:

<calldiff 输出>

适用场景

适用于在 git 提交之间进行代码审查时,需要了解调用关系变化、追踪某入口点到目标符号的调用路径,或单纯查看调用树的场景,尤其面向智能体驱动的代码审查流程。

限制

资料未说明各语言的具体支持细节、性能表现、错误处理方式及许可证等信息,暂未提供。