LogInsight 日志分析器总结文档

1. 环境准备

• 操作系统: Windows 11 (推荐使用 Windows Terminal 以获得最佳显示效果)
• 开发工具: Rust 编译器 (rustc/cargo 1.75+)
• 系统组件: 需要访问系统剪贴板权限 (用于 arboard 库)

2. 编译与运行

在项目根目录下使用 PowerShell 执行：

# 编译项目
cargo build --release

# 运行 (单文件)
cargo run -- "service.log"

# 运行 (多文件 - 通配符)
cargo run -- logs/*.log

# 运行 (多文件 - 显式列表)
cargo run -- file1.log file2.log file3.log

3. 核心功能特性

• 智能转码: 自动识别并转换 GB18030 编码（中文），并对日志内嵌的 UTF-8 JSON 字符串进行二次解码修复。
• 多行合并: 自动识别跨行打印的 JSON 结构，并将其还原为单条结构化记录。
• 原始行号: 在列表最左侧展示原始日志文件中的行号（Ln），方便与原始文件对照。
• 快速跳转: 支持通过行号直接跳转，支持顶部/底部快速直达。
• 实时追踪 (Live Tailing): 支持类似 tail -f 的实时监控功能。当日志文件追加内容时，程序会自动检测并增量加载新行。
• 噪声折叠: 自动识别并合并连续的 USB 轮询、线程清理及完全重复的日志行，大幅提升阅读效率。
• 高级搜索 (Advanced Search):
  • 复合过滤: Shift+S 打开面板，支持时间范围、内容正则、来源文件、多级别勾选组合过滤。
  • 相对时间: 时间字段支持 -1h (1小时前)、-30m (30分钟前)、-2d (2天前) 等自然语言输入。
• 性能分析:
  • Delta Time: 自动计算同线程相邻日志的时间差。
  • 卡顿高亮: 耗时 >100ms 显示黄色 [+100ms]，>1s 显示红色 [SLOW]。
• 可视化统计 (Smart Dashboard):
  • 系统健康度 (Health Gauge): 顶部绿色仪表盘实时显示系统健康评分 (0-100)，基于错误和警告密度自动计算。
  • 错误脉冲 (Error Pulse): 顶部迷你图展示最近的错误发生频率，快速识别异常波动。
  • 源分布图 (Source Distribution): 彩色饼状样式直观展示日志来源文件 Top 5 分布。
  • 趋势直方图: 底部直方图实时展示每分钟/每小时日志生成频率及错误趋势。
    • 统计指标: 顶部实时显示 总计日志数 和 峰值点 (Peak) 信息。
    • 预警颜色: 🟥红色 >500条 | 🟧橙色 >250条 | 🟦青色 正常。
• 错误滚动条 (Mini-map): 右侧滚动条以红色标记显示 Error 日志的相对位置，快速定位问题区域。
• 多轮 AI 聊天 (AI Chat Interface):
  • F3 专用视图: 提供完整的聊天界面，支持多轮对话。
  • 上下文挂载: 可以在日志视图中按 p 将特定日志“挂载”到聊天上下文中，AI 会针对这些日志进行深度分析。
  • 实时反馈: 聊天历史自动滚动，支持 AI 思考状态动画显示。
  • 上下文面板: 右侧实时展示已挂载的日志详情，支持自动换行显示完整内容。
• 持久化管理 (History & Search Templates):
  • 命令历史 (F4): 记录搜索、跳转、AI 分析历史，支持选中后按 Enter 一键重执行。
  • 搜索模板: 在高级搜索面板中通过 Ctrl+S 命名保存、Ctrl+L 快速加载常用组合。
  • 持久化存储: 数据自动保存至 ~/.loginsight/ 下的 history.json 和 templates.json。

4. 交互操作快捷键

5. AI 诊断与聊天

• 依赖: 需要本地运行 Ollama 服务 (ollama serve)
• 模型: 默认使用 qwen2.5-coder:7b (建议 16GB 内存及以上使用)
• 单行快速诊断: 选中日志行后按 a 键，程序会提取该行前后上下文发送给 AI。
• 多轮 Chat 模式:
  1. 在 F1 视图选中关键日志按 p 键挂载。
  2. 按 F3 进入聊天界面。
  3. 按 i 输入问题（如：“这几条日志显示了什么异常？”），AI 将结合挂载的日志进行回答。
  4. 聊天支持上下文记忆，可进行连续追问。

6. 配置系统

程序首次运行时会在当前目录生成 log_config.toml 配置文件，支持自定义：

• log_pattern: 日志解析正则表达式
• fold_rules: 折叠规则（可配置匹配类型和模式）
• ignore_patterns: 预解析过滤正则（匹配的日志行不会被加载）
• theme: 慢日志阈值、语法高亮颜色和翻页行数 (page_size，默认20)

语法高亮

日志内容会自动高亮显示：

• IP地址 (青色)
• URL链接 (蓝色)
• 文件路径 (黄色)

7. 常见问题排查

• 乱码问题: 若在终端看到乱码，请确保使用 Windows Terminal 或将代码页设为 UTF-8 (chcp 65001)。
• 按键无效: 禁止在 Cursor 或 VS Code 的集成终端运行，集成终端会拦截大量功能键。请务必在独立终端中运行。
• 文件占用: 若编译报错 拒绝访问 (os error 5)，表示旧版本程序仍在运行，请先关闭正在运行的 TUI 实例。
• 跳转失败: 跳转功能使用的是“原始行号”，如果日志经过过滤，跳转会定位到最接近该行号的可视日志。