# toolkit-tauri-app

**Repository Path**: xiaowan12/toolkit-tauri-app

## Basic Information

- **Project Name**: toolkit-tauri-app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2026-03-15
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 🔧 RanranToolkit (然然玩机工具箱)

> 基于 **Tauri 2 + Vue 3** 构建的现代化 Android 设备管理桌面工具箱，轻量、美观、极速。

[![Release](https://img.shields.io/badge/Release-1.0.4-blue)](#)
[![OS Support](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-green)](#)
[![Tech Stack](https://img.shields.io/badge/Stack-Tauri%202%20%2B%20Vue%203-orange)](#)
[![License](https://img.shields.io/badge/License-MIT-blue)](#)

</div>

---

- **下载发行版**: 请查看 [releases](releases) 目录

## 🖼️ 界面预览 (Screenshots)

<div align="center">
  <table>
    <tr>
      <td width="33.3%"><img src="pic/1.png" alt="设备概览" /><br /><sub>设备概览</sub></td>
      <td width="33.3%"><img src="pic/2.png" alt="投屏控制" /><br /><sub>投屏控制</sub></td>
      <td width="33.3%"><img src="pic/3.png" alt="应用管理" /><br /><sub>应用管理</sub></td>
    </tr>
    <tr>
      <td width="33.3%"><img src="pic/4.png" alt="分区管理" /><br /><sub>分区管理</sub></td>
      <td width="33.3%"><img src="pic/5.png" alt="ROM下载" /><br /><sub>ROM下载</sub></td>
      <td width="33.3%"><img src="pic/6.png" alt="ROM下载" /><br /><sub>ROM下载</sub></td>
    </tr>
    <tr>
      <td width="33.3%"><img src="pic/7.png" alt="解锁BL" /><br /><sub>解锁BL</sub></td>
      <td width="33.3%"><img src="pic/8.png" alt="下载器" /><br /><sub>下载器</sub></td>
      <td width="33.3%"><img src="pic/9.png" alt="系统设置" /><br /><sub>系统设置</sub></td>
    </tr>
    <tr>
      <td width="33.3%"><img src="pic/10.png" alt="关于我们" /><br /><sub>关于我们</sub></td>
      <td width="33.3%"><img src="pic/0.png" alt="更新版本" /><br /><sub>更新版本</sub></td>
    </tr>
  </table>
</div>

---

## 📖 关于本项目 (About)

**RanranToolkit** 是一款面向 Android 开发者、刷机爱好者及高级用户的桌面端一体化管理工具。

🚀 **为什么选择 RanranToolkit？**

- **原生性能**: 得益于 **Tauri 2** 的 Rust 核心驱动，安装包体积相比传统 Electron 应用减小约 90%。
- **极低占用**: 运行时内存消耗极低，即使在后台挂载也几乎不占用系统资源。
- **现代交互**: 采用 Vue 3 + Element Plus 构建，提供丝滑、响应式的操作体验。

---

## ✨ 核心功能 (Features)

### 📱 设备概览

- **基本信息面板**：自动读取设备名称、设备代号、序列号、连接状态。支持 **Fastboot 模式信息回退**，在 ADB 未授权或未连接时自动从 Fastboot 获取关键参数。
- **系统与硬件详情**：品牌、Android 版本、CPU 架构与代号、硬件平台、主板 ID、分辨率、显示密度、BL 解锁状态、AB 分区槽、VNDK 版本、内核/构建信息等 15+ 项参数。
- **实时资源监控**：以圆环图可视化展示 **存储、内存使用率** 及当前占用量，以及 **电池电量与温度**。
- **应用状态统计**：汇总已安装系统应用与用户应用数量。
- **重启控制面板**：一键执行「重启手机 / 进入 Fastboot / 进入 Recovery / 彻底关机」，支持从 ADB 或 Fastboot 模式发起。
- **设备连接感知**：自动监听设备热插拔，实时刷新所有面板数据。

### 📥 下载管理器 (Downloader)

- **高性能引擎**：内置 **aria2c** 驱动，支持 HTTP/HTTPS 协议的高速下载。
- **多线程加速**：支持自定义下载线程（1-32 线程），显著提升大文件（如 ROM 包）的下载速度。
- **实时进度监控**：精确解析下载进度、实时速率、已下载大小、总大小及预计剩余时间 (ETA)。
- **任务管理**：支持任务重试、取消及移除。取消任务时自动清理磁盘残留文件（含 `.aria2` 控制文件）。
- **无缝集成**：与 ROM 下载模块深度联动，支持一键将 ROM 包添加到下载器。
- **后台优化**：Windows 环境下静默运行，无需外部黑窗口干扰；支持应用退出时自动清理未完成任务的磁盘占用。

### 🖥️ 屏幕控制 (基于 scrcpy)

- **一键投屏**：基于 scrcpy 驱动，支持键鼠反向控制设备。
- **画质调节**：多档位分辨率 (Auto/480p/720p/1080p)、帧率 (30/60/120 FPS) 及码率 (2-16 Mbps) 自定义。
- **高级模式**：支持熄屏投屏、保持唤醒、只读模式、显示触摸轨迹、窗口置顶等。
- **便捷交互**：投屏窗口内集成了电源、返回、主页、多任务等常用物理按键模拟。

### 📦 应用管理

- **多维列表**：支持切换用户/系统应用，支持包名/应用名/UID 搜索，支持按运行状态/冻结状态过滤。
- **APK 操作**：支持本地 APK 安装、应用强等、清除数据、卸载及 **APK 提取**（自动命名保存）。
- **状态控制**：一键执行 `pm disable/enable` 以实现应用冻结与解冻，UI 实时同步更新。

### 💾 分区管理

- **双模式扫描**：支持在 ADB (Root) 或 Fastboot/FastbootD 模式下扫描完整分区表。
- **镜像提取**：支持将分区 `dd` 提取至手机并自动 `pull` 到本机（需 Root 权限）。
- **镜像刷入**：支持在 Fastboot 模式下刷入 `.img/.bin` 镜像，支持分区格式化 (Erase)。
- **操作日志**：集成彩色实时日志面板，详细记录 ADB/FB 指令执行过程。

### 🌐 ROM 下载

- **三级导航**：品牌 → 机型 → 版本。
- **版本识别**：自动标注 Android 版本（15/14/13）及刷机包类型（卡刷包/线刷包/底包）。
- **双向下载**：支持调用系统浏览器下载，或一键 **添加到内置下载器** 实现多线程高速下载。

### 🔓 解锁 BL (Bootloader)

> ⚠️ 高风险操作，仅支持 **小米骁龙 8 Elite Gen 5 (Mi 17 系列等)**。

- **11 步全自动流程**：涵盖 SELinux 注入、efisp 写入、解锁验证、清空收尾等完整 BAT 对齐流程。
- **多状态识别**：实时监测 ADB/Fastboot/FastbootD 模式切换，自动处理设备重启等待逻辑。

---

## ⚙️ 技术架构 (Tech Stack)

### 🎨 前端 (Frontend)

- **Framework**: `Vue 3` (Composition API)
- **UI Components**: `Element Plus`
- **Utility**: `Axios`, `Day.js`, `Vue Router`

### 🦀 后端 (Backend - Rust Core)

- **Framework**: `Tauri v2`
- **Modules**:
  - `adb`: ADB/Fastboot 高级进程封装。
  - `downloader`: 基于 aria2c 的异步下载管理核心。
  - `commands`: 前后端桥接指令集。

---

## 📂 目录结构 (Project Structure)

```text
RanranToolkit/
├── bin/                        # 📦 内置工具 (ADB, Fastboot, aria2c)
├── src/                        # 🎨 前端源码
│   ├── views/
│   │   ├── downloader/         # 下载管理器界面
│   │   ├── rom-download/       # ROM 下载界面
│   │   └── ...                 # 其他功能模块
│   └── ...
├── src-tauri/                  # 🦀 Rust 后端
│   ├── src/
│   │   ├── commands/
│   │   │   ├── downloader.rs   # 下载指令逻辑
│   │   │   └── ...
│   │   └── ...
└── ...
```

---

## 🚀 快速开始 (Getting Started)

### 环境依赖

- **Node.js**: >= 18.0.0
- **Package Manager**: [Yarn](https://yarnpkg.com/)
- **Rust**: [rustup](https://rustup.rs/) (Stable)

### 本地开发

```bash
yarn install
yarn tauri dev
```

---

## 🗺️ 项目路线图 (Roadmap)

- [x] 设备信息自动识别与资源实时监控 (含 Fastboot 回退)
- [x] 基于 aria2c 的多线程下载管理器
- [x] ROM 下载与内置下载器的联动集成
- [x] 集成低延迟投屏 (scrcpy)
- [x] 应用管理：安装、冻结、提取、卸载
- [x] 自动 11 步解锁 BL (针对小米 8E5 机型)
- [ ] 多设备在线同时管理支持
- [ ] 自动化刷机脚本插件系统
- [ ] Fastboot 驱动一键修复工具
      🦀 后端 (Backend - Rust Core)

- **Framework**: `Tauri v2`
- **Core Modules**:
  - `adb`: 高性能 ADB/Fastboot 进程封装。
  - `commands`: 安全的 Backend-to-Frontend 通信网关。
  - `models`: 统一数据结构定义。
  - `utils`: 通用工具函数层。

### 📦 内置工具

- **scrcpy**: 低延迟 Android 屏幕镜像与控制。
- **ADB / Fastboot**: Android 调试桥，随应用内置，无需额外安装。

---

## 📂 目录结构 (Project Structure)

```text
RanranToolkit/
├── pic/                        # 🖼️ 项目预览截图
├── bin/                        # 📦 内置工具 (ADB / Fastboot)
├── tools/                      # 🔧 辅助资源 (scrcpy 等)
├── src/                        # 🎨 前端 Vue 源码层
│   ├── api/                    # 接口封装层 (device / scrcpy)
│   ├── components/             # 公共 UI 组件
│   │   ├── common/             # SmartIcon、CircleProgress 等通用组件
│   │   ├── layout/             # 侧边栏、顶栏等布局组件
│   │   └── about/              # 关于页专属组件 (SponsorDialog)
│   ├── config/                 # 静态配置 (ROM 数据源等)
│   ├── views/                  # 功能页面
│   │   ├── overview/           # 设备概览
│   │   ├── screen-control/     # 屏幕控制
│   │   ├── apps/               # 应用管理
│   │   ├── partition/          # 分区管理
│   │   ├── rom-download/       # ROM 下载
│   │   ├── unlock-bl/          # 解锁 BL
│   │   ├── settings/           # 系统设置
│   │   └── about/              # 关于
│   ├── router/                 # 路由规则定义
│   ├── utils/                  # 工具函数库 (deviceStore 等)
│   └── App.vue                 # 根组件
├── src-tauri/                  # 🦀 Rust 核心逻辑层
│   ├── src/
│   │   ├── commands/           # 系统指令处理逻辑
│   │   ├── adb/                # ADB 核心封装
│   │   ├── models/             # 数据结构定义
│   │   ├── utils/              # 工具函数
│   │   └── lib.rs              # Tauri 入口配置文件
│   └── tauri.conf.json         # Tauri 核心配置
└── package.json                # 项目元数据与依赖管理
```

---

## 🚀 快速开始 (Getting Started)

### 环境依赖

- **Node.js**: >= 18.0.0
- **Package Manager**: [Yarn](https://yarnpkg.com/)
- **Rust**: [rustup](https://rustup.rs/) (Stable 渠道)
- **Windows 用户**: 需安装 [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) 及 WebView2 运行时。

### 本地开发

```bash
# 1. 克隆项目
git clone https://gitee.com/xiaowan12/toolkit-tauri-app
cd RanranToolkit

# 2. 安装依赖
yarn install

# 3. 启动开发模式
yarn tauri dev
```

### 构建发布版本

```bash
cls && cd src-tauri && cargo clean && cd .. && yarn tauri build
```

生成的安装包将位于 `\toolkit-tauri-app\src-tauri\target\release\bundle\msi`。

---

## 🗺️ 项目路线图 (Roadmap)

- [x] 设备信息自动识别与资源实时监控
- [x] 分区表读取、镜像提取/刷入/格式化及实时日志
- [x] 集成低延迟投屏 (scrcpy 驱动) 及多参数配置
- [x] 应用管理：安装、冻结/解冻、提取 APK、强停、清数据、卸载
- [x] ROM 下载三级导航（品牌 → 机型 → 版本）
- [x] 解锁 BL 全自动 11 步引导流程（小米骁龙8 Elite Gen5）
- [x] 设备重启控制（系统 / Fastboot / Recovery / 关机）
- [ ] 优化 Fastboot 驱动自动安装引导
- [ ] 增加多设备同时管理支持
- [ ] 插件系统：允许用户编写自定义 Shell 脚本工具

---

## 🤝 参与贡献 (Contributing)

我们非常欢迎开发者参与贡献！

1. 请确保遵循 UI 与 Service 分离的设计模式。
2. 提交代码前请进行格式化。
3. 如果涉及到系统命令修改，请同步更新 `src-tauri` 中的权限配置。

---

## 💬 社区与支持

- **QQ 官方频道**: 731971089
- **开源地址**: [Gitee · xiaowan12/toolkit-tauri-app](https://gitee.com/xiaowan12/toolkit-tauri-app)

---

## 📄 开源协议 (License)

本项目基于 [MIT License](LICENSE) 开源。

---

<div align="center">
Made with ❤️ by Ranran Community
</div>