- name
- weixin-xlog-analyzer
- description
- 解析和分析微信Xlog日志文件，提取关键信息并生成诊断报告；当用户需要分析微信日志、排查故障或统计日志数据时使用
微信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/log_analyzer.py:统计分析日志数据，生成统计报告
- 领域参考:
- references/xlog_format.md:Xlog文件格式说明和常见日志模式 - references/analysis_guide.md:日志分析方法论和诊断要点
注意事项
- Xlog文件可能为加密格式，解密需要外部工具支持
- 日志解析依赖特定的格式模式，如遇格式变化可能需要调整正则表达式
- 统计分析基于日志级别和模块标签，确保日志输出包含这些信息
- 大文件处理时注意内存使用，建议分批处理
使用示例
示例1:基本日志分析
# 解析日志文件
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:仅提取错误信息
# 解析日志文件并过滤ERROR级别
python scripts/xlog_parser.py ./input/xlog.txt --level ERROR -o ./errors.json示例3:特定模块分析
# 统计特定模块的日志
python scripts/log_analyzer.py ./parsed_data.json --module Network -o ./network_analysis.json