xlog-decoder 0.1.2

Command-line decoder for Tencent Mars xlog files, log directories, and Feedback diagnostic ZIP archives.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

# xlog-decoder

High-performance, pure-Rust command-line decoder for Tencent Mars `xlog` files, batch log directories, and Feedback diagnostic ZIP archives.

Provides both `xlog-decoder` and `mars-xlog` binary aliases for full drop-in compatibility.

## Installation

```bash
cargo install xlog-decoder
```

Or run via `cargo`:

```bash
cargo run -p xlog-decoder -- <args>
```

## Features

- **Single file decoding**: Decrypt and unpack Tencent Mars `.xlog` files to `.log`.
- **Directory batch processing**: Recursively traverse folder trees, decode all `.xlog` files while mirroring directory structure.
- **Feedback ZIP unpacking**: Automatically extract feedback diagnostic `.zip` packages, decode all nested `.xlog` files, and clean up extraction artifacts.
- **ECDH Cryptography**: Support ECDH secp256k1 private keys via CLI flags (`-k`, `-p`, `--key`) or environment variable (`MARS_XLOG_KEY`).
- **Flexible CLI ergonomics**: Direct file arguments without subcommands (`xlog-decoder input.xlog output.log`) as well as explicit flags (`-i`, `-o`).
- **Key pair generator**: Built-in `gen-key` subcommand to generate compatible ECDH public/private key pairs.

## Usage Examples

### 1. Direct Single-File Decoding

```bash
# Decrypt encrypted xlog file
xlog-decoder app.xlog app.log -k <64_HEX_PRIVATE_KEY>

# Plaintext non-encrypted xlog file
xlog-decoder app.xlog app.log
```

You can also use flag syntax or the `mars-xlog` alias:

```bash
mars-xlog -i app.xlog -o app.log -k <64_HEX_PRIVATE_KEY>
```

### 2. Batch Directory Processing

Recursively decode all `.xlog` files in a folder into a target directory:

```bash
xlog-decoder logs/ decoded_logs/ -k <64_HEX_PRIVATE_KEY>
```

### 3. Feedback ZIP Archive Extraction & Decoding

Automatically unpack user diagnostic ZIP files and decode all internal `.xlog` files:

```bash
xlog-decoder feedback_dump.zip decoded_feedback/ -k <64_HEX_PRIVATE_KEY>
```

### 4. Key Pair Generation

Generate a secp256k1 public/private key pair suitable for Tencent Mars log encryption:

```bash
xlog-decoder gen-key
```

Outputs:
```text
Public key (hex): 04...
Private key (hex): ...
```

## License

MIT