用途：面向生成 OpenTelemetry 格式日志的项目，解析日志、重建执行 trace、提取带调用链上下文的错误，并给出 AI 根因分析。
主要能力：解析含 trace/span ID 的 OTEL 日志；重建完整执行 trace；提取错误及完整调用链；AI 根因分析；输出 summary、markdown、JSON；按错误 ID、trace ID、文件过滤；支持跳过 AI 的快速解析与实时监控。
使用方式：常用命令为 python3 .claude/tools/utils/log_analyzer.py {{LOG_DIR}}/{{LOG_FILE}}.log，先看摘要表获取错误 ID 与 trace ID。深入分析用 --error-id 1 --format markdown、--trace TRACE_ID --format markdown、--file database.py；快速免费解析用 --no-ai；保存报告用 --format markdown --output report.md；实时监控用 tail -f {{LOG_DIR}}/{{LOG_FILE}}.log。
适用场景：快速健康检查、具体错误调查、基于 trace 的调试、按文件排查、测试失败调试、生产问题调查，以及提交前或 CI 中检查新增错误。
限制：需项目生成 OpenTelemetry 格式日志并配置日志目录；依赖 log_analyzer.py 工具与 Python 3；AI 分析可能产生成本，可用 --no-ai 规避；资料未提供具体安装步骤、依赖清单、价格与平台支持信息。