用途
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 提交之间进行代码审查时,需要了解调用关系变化、追踪某入口点到目标符号的调用路径,或单纯查看调用树的场景,尤其面向智能体驱动的代码审查流程。
限制
资料未说明各语言的具体支持细节、性能表现、错误处理方式及许可证等信息,暂未提供。