# 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**: 0
- **Forks**: 1
- **Created**: 2026-07-01
- **Last Updated**: 2026-09-24

## 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.22-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>

---

- **下载发行版**: 不再公共下载链接，请前往官方群下载
- **项目定位**: 专为极客、开发者及刷机爱好者打造的“高颜值”一体化 Android 设备控制中心。
- **官方群 (QQ)**: `731971089`

## 🖼️ 核心功能总览 (Posters)

<div align="center">
  <table>
    <tr>
      <td width="50%"><img src="pic/ranran-toolkit-functional-poster.png" alt="然然玩机工具箱功能海报" /><br /><sub>功能海报</sub></td>
      <td width="50%"><img src="pic/ranran-boot-patch-feature-poster.png" alt="Boot 修补功能海报" /><br /><sub>Boot 修补海报</sub></td>
    </tr>
  </table>
</div>

---

## 🖼️ 界面预览 (Screenshots)

<div align="center">
  <table>
    <tr>
      <td width="33.3%"><img src="pic/overview.png" alt="仪表盘" /><br /><sub>仪表盘</sub></td>
      <td width="33.3%"><img src="pic/wire-adb.png" alt="无线调试" /><br /><sub>无线调试</sub></td>
      <td width="33.3%"><img src="pic/device-control.png" alt="设备控制" /><br /><sub>设备控制</sub></td>
    </tr>
    <tr>
      <td width="33.3%"><img src="pic/screen-control.png" alt="投屏控制" /><br /><sub>投屏控制</sub></td>
      <td width="33.3%"><img src="pic/rom-download.png" alt="ROM下载" /><br /><sub>ROM下载</sub></td>
      <td width="33.3%"><img src="pic/sys-prop.png" alt="系统属性" /><br /><sub>系统属性</sub></td>
    </tr>
    <tr>
      <td width="33.3%"><img src="pic/link-dumper.png" alt="镜像提取" /><br /><sub>镜像提取</sub></td>
      <td width="33.3%"><img src="pic/boot-patch.png" alt="Boot修补" /><br /><sub>Boot修补</sub></td>
      <td width="33.3%"><img src="pic/file-manager.png" alt="文件管理" /><br /><sub>文件管理</sub></td>
    </tr>
    <tr>
      <td width="33.3%"><img src="pic/apps.png" alt="应用管理" /><br /><sub>应用管理</sub></td>
      <td width="33.3%"><img src="pic/partition.png" alt="分区管理" /><br /><sub>分区管理</sub></td>
      <td width="33.3%"><img src="pic/custom-commands.png" alt="自定义指令" /><br /><sub>自定义指令</sub></td>
    </tr>
    <tr>
      <td width="33.3%"><img src="pic/downloader.png" alt="下载器" /><br /><sub>下载器</sub></td>
      <td width="33.3%"><img src="pic/github-apk.png" alt="github apk" /><br /><sub>github apk</sub></td>
      <td width="33.3%"><img src="pic/update.png" alt="检查更新" /><br /><sub>检查更新</sub></td>
    </tr>
  </table>
</div>

---

## 🚀 核心亮点 (Highlights)

- **极致轻量**: 基于 Tauri 2，剥离重型内核，安装包仅 10MB+，内存占用极低。
- **现代化 UI**: 采用毛玻璃拟态 (Glassmorphism) 设计，丝滑过渡动画，提供极致审美体验。
- **开箱即用**: 内置 ADB、Fastboot、Aria2c、Scrcpy 等核心工具，无需配置 Java、Python 或环境变量。
- **智能感知**: 具备设备心跳连接与模式自愈技术，自动适配系统、Recovery 及 Fastboot 模式。

## ✨ 核心功能 (Features)

- **📊 实时看板**: 监控 CPU、内存、存储及电池状态，深度扫描设备硬件与内核详情。
- **🔌 调试中心**: 支持 USB 与无线 ADB 连接。
- **🗑️ 应用超管**: 系统/用户应用分类检索，支持一键冻结、彻底禁网、APK 逆向提取。
- **🖥️ 投屏控制**: 基于 Scrcpy 提供毫秒级低延迟投屏，支持熄屏操作、高码率 DIY 渲染。
- **📥 下载枢纽**: Aria2 驱动的多线程下载，完美闭环机型 ROM 检索与下载。
- **💾 高阶工具**: 支持全区物理扫描、镜像一键提取、Payload 解码及 Boot 提取。
- **🔧 自定义指令**: 开放宏指令挂载，支持一键精简、自动化脚本执行。

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

- **Frontend**: Vue 3 (Composition API) + Pinia + Element Plus (Deep Custom)
- **Backend**: Tauri 2 (Rust Core) | IPC & RPC (Aria2c) 驱动
- **Logic**: 多态协议流管理，高等级并发调度管道。

## 📂 项目结构 (Structure)

```text
RanranToolkit/
├── bin/            # 核心二进制工具 (ADB, Fastboot, Aria2c)
├── tools/          # C++ 图形引擎辅助 (Scrcpy)
├── src-tauri/      # 客服端核心 (Rust) - 系统级权限与执行
└── src/            # 前端全景逻辑 (Vue 3)
    ├── api/        # 协议通讯层
    ├── views/      # 业务逻辑视图
    └── utils/      # 核心轮询与状态机
```

## 🚀 快速启动 (Getting Started)

- 先克隆主仓库，使用 `git clone https://gitee.com/xiaowan12/toolkit-tauri-app --recurse-submodules`，或在克隆后执行 `git submodule update --init --recursive`

```bash
# 1. 安装依赖
yarn install

# 2. 启动开发模式
yarn tauri dev

# 3. 开发环境手动生成 codename-model-map.json （可选）
yarn dev:generate-codename-model-map

# 4. 清理 Tauri/Rust 构建缓存
yarn clean:tauri

# 5. 编译发布版本 (MSI/EXE)
yarn build:all
```

## 🤝 协作共筑 (Contributing)

1. 坚守试图层与底层 Service 分离的设计原则。
2. 提交前请确保代码格式整洁，符合项目 Lint 规范。
3. 若新增 Rust 核心指令，务必在白名单中完成接驳登记。

## 📄 License

基于 [MIT License](https://opensource.org/license/mit) 开源。