PAGASUS-PRO

**步骤 2 — 安装 Python 3**```bash
sudo apt install python3 python3-pip -y

**步骤 4 — 安装 scrcpy** *(可选 — 用于屏幕镜像)*```bash
sudo apt install scrcpy -y

**步骤 6 — 克隆仓库**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> 想运行旧版本？
> ```bash
> python3 pegasusV-1.2.py   # 运行 v1.2
> python3 pegasus_v1.1.py   # 运行 v1.1
> ```

---

### 🔷 Linux — Arch / Manjaro / BlackArch

**步骤 1 — 更新系统**```bash
sudo pacman -Syu

**步骤 3 — 安装 scrcpy** *(可选)*```bash
sudo pacman -S scrcpy

**步骤 5 — 克隆仓库**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> 想运行旧版本？
> ```bash
> python3 pegasusV-1.2.py   # 运行 v1.2
> python3 pegasus_v1.1.py   # 运行 v1.1
> ```

---

### 🪟 Windows 10 / 11

**步骤 1 — 安装 Python 3**

1. 从以下地址下载：https://www.python.org/downloads/
2. 运行安装程序
3. ✅ 在点击 Install 之前**勾选 "Add Python to PATH"**

在命令提示符或 PowerShell 中验证：```cmd
python --version

> ADB 会自动添加到 PATH — 无需手动设置。

验证：```cmd
adb version

验证：```powershell
scrcpy --version

验证：```powershell
git --version

> ✅ 这将一次性安装 Python、ADB、scrcpy 和 Git。安装完成后请重启 PowerShell。

---

**第 6 步 — 克隆仓库**

打开 **命令提示符** 或 **PowerShell**：```powershell
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**步骤 8 — 运行 Pegasus v1.3**```powershell
python pegasus_v_1.3.py

**步骤 2 — 安装 Python 3**```bash
brew install python

**步骤 3 — 安装 ADB**```bash
brew install android-platform-tools

**步骤 4 — 安装 scrcpy** *(可选)*```bash
brew install scrcpy

**步骤 6 — 克隆仓库**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> 想运行旧版本？
> ```bash
> python3 pegasusV-1.2.py   # 运行 v1.2
> python3 pegasus_v1.1.py   # 运行 v1.1
> ```

---

### 📱 Termux（直接从你的 Android 手机运行）

> **什么是 Termux？** Termux 是一个 Android 终端模拟器，可在你的手机上提供完整的 Linux 环境——无需 root。你可以使用 Termux 直接从 Android 设备运行 Pegasus。

> ⚠️ **注意：** `scrcpy`（屏幕镜像——选项 5）在 Termux 中**无法使用**，因为它需要显示服务器，而 Android 上不可用。所有其他功能均可正常使用。

#### 安装 Termux

1. **从 F-Droid 安装 Termux** *（推荐）*  
   👉 https://f-droid.org/packages/com.termux/  
   > ⚠️ Google Play 商店版本的 Termux 已过时——请始终使用 F-Droid 版本。

2. 打开 Termux 并按照以下步骤操作：

**步骤 1 — 更新软件包**```bash
pkg update && pkg upgrade -y

**步骤 3 — 安装 Git**```bash
pkg install git -y

验证安装：```bash
adb version

**步骤 6 — 克隆仓库**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**步骤 8 — 运行 Pegasus v1.3**```bash
python pegasus_v_1.3.py

4. 拔掉 USB 数据线，然后找到目标设备的 IP：  
   → 设置 → Wi-Fi → 点击已连接的网络 → IP 地址
5. 运行 Pegasus 并选择 **`[2] Connect a Device`**
6. 输入 IP 地址 — 无线连接现已激活 ✅

**方法 2 — 管理同一设备（localhost）**

如果你想直接管理自己的手机：```bash
adb connect localhost:5555

### 切换到无线模式（Wi-Fi ADB）

> 需要一次性 USB 设置。之后即可完全无线操作。

1. 通过 USB 数据线连接设备
2. 启动 Pegasus → 选择 **`[2] Connect a Device`**
3. 当提示启用 TCP/IP 模式时，输入 `y`
4. 查找设备 IP：**设置 → Wi-Fi → 点击已连接的网络 → IP 地址**
5. 在 Pegasus 提示时输入该 IP
6. 拔掉 USB —— 连接现在已无线 ✅

---

## 🚀 使用方法```bash
# Linux / macOS — Latest Version
python3 pegasus_v_1.3.py

# Windows — Latest Version
python pegasus_v_1.3.py

# Run older versions
python3 pegasusV-1.2.py    # v1.2
python3 pegasus_v1.1.py    # v1.1

