项目介绍

《搞机工具箱》Web 版把 PC 端的 ADB 图形工具移植到浏览器。它借助 Tango / ya-webadb 通过 WebUSB 连接 Android 设备，并用 xterm.js 提供交互式 Android Shell，因此支持 Chrome 内核的浏览器无需安装桌面程序即可使用大部分 PC 版功能 README lines 3-12。

界面覆盖设备与系统信息、重启至 Bootloader / Fastbootd / Recovery / EDL、软件管理（启用/禁用、强行停止、卸载与保留数据卸载、清除数据、恢复系统软件、Google 套件批量管理）、APK 与拆分 APK 安装、文件推送和安装包提取、分辨率与 DPI 控制、状态栏与快捷设置修改、电池信息与模拟及 CSV 导出、字体与动画倍率、BAT 子集脚本和 ADB 终端 README lines 13-29。适合已经了解 ADB、愿意对设备做系统级操作的玩机用户。

快速使用

准备条件：使用支持 WebUSB 的 Chrome 或 Edge，手机开启开发者选项和 USB 调试，使用支持数据传输的 USB 线连接电脑，通过 localhost / 127.0.0.1 或 HTTPS 网站访问，并确保 Windows 能正常识别手机的 ADB USB 接口 README lines 32-39。

使用整合版时，下载 docs/index.html 后用 Chrome 内核浏览器直接打开 README lines 44-46。使用分离版时：

1. 下载并解压完整项目，保留目录结构。

2. 安装 Node.js，在包含 server.cjs 的目录打开终端。

3. 启动本地服务：

   node server.cjs
   

4. 用 Chrome 或 Edge 打开 http://127.0.0.1:8124 README lines 47-71。

5. 点击“连接设备”，在浏览器中选择手机，并在手机上确认 USB 调试授权。

如果 8124 端口被占用，可先修改端口再启动：

$env:PORT = "8080"
node server.cjs

随后打开 http://127.0.0.1:8080 README lines 63-66。按 Ctrl+C 停止服务，服务只监听本机地址。分离版必须通过网页服务器打开，直接双击 index.html 使用 file:// 地址可能导致 ES 模块加载失败 README lines 47-71。

使用约束

• 当前只提供 USB 有线连接。功能是否生效取决于 Android 版本、ROM 和 ADB Shell 权限，免 ROOT 不代表能绕过系统权限限制；进入 Fastboot 的按钮只发送重启命令，不提供分区刷写 README lines 13-29。
• 控机脚本在 JavaScript 中解释 BAT 语法子集，把 ADB 操作转换为浏览器调用，不会启动 cmd.exe 或执行电脑上的 EXE。支持 echo、rem、set、标签与 goto、部分 if 条件、for /l、timeout、choice /t、pause、exit /b 等；adb push 和 adb install 需要先在页面中关联文件 README lines 124-143。
• 设置、脚本文本和软件操作记录保存在当前网站的浏览器本地存储中，清理网站数据会删除。ADB 身份密钥由 Tango 保存在 IndexedDB，可在设置中清除。截图和电池统计为临时数据，应在刷新前下载保存 README lines 144-154。
• USB 会话依附于当前页面，关闭或刷新页面会断开连接，需要重新连接 README lines 155-168。
• 部署到网站需使用 HTTPS 并返回正确的 JavaScript / CSS MIME 类型；第三方依赖已放在 js/vendor/，不需要部署 ADB 后端 README lines 72-83。
• 原创代码采用 GPL-3.0-only，Tango 和 xterm.js 组件保留各自的 MIT 许可 README lines 193-202。工具面向全安卓设备，但使用者需具备一定玩机知识，误操作可能导致无法开机或数据丢失 README lines 203-205。

HotRepo 点评

该仓库出现在 HotRepo 2026-11-07 的新项目榜记录中，当时为 159 Star、14 Fork，并记录到一个一小时统计窗口内新增 32 Star。这只是首次观察，不能据此判断长期趋势，上榜也不代表采用率或质量。更值得注意的技术事实是它把 ADB 操作通过 WebUSB 放进浏览器，并内置 Tango 和 xterm.js，使分离版能作为静态站点运行，无需服务端 ADB 桥接。