YukiClient
YukiClient小杰宝ovo刷机
 登登录 立即下载
首页 / 使用教程

使用教程

按顺序看一遍，基本能避开刷机时最常见的那几个坑。

1. 准备工作

装 9008 驱动

手机连电脑并进入 9008 模式后，设备管理器里应出现 Qualcomm HS-USB QDLoader 9008 (COMx)。没有这一项就是驱动没装好，先装 Qualcomm USB Driver，装完重新插拔一次。

线材很重要。只能充电的劣质线会导致「能看到端口，但一读分区表就掉线」，换线往往立刻解决问题。

怎么进 9008

  • 关机后按住音量键组合再插 USB（不同机型组合不同，常见是音量上下同按）；
  • 系统还能开机时，用工具顶栏 高通功能 → MI 踢 9008，填 token 与签名文件直接下发 oem edl；
  • 已经处于 firehose 模式的机器，选串口后可以留空引导文件直接连接。

固件包放哪

官方包解压后一般是这样，选 XML 时指向 IMAGES 目录里的 rawprogram*.xml 即可：

固件包/
├─ IMAGES/
│  ├─ rawprogram0.xml … rawprogram5.xml
│  ├─ patch0.xml … patch5.xml
│  ├─ boot.img / super.img / system.img …
│  └─ prog_firehose_xxx.elf        ← 引导文件（可选）
└─ META/
   └─ super_def.10010111.json      ← 欧加包的动态分区定义
不要把整个压缩包直接选进去。先解压，确认 rawprogram*.xml 与各 .img 在同一层目录。

2. EDL 整包刷写

  1. 连接设备

    顶部「设备状态」下拉选串口，点连接。日志里出现 已连接串口 9008 模式 … 就通了。

  2. 读分区表

    先点「读取分区表」，同时会把字库厂商、容量、芯片平台读出来。这一步能确认设备通信正常，再往下走更稳。

  3. 选 XML

    「XML文件」右侧点浏览，选中 rawprogram*.xml，会自动把同目录的 patch*.xml 一起带上，摘要显示 rawprogram3.xml +5 · Patch patch1.xml 等 6 个补丁。

  4. 核对分区

    表里会列出全部条目。镜像缺失、擦除条目默认不勾选；GPT 还原也要手动勾才会写。确认「已选 x/y」的数字符合预期。

  5. 按需勾选项

    保数据（跳过 userdata）、自动重启（写完 reset）、生成 XML、保护分区、跳过发引导，按场景勾。

  6. 写入分区

    点「写入分区」开始。底部两条进度条分别是当前分区与总体进度，右侧显示实时速度；中途要停就点红色「停止」。

关于「擦除条目」：高通 rawprogram*.xml 里有大量没写 filename 的 <program>，它们表示「擦掉这个分区」。工具会照实列出来并标成「擦除」，但默认不勾——需要清空的分区请自己确认后再勾。

3. 单分区读写擦

  • 回读：勾选分区 → 点「回读分区」，先选保存目录，工具会在其中新建 YukiClient_回读镜像，产物为 <分区名>.img。
  • 擦除：勾选分区 → 点「擦除分区」，适合清 data / 清残留下锁数据。
  • 写入：点某一行「状态」格可以单独指定镜像，双击整行等于勾选/取消。
  • 读取版本号：不用刷写，只把机型、系统版本、指纹读出来。

4. Fastboot 刷写

设备进 fastboot 后，在「设备状态」切到 Fastboot 并连接。刷写动作与 EDL 一样，日志格式也一致，只是没有 LUN 概念，统一显示 [0]。

[01:03:24] [写入文件] [0] boot.img > boot... Done

5. super 动态分区（欧加机型）

选完 XML 后，如果检测到是动态分区包（有 META\super_def.*.json 但没有 super.img），会弹出「super 写入方式」：

  • 合并 super.img：用 lpmake 先在电脑上合成一整块再刷。适合想留一份可归档 super 镜像的情况，需要约一个 super 大小的临时空间。
  • 子分区刷入（免合并）：只用 super_def.json 现场重建 liblp 元数据，把各子镜像按 extent 直接写进 super 的对应偏移，不需要 lpmake。速度快、省空间。
  • 取消：保持自动判断，下次选包再问。
