⌁
Qualcomm EDL 9008
自研 C++ Sahara + Firehose 会话，覆盖引导发送、协议复用、configure、GPT、program、read、erase、patch、power，以及 WinUSB/高通串口双传输。
Windows 3.0 · Native Core
把复杂刷写，变成可控工程。
MaChao 是面向维修人员与 Android 发烧友的设备工程工作台。C++ 原生核心负责协议、传输与镜像，桌面端统一设备状态、分区计划、进度和日志，云端只下发需要持续更新的资源。
Windows 10/11 x64 · C++17 Core · WinForms · Java Resource Service
Qualcomm SM8350 · UFS● Firehose ready
PARTITIONLUNSIZEACTION
✓ boot_a1192 MBprogram
✓ super08.0 GBprogram
persist032 MBprotected
modemst104 MBbackup
userdata096 GBskipped
super.img · chunk 1462/204846.0 MB/s
执行日志
Sahara HELLO received
loader accepted
Firehose configure OK
storage: UFS · LUN 0
protect: persist / nvdata
program super · 72%
C++17协议与镜像原生核心
EDL 9008Sahara / Firehose
46 MB/s*USB 2.0 真机调优记录
GPT aware分区范围与容量校验
Cloud-first资源按需下载与校验
FULL TOOLCHAIN
从连接设备到刷写完成，留在同一套工作流
不是简单拼接命令行工具。设备状态、驱动、镜像、分区、下载、授权和失败定位都由统一界面编排。
⇄
Fastboot / FastbootD
使用 Google 官方驱动，支持设备探测、单分区写入、通用全量线刷、A/B 槽位、动态分区、COW 清理、系统与 FastbootD 自动切换。
▦
GPT 分区工作台
读取 GPT 与 rawprogram/patch，支持指定分区回读、写入、擦除、备份和修复；写入前核对 LUN、扇区范围与镜像尺寸。
◆
Payload / Super / Sparse
处理 Payload、ZIP64、Sparse、Dynamic Super、LP metadata、EXT4 与 EROFS，覆盖拆分、检查、合并和固定布局重打包。
✓
AVB 与签名分析
解析 vbmeta、descriptor、rollback、flags 与链式公钥；提供联想 AOSP 四镜像签名链和厂商包结构的只读检查。
▣
云端引导与依赖
驱动、Loader、Root 工具和厂商 profile 按需下载，执行 SHA-256 校验并缓存，减小客户端本体。
◫
日常设备维护
集成投屏、文件传输、应用管理、备份、断点续传、boot/init_boot 修补与常用 ADB 操作。
≡
可读的执行日志
右侧日志展示协议阶段、设备信息、传输方式、Loader profile、速度、失败位置与重试结果，不把刷写过程做成黑盒。
QUALCOMM PIPELINE
一次连接，完整看见协议阶段
自动识别设备当前处于 Sahara 还是 Firehose。已加载引导时直接复用，避免重复发送和无意义重连。
USB / COM→Sahara→Loader→Firehose→GPT
WinUSB自研 EDL 传输
COMQualcomm 串口兼容
1 MiB可协商载荷档位
OPERATION GUARD
写入之前先把风险说清楚
高风险操作必须落到明确的设备状态、目标分区和用户确认上。
01
驱动完整替换先释放会话并清理旧绑定，再安装 WinUSB 或高通串口驱动。
02
关键分区默认保护基带、指纹、GPT 与用户数据不会因为全选而被盲目覆盖。
03
镜像和范围检查写入前验证文件存在、大小、LUN、起始扇区与分区容量。
PROTOCOL MATRIX
当前能力边界，公开写清楚
稳定功能、预览功能和未开放写入不会混在一起宣传。不同设备仍取决于 Bootloader、Loader 和厂商授权策略。
| 模块 | 设备识别 | 读取 | 写入 | 驱动/传输 | 当前状态 |
|---|---|---|---|---|---|
| ADB / Recovery / Sideload | 支持 | 设备与系统信息 | 按具体操作 | Android ADB | 稳定 |
| Fastboot / FastbootD | 支持 | 变量与分区 | 单分区 / 全量 | Google USB | 稳定 |
| Qualcomm EDL | Sahara / Firehose | GPT / 分区 / 信息 | program / erase / patch | WinUSB / Qualcomm COM | 真机验证 |
| Payload / Super | 格式识别 | 解析 / 解包 | 合并 / 重打包 | 本地文件核心 | 稳定 |
| MTK 深刷 | BROM 探测 | Scatter / 计划 / eMMC GPT 研发 | 暂不开放 | Rust 研发核心 | 研发预览 |
* USB 速度为特定魅族 18、Loader 与主机环境下的调优记录，不承诺所有设备达到相同速度。
IMAGE ENGINE
镜像不是“能解压”就算完成
核心关注格式边界、元数据、空间范围与可恢复性，避免半成品污染输出目录。
payload.binManifest / 分区流解析解包sparse.imgChunk 校验与 RAW 转换检查super.imgLP metadata / extent / group拆包重组vbmeta.imgAVB descriptor / key / rollback签名分析ext4 / erofs文件系统与版本属性采样只读ARCHITECTURE
三层分工，不把秘密塞进客户端
稳定协议落入本地核心，持续变化的资源交给云端，界面只负责编排与确认。
C++
ToolboxCore.dllEDL、Fastboot 编排、镜像与文件系统处理。
UI
ToolboxUI.exe页面状态、任务进度、日志、确认与 C ABI。
API
Java Resource Service账号、版本、Loader 索引、品牌资源与动态 profile。
资源哈希校验
文件原子提交
私钥不进客户端
凭据不写日志
ACCOUNT & CLOUD
工具属于账号，但不绑定某一台手机
受信任设备、版本策略和个人品牌资源由服务端统一管理；刷机目标设备不作为客户端授权锁。
网页与 QQ 辅助授权
保留网页授权流程，同时支持绑定 QQ 后由机器人通知授权码和登录来源。未受信任登录按服务端策略限制权限。
壁纸与用户收款码
用户在网页上传自己的工作台壁纸和收款码；登录任意受信任电脑后由客户端按账号读取并展示。
强制版本与依赖目录
客户端启动时验证版本，依赖采用清单、哈希和缓存机制，过期组件可以单独替换，无需把运行时全部塞进本体。
隐私与安全：日志中的公网 IP 应按策略脱敏；受信任设备使用可读浏览器名称和登录地区展示；管理员权限与普通账号能力分离。
CURRENT RELEASE
MaChao Toolbox 3.0
- 小体积框架依赖式单 EXE，运行组件按需准备。
- EDL 页面状态常驻，切换页面不再销毁连接与日志。
- 取消跑马灯与页面空帧，刷写过程保持稳定重绘。
- Fastboot 使用 Google 官方驱动；WinUSB 专用于 Qualcomm EDL。
- 右侧竖直日志、宽分区表、账号壁纸与用户收款码。
Qualcomm EDL ACTIVE继续做真机兼容、Loader profile 和可恢复性优化。
Fastboot / 镜像工具 ACTIVE稳定通用线刷、Payload、Super、AVB 与厂商格式。
MTK Rust Core PAUSED PREVIEW页面和研究核心保留，等待合适真机与 DA 后继续验证。
Cloud Resources ACTIVELoader、依赖、版本与品牌资源持续服务端化。
FAQ
使用前常见问题
工具会绑定正在刷写的手机吗？
不会。账号授权的是客户端使用权限，不把某一台 Android 设备绑定为唯一目标设备。
为什么 Fastboot 不使用自研 WinUSB？
Fastboot 统一使用 Google 官方 USB 驱动；自研 WinUSB 只服务 Qualcomm EDL，减少驱动抢占和兼容问题。
为什么有些 EDL 设备仍然不能直接刷？
Firehose Loader、Secure Boot、厂商签名和在线授权会因机型不同而变化。工具会报告失败阶段，但不能把不匹配的 Loader 伪装成成功。
MTK 页面现在能正式刷写吗？
不能。当前作为 VIP 研发预览保留，主要用于 Scatter、安全计划与早期只读链路；写入需要更多真机资格验证。
小体积版本为什么首次启动仍会准备环境？
客户端没有把完整运行时和所有依赖静态塞入单文件，首次运行会按清单下载并校验必要组件，以控制本体体积。
官网和账号后台为什么是两个域名？
kelemachao.cn 负责产品介绍；旧域名继续承载账号、授权、下载和用户资源，避免迁移期影响现有服务。
READY FOR DEVICE
让下一次救砖，不再靠猜。
连接设备、识别协议、核对分区、准备资源、执行并记录。每个关键步骤都应该可见、可确认、可回溯。