agent-tracing

Agent Tracing 是一款专为 LobeHub 开发者设计的专业开发工具，旨在提供对 Agent 内部推理与执行生命周期的深度可视化。通过在开发过程中自动捕获执行快照，工程师可以深入检查 Agent 的决策过程，包括原始 LLM 交互、工具调用与 Context Engine 状态。这对于识别执行瓶颈、验证 Prompt 工程效果以及在本地环境中调试复杂的 function-calling 链条至关重要。

• 在开发模式下自动捕获执行步骤与快照，并序列化存储至 .agent-tracing 目录。

• 提供强大的终端界面，用于检查个别步骤、LLM 载荷、工具调用与 Context Engine 输入。

• 支持对消息、System Role、用户记忆与原始执行事件的细粒度检查。

• 包含用于列出最近追踪、清理陈旧部分快照以及比较运行时上下文的实用程序。

• 支持深入研究载荷结构，包括模型定义、知识库摘要与工具函数定义。

• 使用时请确保您的应用程序在 NODE_ENV=development 下运行，系统将自动记录交互数据至 .agent-tracing。

• 请从仓库根目录执行指令，以便 CLI 正确解析快照存储路径。

• 使用 inspect 指令来指定特定 Trace ID 或最新快照，并搭配 -s (步骤)、-m (消息)、-t (工具) 与 -c (上下文) 等标记来过滤输出。

• 本工具严格用于本地调试目的，由于基于文件的存储机制，不支持生产环境。

• 建议定期使用 partial clean 指令清理部分快照，以在反复开发过程中保持磁盘存储效率。