---

## 📂 输出文件

所有生成的文件都保存在运行脚本的**同一目录**中。

| 文件名 | 生成方式 |
|----------|-------------|
| `screen.png` | 截取屏幕截图 |
| `record.mp4` | 屏幕录制 |
| `apk_list.txt` | 显示 APK 列表 |
| `contacts.txt` | 导出联系人 |
| `device_log.txt` | 获取设备日志 |
| `storage_info.txt` | 检查存储 |
| `sms_logs.txt` | 导出短信（安全工具） |
| `call_logs.txt` | 导出通话记录（安全工具） |
| `connection_log.txt` | 自动生成的连接会话日志 |

---

## 📋 依赖项摘要

| 依赖项 | 是否必需 | 用途 | 安装（Linux/macOS） | 安装（Termux） |
|-----------|----------|---------|-----------------------|-----------------|
| Python 3.7+ | ✅ 是 | 运行工具 | `sudo apt install python3` | `pkg install python` |
| colorama | ✅ 是 | 彩色终端输出 | `pip3 install colorama` | `pip install colorama` |
| ADB | ✅ 是 | 设备通信 | `sudo apt install adb` | `pkg install android-tools` |
| scrcpy | ⚪ 可选 | 屏幕镜像功能 | `sudo apt install scrcpy` | ❌ Termux mein kaam nahi |
| nmap | ⚪ 可选 | 安全工具中的网络扫描 | `sudo apt install nmap` | `pkg install nmap` |
| Git | ⚪ 推荐 | 克隆仓库 | `sudo apt install git` | `pkg install git` |

> 💡 **快捷方式：** `pip install -r requirements.txt` se sab Python dependencies ek baar mein install ho jaati hain。

---

## 📁 文件参考

| 文件 | 版本 | 运行命令 |
|------|---------|-------------|
| `pegasus_v_1.3.py` | v1.3 *(最新)* | `python3 pegasus_v_1.3.py` |
| `pegasusV-1.2.py` | v1.2 | `python3 pegasusV-1.2.py` |
| `pegasus_v1.1.py` | v1.1 | `python3 pegasus_v1.1.py` |
| `requirements.txt` | — | `pip install -r requirements.txt` |

---

## 📝 更新日志

### v1.3 — 最新版本
- ✅ 新增**高级安全工具子菜单**（选项 22）— 10 项功能：
  - Root 检测（多方法）、APK 权限审计、完整安全审计
  - 可调试应用扫描器、交互式 Shell、网络安全检查
  - 短信/通话记录导出、安全日志过滤、漏洞扫描器、网络监控
- ✅ **设备连接历史**，带时间戳和会话时长（选项 23）
- ✅ **多设备支持** — 检测到多个设备时列出并选择
- ✅ **选择性无线断开** — 选择特定设备或断开全部
- ✅ **ADB 故障排除** — 终止/重启 ADB 服务器以修复卡住的连接（选项 21）
- ✅ **改进的联系人导出** — 干净的 `Name: Number` 格式解析
- ✅ **更简洁的 APK 列表** — 仅显示包名，无原始路径杂乱信息
- ✅ **人类可读的存储** — 使用 `df -h` 便于阅读
- ✅ **自动连接日志记录** — 启动和退出时写入会话日志

### v1.2 — `pegasusV-1.2.py`
- ✅ 扩展为完整的 20 选项主菜单
- ✅ 远程关机并重启设备
- ✅ APK 安装（侧载）和卸载
- ✅ 文件推送和拉取（双向传输）
- ✅ 通过 Android intent 发送短信
- ✅ 导出设备联系人
- ✅ Logcat 设备日志导出
- ✅ 切换设备 Wi-Fi 状态
- ✅ 存储信息检查
- ✅ 远程触发相机并拉取照片
- ✅ 添加 `re` 模块用于联系人解析

### v1.1 — `pegasus_v1.1.py`
- ✅ 检查设备信息（型号、Android 版本、电池）
- ✅ USB 和 Wi-Fi ADB 连接与断开
- ✅ 自定义时长的屏幕录制
- ✅ 通过 scrcpy 实时屏幕镜像
- ✅ 列出已安装的包并保存到文件
- ✅ 截取并拉取屏幕截图

### v1.0
- ✅ 初始版本 — 基础 ADB 封装
- ✅ 交互式终端菜单 UI
- ✅ 启动时依赖检查器
- ✅ 彩色编码终端输出

---

## 📜 许可证

本项目采用 **MIT 许可证** 授权。```
MIT License

Copyright (c) 2024 thakur2309

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.