zzzUI

Trace

Agent 执行过的步骤,每步一行:图标、执行的操作,以及行末一个淡色数值。

安装

terminal
# once per project: where @zzzui items come frompnpm dlx shadcn@latest registry add @zzzui=https://zzzui.catforest.dev/r/{name}.jsonpnpm dlx shadcn@latest add @zzzui/trace

示例

Agent 的四个步骤

Took the sealed crate0.4 sPlanning the routeMessage the north gate
trace-steps.tsx
import { CheckIcon, SearchIcon, SpinnerIcon } from "@/components/zero/icons";import {  Trace,  TraceCollapsible,  TraceCollapsibleContent,  TraceCollapsibleTrigger,  TraceDescription,  TraceIcon,  TraceLine,  TraceTitle,} from "@/components/zero/trace";export default function TraceSteps() {  return (    <Trace className="max-w-md">      <TraceCollapsible>        <TraceCollapsibleTrigger>          <TraceLine>            <TraceIcon>              <SearchIcon />            </TraceIcon>            <TraceTitle>Searched the job board</TraceTitle>            <TraceDescription>12 jobs</TraceDescription>          </TraceLine>        </TraceCollapsibleTrigger>        <TraceCollapsibleContent>          Rush jobs in the east district, sorted by reward. Three are within a          kilometre of the rail yards.        </TraceCollapsibleContent>      </TraceCollapsible>      <TraceLine>        <TraceIcon>          <CheckIcon />        </TraceIcon>        <TraceTitle>Took the sealed crate</TraceTitle>        <TraceDescription>0.4 s</TraceDescription>      </TraceLine>      <TraceLine status="running">        <TraceIcon>          <SpinnerIcon className="animate-spin [animation-duration:calc(var(--zero-dur-loop)/2)]" />        </TraceIcon>        <TraceTitle>Planning the route</TraceTitle>      </TraceLine>      <TraceLine status="pending">        <TraceIcon>          <CheckIcon />        </TraceIcon>        <TraceTitle>Message the north gate</TraceTitle>      </TraceLine>    </Trace>  );}

行为

运行中的步骤显示为强调色,失败的为红色,未开始的变暗。步骤可以展开(TraceCollapsible),显示其读取或写入的内容;内容左侧带一条淡色竖线,展开方式与 Collapsible 相同。

属性

TraceLine

属性类型默认值说明
status"running" | "error" | "pending"—步骤状态;不传时视为已完成。

Trace, TraceIcon, TraceTitle, TraceDescription, TraceCollapsible, TraceCollapsibleTrigger, TraceCollapsibleContent