RootForge

面向 Root Android 设备的跨平台（macOS / Windows）操作与配置 TUI 工具。通过 ADB、Fastboot 与串口设备探测提供：

• 本机 ADB 检测 / 安装（Homebrew / winget）
• ADB、Recovery、Sideload、Fastboot、Fastbootd 与 Windows 串口状态探测
• 跨 ADB、Fastboot、EDL 9008 与联发科串口模式选择设备
• 在受支持的来源模式下切换系统、Recovery、Fastboot、Fastbootd、EDL 或关机
• 设备参数全量备份与分组还原
• 三角洲行动：首次清理、封号清理、设备伪装
• 其他游戏：按包名通用清理

许可：专有软件（UNLICENSED）。仅授权安装与运行，禁止擅自再分发或二次发布。详见 LICENSE。

前提

• Node.js ≥ 20
• 设备已开启 USB 调试并授权
• 设备已 Root（su 可用）
• 设备伪装需要 resetprop（通常 Magisk / KernelSU）
• Windows 建议使用 Windows Terminal

安装（用户）

npm install -g rootforge
rootforge

开发

cd RootForge
npm install
npm run dev          # 开发热跑
npm run build        # tsc 类型检查 / 多文件输出
npm run build:release  # 发布用：单文件 minify → dist/cli.js
npm start

发布（维护者）

预发布（不实际上传）：

npm run pack:check
# 期望 dry-run 仅含：
#   package.json / LICENSE / README.md / dist/cli.js / dist/devcon.exe

确认无误后再发布：

npm login
npm publish --access public

• prepublishOnly 会自动跑 build:release（esbuild 单文件 ESM + minify + createRequire）
• 发布物不含 src/、Resource/、类型声明与 source map
• 许可为专有 UNLICENSED，见 LICENSE

升级已安装的全局包：

npm i -g rootforge@latest

菜单结构

本机 ADB 配置
设备参数备份（仅 ADB 系统模式）
  ├─ 备份当前设备参数
  ├─ 查看备份状态
  └─ 还原设备参数
游戏清理（仅 ADB 系统模式）
  ├─ 三角洲行动
  │   ├─ 首次清理
  │   ├─ 封号清理
  │   └─ 设备伪装
  └─ 其他游戏
环境配置（仅 ADB 系统模式）
重启设备
  ├─ 按当前模式显示可用目标
  └─ 确认后发送重启命令
选择设备
退出

行为要点

• 无 ADB 不自动安装，请到「本机 ADB 配置」手动触发
• 首次启动会结束可能冲突的 ADB/Fastboot 相关进程；失败会警告但不阻断初始化
• 可选择 ADB 系统、Recovery、Sideload、Fastboot、Fastbootd、EDL 9008、联发科 BROM 和联发科 Preloader；串口设备需要可解析的 COM 端口
• EDL 9008 和联发科串口模式本次仅支持选择，不提供来源重启操作
• Sideload 重启到系统会直接发送 adb reboot，不预判设备兼容性
• 重启成功只表示命令进程成功退出，不检测设备最终模式，也不自动改写当前选择状态
• Fastboot 的 Recovery、EDL 和关机命令依赖设备 Bootloader 支持，失败时直接显示命令错误
• 非 ADB 系统模式隐藏设备参数备份、环境配置、游戏清理及 Root 信息
• ADB 系统模式显示当前活动分区，优先读取 ro.boot.slot_suffix，无法确认时使用 Root 执行 bootctl get-current-slot；空值最终显示“未知（疑似 A only）”
• Fastboot 与 Fastbootd 模式显示 BL 解锁状态和当前活动分区；A-only 设备显示 A only，变量无法读取时显示未知并保留警告
• 非 ADB 系统模式不能执行现有清理功能
• 无 Root 硬失败，不降级
• 无 resetprop 时伪装失败
• 改机前若无设备参数备份会提示，可停止或继续
• 清理结束后询问是否重启；伪装不自动重启
• 备份目录：/data/adb/rootforge_backup

调试

ROOTFORGE_DEBUG=1 rootforge

免责声明

本工具仅供设备管理与技术学习。使用可能影响系统标识与应用数据，请自行承担账号与设备风险，并遵守游戏与当地法规。