MaaLogAnalyzer

✨ 可视化分析基于 MaaFramework 开发应用的用户日志 ✨
🔍 告别手翻百万行日志！用可视化+搜索的方式，高效定位、分析你的 Maa 应用运行问题 🔍

在线使用 | VSCode 插件 | 本地使用

核心功能

模块	说明
日志分析	按任务展示执行过程 支持识别/动作详情查看 支持节点导航快速定位 支持虚拟滚动 支持布局比例保存
文本搜索	支持关键字/正则搜索 支持搜索历史与快捷检索 支持大文件流式搜索 支持结果跳转上下文 支持布局比例保存
流程图	基于 ELK 的节点关系可视化 支持执行顺序导航与回放 支持回放速度与聚焦缩放持久化 点击节点可高亮关联节点与连线
节点统计	展示节点成功/失败、耗时等统计信息 适合做整体运行质量观察
分屏模式	上半区日志分析 + 下半区文本搜索 便于结构与原文对照排查 支持布局比例保存
新手教程	首次加载样例数据后自动引导 按板块讲解主要功能 支持按教程版本增量引导 可在“关于 -> 快速开始”再次启动

支持的输入

• 单文件：maa.log、maa.bak.log、maafw.log、maafw.bak.log
• 文件夹：自动识别日志文件
• 压缩包：支持从 zip 中提取日志内容

Web 示意图

本地开发

环境

• Node.js 18+
• pnpm 8+
• Rust（仅 Tauri 开发/打包需要）

安装依赖

pnpm install

Web 开发 / 构建

pnpm dev
pnpm build

Tauri 开发 / 打包

pnpm tauri:dev
pnpm tauri:build

VS Code 插件 Webview 构建

pnpm build:vscode

仓库结构

.
├─ src/                 # 前端主应用（Web/Tauri 共用）
├─ src-tauri/           # Tauri 工程
├─ src-vscode/          # VS Code 插件工程
├─ docs/                # 文档
├─ sample/              # 示例日志
├─ public/              # 静态资源
└─ README.md

更多文档

• 新手教程协议文档：docs/TUTORIAL_PROTOCOL.md
• VSCode 插件说明：src-vscode/README.md

许可证

MIT License

致谢

• MaaFramework - 自动化框架
• maa-support-extension - 界面设计导师
• M9A - 最佳实践

开发者

感谢以下开发者对 MaaLogAnalyzer 作出的贡献：

沟通交流

MaaFramework 开发交流 QQ 群：595990173

欢迎开发者加入官方 QQ 群，交流集成与开发实践。群内仅讨论开发相关议题。