Vercel CLI 新增 `vercel traces search`：在终端里直接检索请求调用链
Vercel CLI 上线
vercel traces search命令，开发者不必再打开浏览器控制台，就能在终端按环境、服务、状态、时间等条件检索请求的调用链步骤。命令默认返回最近一小时的数据，并支持--query与--json，方便脚本或 AI 编程助手直接消费链路数据。
为什么需要它
排查线上问题时，麻烦的往往不是数据本身看不懂，而是数据散落在浏览器控制台里，命令行工作流被反复打断。vercel traces search 把这一步搬回了终端：开发者本人，以及配合工作的编程助手，都能直接检索项目里的 trace span。
先理清两个概念：
- trace（调用链）：一次请求从进入系统到返回结果，中途经过的完整路径。
- span（调用链步骤）：这条路径上的某一个具体环节，比如一次数据库查询或一次外部接口调用。
搜索 span，等于沿着调用链逐层查看每一步到底发生了什么。排查报错、延迟异常和安全问题时，不需要再切到浏览器里的控制台。
默认搜索范围与过滤条件
不带任何参数时，命令返回最近一小时内、最多 100 个 span，最新的排在最前面。也就是说，开发者不必事先知道请求 ID 或 trace ID，也能直接开始搜索。
结果可以按以下条件过滤：
- 环境
- 服务
- span 名称
- 状态
- 部署 ID
- 请求 ID
- trace ID
- span ID
时间窗口可以用 --since 和 --until 进一步收窄。
用 --query 做更灵活的查询
如果某个过滤条件没有对应的独立选项，可以通过 --query 传入。Vercel 支持 Kibana 查询语言（KQL）的一个子集——KQL 是一套类似搜索语句的过滤语法，可以用来查询 duration（耗时）这类字段，也能查询 span 和资源的各类属性。
结构化输出，交给脚本或 AI 助手
加上 --json 后，每个 span 会输出为一个 JSON 对象，脚本和编程助手可以直接拿到结构化数据做分析。
对依赖 AI 编程助手或氛围编程（vibe coding，指用自然语言描述意图、由 AI 生成并迭代代码的写法）的工作流来说，这一点尤其实用：输出可以直接交给助手做链路分析，减少在终端和浏览器控制台之间来回切换的成本。
升级与查看帮助
运行 vercel upgrade 升级到最新版 Vercel CLI，再执行 vercel traces search --help 查看全部可用选项。更多细节可查阅 Vercel traces 文档。