CzJam/gjgjxwebPublic

《搞机工具箱》是一款ADB图形化工具。

本项目移植于个人开发的 《搞机工具箱》PC版 。借助 Tango 实现了 WebADB，并通过 xterm.js 打通 Android 原生 Shell 交互式终端，可运行在基于Chromium内核的浏览器中，实现免下载、免安装的跨平台使用体验。

作者 @晨钟酱Official

官网: jamcz.com

当前界面提供 USB 有线连接。功能是否生效取决于设备的 Android 版本、ROM 和 ADB Shell 权限。进入 Fastboot 的按钮仅发送重启命令，本工具暂不提供 Fastboot 刷机功能。

• 使用支持 WebUSB 的 Chrome 或 Edge 或 其他基于Chromium内核的浏览器（不分操作系统，手机安装Chrome也能用）。
• 手机开启开发者选项和 USB 调试，使用 USB 数据线连接电脑。
• 通过本机 localhost / 127.0.0.1 或 HTTPS 网站访问页面。
• Windows 需要能够正常识别手机的 ADB USB 接口，且手机端同意授权请求。

仓库默认为 HTML、CSS、JavaScript的前端分离版 ，同时提供AIO的 单HTML整合版。页面和第三方依赖均保存在本地，可直接本地部署或执行，无需构建或安装 npm 依赖。

下载项目docs中的index.html。已内嵌完整依赖，使用Chromium内核浏览器直接本地运行。

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

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

3. 运行：

   node server.cjs

4. 使用 Chrome 或 Edge 打开 http://127.0.0.1:8124。

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

按 Ctrl+C 停止服务。服务只监听本机地址 127.0.0.1。

若默认端口被占用，可在 PowerShell 中更换端口：

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

随后打开 http://127.0.0.1:8080。也可以使用其他能够正确提供 ES 模块的静态网页服务器。

请通过网页服务器打开分离版。 直接双击 index.html 会使用 file:// 地址，外部 ES 模块可能因浏览器的跨源限制而加载失败，导致连接按钮不可用。参见 MDN：JavaScript 模块。

将本目录中的完整文件上传到支持 HTTPS 的静态托管服务或 Web 服务器，以 index.html 为入口即可。第三方依赖已包含在 js/vendor/ 中，运行时无需额外从 CDN 下载依赖，也不需要部署 ADB 后端。

• 保留 index.html、css/、js/、assets/ 的相对路径。
• 对外提供服务时使用 HTTPS。本机回环地址属于浏览器认可的可信来源，因此本地开发可以使用 HTTP。参见 MDN：安全上下文。
• JavaScript 应返回有效的 JavaScript MIME 类型，例如 text/javascript；CSS 应返回 text/css。不要将它们统一返回为 application/octet-stream。
• 如果自行改为 CDN 引用，脚本、样式和模块依赖也应使用 HTTPS，避免被浏览器作为混合内容屏蔽。
• server.cjs 是可选的本地启动工具；部署到静态托管平台后，访问者无需安装 Node.js。

WebUSB 的授权和使用条件可参考 Chrome WebUSB 文档。

.
├── index.html                 # 页面结构与模块入口
├── README.md                  # 项目说明
├── LICENSE                    # 项目 GPLv3 许可证全文
├── server.cjs                 # 本地静态服务器（Node.js 标准库）
├── LICENSE-Tango.txt          # Tango 相关组件许可
├── LICENSE-xterm.txt          # xterm.js 相关组件许可
├── assets/
│   └── favicon.svg            # 页面图标
├── docs/
│   └── index.html             # 完整本地运行文件
├── css/
│   ├── styles.css             # 工具箱样式
│   └── xterm.css              # 终端样式
└── js/
    ├── app.js                 # 页面初始化、交互、连接状态与设置
    ├── core.js                # 命令执行与各功能逻辑
    ├── transport.js           # Tango / WebUSB 连接与传输
    ├── terminal.js            # 交互式终端会话
    ├── batch.js               # BAT 语法子集解释器
    └── vendor/                # 本地第三方依赖

