weixin-xlog-analyzer

# 微信Xlog分析工具 ## 任务目标 - 本Skill用于:分析微信Xlog调试日志文件，提取关键信息并辅助问题诊断 - 能力包含:日志解析、错误提取、统计分析、问题诊断报告生成 - 触发条件:用户需要分析微信日志、排查故障、统计日志数据或定位问题时 ## 前置准备 - Xlog文件准备:用户需提供微信Xlog文件（如已加密，需先使用外部工具解密） - 外部解密工具:如需解密Xlog，用户需自行准备QXLog等解密工具（本Skill不包含解密功能） - 依赖说明:scripts脚本仅使用Python标准库，无需额外安装依赖包 ## 操作步骤 - 标准流程: 1. 准备阶段 - 确认Xlog文件路径（相对路径或绝对路径） - 如文件为加密格式，使用外部工具解密得到明文日志 2. 日志解析 - 调用 `scripts/xlog_parser.py <log_file_path>` 解析日志文件 - 脚本会返回结构化的日志数据（JSON格式） 3. 统计分析 - 调用 `scripts/log_analyzer.py <parsed_data_file>` 进行统计分析 - 脚本会返回统计结果（各级别日志数量、错误信息、模块分布等） 4. 问题诊断 - 根据统计结果和日志内容，智能体分析问题模式 - 参考 `references/analysis_guide.md` 中的分析要点 - 生成诊断报告和改进建议 - 可选分支: - 当仅需提取错误信息:在步骤2后，使用正则表达式过滤ERROR级别日志 - 当仅需统计特定模块:在步骤3中指定模块名称进行过滤统计 ## 资源索引 - 必要脚本: - [scripts/xlog_parser.py](scripts/xlog_parser.py):解析日志文件，提取时间戳、级别、模块、消息等结构化数据 - [scripts/log_analyzer.py](scripts/log_analyzer.py):统计分析日志数据，生成统计报告 - 领域参考: - [references/xlog_format.md](references/xlog_format.md):Xlog文件格式说明和常见日志模式 - [references/analysis_guide.md](references/analysis_guide.md):日志分析方法论和诊断要点 ## 注意事项 - Xlog文件可能为加密格式，解密需要外部工具支持 - 日志解析依赖特定的格式模式，如遇格式变化可能需要调整正则表达式 - 统计分析基于日志级别和模块标签，确保日志输出包含这些信息 - 大文件处理时注意内存使用，建议分批处理 ## 使用示例 ### 示例1:基本日志分析 ```bash # 解析日志文件 python scripts/xlog_parser.py ./input/xlog.txt -o ./parsed_data.json # 统计分析 python scripts/log_analyzer.py ./parsed_data.json -o ./analysis_result.json ``` ### 示例2:仅提取错误信息 ```bash # 解析日志文件并过滤ERROR级别 python scripts/xlog_parser.py ./input/xlog.txt --level ERROR -o ./errors.json ``` ### 示例3:特定模块分析 ```bash # 统计特定模块的日志 python scripts/log_analyzer.py ./parsed_data.json --module Network -o ./network_analysis.json ```