MaaLogAnalyzer
August 30, 2026 · View on GitHub
MaaLogAnalyzer
✨ 可视化分析基于 MaaFramework 开发应用的用户日志 ✨
🔍 告别手翻百万行日志！用可视化+搜索的方式，高效定位、分析你的 Maa 应用运行问题 🔍
核心功能
| 模块 | 说明 |
|---|---|
| 日志分析 | 按任务展示执行过程 支持识别/动作详情查看 支持节点导航快速定位 支持虚拟滚动 支持布局比例保存 |
| 文本搜索 | 支持关键字/正则搜索 支持搜索历史与快捷检索 支持大文件流式搜索 支持结果跳转上下文 支持布局比例保存 |
| 流程图 | 基于 ELK 的节点关系可视化 支持执行顺序导航与回放 支持回放速度与聚焦缩放持久化 点击节点可高亮关联节点与连线 |
| 运行统计 | 展示节点、识别/动作、Wait Freezes 的成功/失败、耗时与重试统计 适合做整体运行质量观察 |
| 分屏模式 | 上半区日志分析 + 下半区文本搜索 便于结构与原文对照排查 支持布局比例保存 |
| 新手教程 | 首次加载样例数据后自动引导 按板块讲解主要功能 支持按教程版本增量引导 可在“关于 -> 快速开始”再次启动 |
支持的输入
- 单文件：
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/ # 文档
├─ packages/ # 可复用内核/运行时/工具包
├─ sample/ # 示例日志
├─ public/ # 静态资源
└─ README.md
包结构（Workspace）
仓库内已按职责拆分为五个可复用包，位于 packages：
- packages/maa-log-kernel：协议与契约层（schema/types/output builder）
- packages/maa-log-runtime：通用运行时编排（adapter 驱动）
- packages/maa-log-tools：Node 输入适配与 CLI
- packages/maa-log-parser：解析器包壳（稳定导出 LogParser）
- packages/maa-log-adapter：本仓实现绑定层（连接现有 parser/statistics）
常用包级命令：
pnpm typecheck:packages
pnpm build:packages
pnpm kernel:cli <path> --pretty --no-events
更多文档
- 解析器架构说明：
packages/maa-log-parser/README.md - 新手教程协议文档：
docs/TUTORIAL_PROTOCOL.md - VSCode 插件说明：
src-vscode/README.md
许可证
MIT License
致谢
- MaaFramework - 自动化框架
- maa-support-extension - 界面设计导师
- M9A - 最佳实践
开发者
感谢以下开发者对 MaaLogAnalyzer 作出的贡献：
沟通交流
MaaFramework 开发交流 QQ 群：595990173
欢迎开发者加入官方 QQ 群，交流集成与开发实践。群内仅讨论开发相关议题。