# 工具使用说明

## decode_mars_crypt_log_file.py

### 环境安装

Python>=2.7.10

#### 安装pyelliptic

```shell
pip install pyelliptic==1.5.7
```

#### 安装openssl

```shell
conda install openssl=1.0.2u
```

### 解密xlog

```shell
python decode_mars_crypt_lo[debug.keystore](..%2Fkeystore%2Fdebug%2Fdebug.keystore)g_file.py com.adealink.weparty_20210520.xlog
```

## adb logcat查看日志

### 前置条件准备

* 根据pc系统类型下载相应adb安装包安装
* 手机通过usb连接到pc
* `adb devices`命令查看是否手机已连接

### 查看特定tag日志

```shell
//查看tag_http日志
adb logcat -s tag_http:D
```

### 查看特定应用日志

```shell
//获取应用pid，下面命令输出第二个数字即为pid
adb shell ps | grep 'com.wenext.lama'
//查看应用日志
adb logcat --pid=12298
//查看应用特定msg日志，下面为http日志
adb logcat --pid=12298 | grep 'tag_http'
```

## decode-ui-all.jar
```shell
java -Dfile.encoding=utf-8 -jar decode-ui-all.jar
```

## 日志分析工具

### generate_log_report_html.py - HTML可视化报告生成
#### 使用方法

```shell
# 基本使用（推荐）- 自动生成报告文件名
python3 generate_log_report_html.py com.partyjoy.yoki_20250922.xlog.log
# 输出: com.partyjoy.yoki_20250922_report.html

# 指定输出文件名
python3 generate_log_report_html.py logcat.txt --output my_report.html

# 批量处理多个日志文件
for log in *.xlog.log; do
    python3 generate_log_report_html.py "$log"
done
```

#### 详细文档
- [快速开始](QUICK_START.md) - 日志分析快速入门指南

### analyze_log_tags.py - 命令行分析工具

命令行版本的日志TAG分析工具，适合快速查看统计数据。

```shell
# 基本分析
python3 analyze_log_tags.py logcat.txt

# 显示TOP 30 TAG
python3 analyze_log_tags.py logcat.txt --top 30

# 显示超长日志示例
python3 analyze_log_tags.py logcat.txt --show-long-logs 10

# 导出CSV报告
python3 analyze_log_tags.py logcat.txt --export report.csv
```