前言¶

在 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 調整。
- 安裝即在本機運行第三方代碼，請自行審閱源碼。

結尾¶

該工具通過聚合統計和上下文提取，簡化了日誌排查流程。更多細節可參考項目主頁或插件目錄。