前言¶

在 DSH 生态中，智能体处理日志文件时，通常需要从大量文本中提取错误或异常信息。手动解析日志耗时且容易遗漏关键上下文。这个插件提供了自动化解析和聚合的能力，帮助快速定位问题。

这是什么¶

日志分析插件。由 uckkk 维护。解析日志文件，提取错误/异常/告警，按签名聚合统计，并返回结构化错误清单与上下文。纯 Node 实现，无网络、无外部服务。

核心功能¶

1. 聚合统计：统计错误/告警，按签名聚合错误类型分布，并返回错误行清单。
2. 上下文提取：按正则提取错误行及其上下文（前后 N 行）。
3. 关键词识别：识别 ERROR/FATAL/Exception/Traceback/panic/failed 等常见错误关键词。
4. 噪声去除：自动去掉时间戳、数字、路径等噪声。

安装与启用¶

使用以下命令安装：

dsh plugin add github:uckkk/dsh-log-analyzer

安装后，在 profile 的 package.json 的 dsh.profile.bundles 中加入 "dsh-log-analyzer"。

典型用法¶

• 分析日志错误：

  analyze_log(file="app.log")

• 提取特定错误及上下文：

  extract_errors(file="app.log", pattern="Timeout|Connection refused", context=3)

适用场景与注意¶

适合需要快速统计日志错误频率或提取特定异常上下文的场景。

注意事项：
- 超长日志默认只读尾部（5 万行），可通过 maxLines 调整。
- 安装即在本机运行第三方代码，请自行审阅源码。

结尾¶

该工具通过聚合统计和上下文提取，简化了日志排查流程。更多细节可参考项目主页或插件目录。