用途：通过命令行从 LangSmith Studio 获取执行轨迹，用于调试 LangChain 和 LangGraph 智能体。触发场景包括用户询问“调试我的智能体”“最近发生了什么”“检查错误”“分析内存操作”“查看工具调用”“检查性能与 Token 用量”等。
主要能力：拉取最近若干分钟或指定时间之后的轨迹与线程；支持 pretty、json、raw 三种输出格式，便于查看或做管道分析；可附带元数据（智能体类型、模型、标签、环境）；支持并发拉取以加速大批量导出；可导出到指定目录用于归档或共享；配合 grep 可检索错误与内存相关操作。
用法前提：先安装 pip install langsmith-fetch，并设置环境变量：export LANGSMITH_API_KEY="your_langsmith_api_key" 与 export LANGSMITH_PROJECT="your_project_name"，可用 echo $LANGSMITH_API_KEY 与 echo $LANGSMITH_PROJECT 验证。常用命令包括：langsmith-fetch traces --last-n-minutes 5 --limit 5 --format pretty 做快速调试；langsmith-fetch trace <trace-id> --format json 深挖单条轨迹；langsmith-fetch traces ./debug-session --last-n-minutes 30 --limit 50 导出会话；langsmith-fetch threads --limit 10 获取会话线程；langsmith-fetch config show 与 langsmith-fetch config set project "your-project-name" 管理配置；--concurrent 10 可并发加速，--include-metadata 附加元数据，--after "2025-12-24T13:00:00Z" 按时间过滤。
适用场景：智能体无响应、调用错误工具、记忆未生效、性能过慢、错误聚类分析，以及在提交代码前做健康检查。
限制：资料未说明内置重试机制的具体实现、平台支持范围与性能上限；若提示“No traces found matching criteria”，需检查时间范围、项目名、API Key，并确认代码中启用 LANGCHAIN_TRACING_V2=true；环境变量若未持久化，可写入 ~/.bashrc 或 ~/.zshrc 后 source 重新加载。版本 0.1.0，MIT 许可。