终端连接的是手机上的 Android Shell，可直接输入 Shell 命令：

getprop ro.product.model
wm size
settings get system font_scale

同一连接中的终端会话保留当前目录和环境变量；切换页面不会重新创建会话。历史记录和补全由设备上的 Shell 提供，Ctrl+C 可中断正在运行的命令。断开设备或重新启动终端会结束当前会话。

控机脚本通过 JavaScript 解释部分 BAT 语法，将其中的 ADB 操作转换为浏览器端调用，不会启动 Windows 的 cmd.exe 或执行电脑上的 EXE。

例如，可以导入并执行以下脚本：

@echo off
echo 读取设备型号
adb shell getprop ro.product.model
timeout /t 1
adb shell wm size

支持的语法包括 echo、rem、set、set /a、set /p、变量替换、标签与 goto、部分 if 条件、if errorlevel、多行括号形式的 for /l、timeout、choice /t、pause 和 exit /b。具体支持范围以解释器实现为准。

涉及 adb push、adb install 等本地文件操作时，需要先在页面中关联对应文件。浏览器无法仅凭脚本中的 Windows 路径读取电脑文件。

这套解释器兼容的是 BAT 语法子集。依赖外部程序、PowerShell、for /f 或复杂 CMD 语法的脚本需要调整；遇到不支持的命令时会报告错误。

• 设置、脚本文本、软件操作记录：保存在当前网站的浏览器本地存储中。清理网站数据会删除这些内容；设置和脚本可通过页面提供的功能导出备份。
• ADB 身份密钥：由 Tango 保存在浏览器 IndexedDB 中。可在断开设备后，通过软件设置清除。
• 网站地址变更：不同协议、域名或端口使用独立的网站存储，迁移部署地址后可能需要重新授权和导入设置。
• 截图与电池统计：需要及时下载保存，当前页面内的临时数据不会跨刷新保留。
• 电池 CSV：文件名使用连接设备读取到的机型名称和日期时间，例如 一加 15T_2026-11-03_14-30-00.csv；无法读取营销名称时回退到系统型号。
• 下载目录：可在支持的浏览器中授权保存目录；未授权时使用普通浏览器下载。截图“下载后删除手机原图”仅在确认写入所选目录后执行，普通浏览器下载会保留手机原图。

设备命令通过浏览器与手机之间的 USB 连接执行，不经过本项目的远程 ADB 服务。文件与目录访问需要用户通过浏览器选择或授权。

本分离版直接使用原生 JavaScript ES 模块。修改后启动 server.cjs 并刷新页面即可查看效果，无需执行依赖安装或打包命令。

• 修改页面布局：index.html。
• 修改样式：css/styles.css。
• 修改页面交互与设置：js/app.js。
• 修改设备命令和功能逻辑：js/core.js。
• 修改 USB 连接、终端或脚本解释：分别查看 js/transport.js、js/terminal.js、js/batch.js。
• 更新第三方组件时，检查模块引用与接口兼容性，并保留相应的版权及许可证文件。

欢迎通过仓库的 Issues 反馈问题或提交 Pull Request。反馈时请提供工具版本、浏览器版本、电脑系统、设备型号、Android / ROM 版本、复现步骤和相关错误信息。提交截图或命令输出前，请隐藏设备序列号、主板 ID 等个人设备信息。

涉及设备行为的修改，请说明实际测试设备及结果；未经实机验证的行为请明确注明。

感谢以下开源项目：

本项目的原创代码采用 GNU General Public License v3.0（GPL-3.0-only），许可证全文见 LICENSE。

Copyright (C) 2026 晨钟酱Official。

第三方组件保留各自的版权与 MIT 许可，详见 LICENSE-Tango.txt 和 LICENSE-xterm.txt。分发时请保留这些声明。

本软件按许可证所述提供，不附带任何担保。

本工具为全安卓通用软件。使用本工具则代表您有一定玩机知识储备。若盲目操作导致无法开机或丢失数据则后果自负，作者不承担任何责任。