技能介绍

要解决什么问题

线上排障时，错误往往分散在 ~/logs 里多个 .log、.txt、.json 文件中，手工 grep 容易漏掉 FATAL、Exception 或重复出现的同一类报错。你需要一份按时间与模式整理过的摘要，而不是整屏原始行。

技能如何工作

log-analyzer 会遍历默认目录 ~/logs（也可指定单个或多个文件），识别常见严重级别关键词：ERROR、FATAL、CRITICAL、Exception、Failed 等，并按 P0～P4 优先级归类。

典型流程包括：

自动扫描：发现支持的日志文件；.gz、.zip 需先解压后再分析
错误提取：可带上下文（前后 2～3 行），并尝试提取堆栈、错误码、请求 ID
模式与时间：统计重复错误、按日期或时间段过滤（例如只分析某一天）
报告输出：生成结构化 Markdown，默认写入 ~/logs-analysis.md，单文件分析可写到如 ~/logs/app-analysis.md

也支持按自定义关键词或正则做模式匹配（例如 connection timeout），并汇总出现次数与位置。

适用边界与注意

技能面向本地/指定路径的离线归纳，不是长期 tail -f 监控；实时看流可配合 tmux 等工具。超大文件会分段读取，仍建议先用时间范围缩小范围。编码会尝试 UTF-8、GBK 等自动检测，异常时可手动指定。纯文本、JSON 及常见 Web/应用日志格式在文档中有说明，但极非标准格式可能需要你补充关键词规则。