免合并会重写 super 元数据。设备上原有的逻辑分区布局会随之失效——这是整包刷写的预期行为，不是故障。写前所有校验（容量、对齐、重叠、模板一致性）不通过都会直接拒绝，不会硬写。

6. Payload 解包

  1. 选来源

    本地：选 payload.bin 或完整 OTA zip；云端：直接粘贴 http(s) 直链。

  2. 列分区

    云端只会用 HTTP Range 读 ZIP 中央目录与 payload 头，不会把整包拖下来，所以列得很快。

  3. 勾选并解包

    勾选需要的分区 → 「开始解包」。云端只下载选中分区的数据段；行内「解包」可以只解一个分区。

  4. 找产物

    默认输出到 桌面\YukiClient_Payload，可在「输出文件夹」里改。

链接不是直链会报错。网盘分享页、需要跳转的地址都拿不到 Range，工具会直接告诉你是「不是直链」还是「zip 里没有 payload」，而不是笼统说文件不存在。

7. 投屏与文件管理

Yuki 投屏

顶栏「基础功能 → Yuki 投屏」。自动读设备型号与序列号，默认 8 Mbps / 60 fps / 最大边 1024。「熄屏投屏」会额外加 --turn-screen-off，手机屏黑着，电脑照常操作。关对话框会结束投屏进程，不会留后台。

Yuki 文件管理

设备目录以图标网格展示：文件夹黄色、常见文件带扩展名角标。双击进目录，双击文件直接导出；右键能打开、导出、重命名、删除、新建文件夹。工具栏四个动作：刷新 / 导出到电脑 / 导入到手机 / 安装 APK。

8. 小米 ACC 一键解账号锁

入口：顶栏「高通功能 → 小米ACC一键解账号锁」。原理是把「查找设备 / 激活锁」依赖的两个名字处理掉：persist 里的 fdsd 整段清零，modem 里的 CARDAPP.* 隐藏。只做字节级改写，不重建文件系统，写完仍是合法的 ext4 / FAT16。

两种用法

  • 连机自动（需要 9008）：点最上面的蓝色大按钮，工具自己走完「检查连接 → 读分区表 → 回读 persist 与 modem（A/B 双槽）→ 本地改写 → 写回原分区」。几百 MB 来回读写，慢是正常的。
  • 本地镜像（不用连机）：从固件包里拿 persist.img 和 modem.img，「从固件目录识别」会自动挑出来；产物是 NEW_<原名>，之后单独刷回对应分区。
三个护栏：命中 0 处直接判失败，绝不产出和输入一模一样的副本；原镜像只读打开，输出永远是独立副本；处理前后各算一次 SHA256 打进日志。勾「仅预览」可以只分析不落盘，先确认命中几处再决定。

9. 常见问题

设备管理器里没有 9008 端口
先装 Qualcomm USB Driver；换数据线；换 USB 口（优先主板后置口，别用前置或 HUB）；确认手机确实进了 9008 而不是普通充电模式。
能连上，但读分区表就掉线
九成是线材或供电问题。换线、直插主机后置 USB 口重试。仍不行可换引导文件（prog_firehose_*.elf）再试一次。
写入到一半提示失败
先看日志里失败的是哪个分区、哪一步。常见原因：镜像与机型不匹配、分区大小对不上、包不完整。不要反复硬刷同一个包，先核对固件型号。
点了停止没反应 / 想中途放弃
「停止」在当前分区写完后生效，剩余分区不再开始。这是为了避免写到一半中断导致分区内容不一致。
杀毒软件报毒
单文件版是自解压结构，容易被误报。先核对 SHA256 与下载页一致；确认无误后加入白名单再运行。
首启动比较慢
第一次要把运行库解压到 D:\YukiClient\runtime，几秒到十几秒都正常。之后按载荷签名判重，没换版本就直接秒开。

10. 免责声明

本工具面向个人设备的维修、系统重装与学习研究。请勿用于破解他人设备、绕过厂商安全机制或任何违法用途。

刷机、解锁、改写分区均有变砖与数据丢失风险，操作前请自行备份。因使用本工具造成的设备损坏、数据丢失、保修失效等后果，由使用者自行承担。