KPA助手是一款面向 KONKR Pocket Advance（KPA） 掌机的一键初始化工具。它把原本需要反复安装应用、复制配置、整理游戏目录的过程集中到四个步骤里，适合系统重置后快速恢复使用环境。
能做什么
KPA助手可以自动识别配置资料目录和可选的 GBA 整合包，并按正确顺序完成以下工作：
- 清理所选应用遗留的旧配置；
- 安装或覆盖天马G、RetroArch、常用独立模拟器及 MT 文件管理器；
- 导入天马G定制配置、游戏列表和 Android 目录覆盖资料；
- 启动 RetroArch 并等待首次资源释放完成；
- 核对文件数量、大小及关键配置 MD5；
- 汇总非关键应用或少量文件的处理异常，避免小问题中断整套流程。
使用步骤
- 从本文末尾的发布页下载并安装 KPA助手。
- 首次启动后授予“所有文件访问”权限。
- 按页面提示生成授权脚本，在“掌机管理 → 设备 → Root 脚本”中运行根目录的 KPA_Authorize.sh。
- 返回 KPA助手，等待授权自动检测通过。
- 选择配置资料文件夹。GBA 整合包是可选项，没有也可以继续。
- 确认应用、配置资料及 Roms 存储位置，开始初始化。
- 完成后查看核验结果，并按应用内教程完成少量手柄与模拟器设置。
这里所说的 Root 是掌机固件提供的存储脚本能力，并不是给 KPA助手授予完整系统 Root 权限。
初始化顺序
程序会先检查资料和空间，再依次处理天马G、定制配置、可选的 GBA 整合包与最终游戏列表。随后安装 RetroArch，删除旧的 retroarch.cfg 并启动应用，每两秒检查一次资源释放状态，最多等待 60 秒。确认资源完成后，再安装其余模拟器和 MT，最后应用 Android 目录覆盖并进行结果核验。
执行时会进入黑底状态页面，保持屏幕常亮并暂时锁定返回、步骤切换等可能打断流程的操作。页面显示总进度、当前工作和简洁日志；结束或发生关键错误后会自动恢复正常操作。
内部存储与 TF 卡
资料目录和 GBA ZIP 可以放在内部存储或 TF 卡中。Roms 存储位置也可单独选择：
- 选择内部存储时，游戏文件与游戏列表写入内部存储；
- 选择 TF 卡时，只把 Roms 游戏内容和最终游戏列表写入 TF 卡；
- Android/data、RetroArch、模拟器配置和 pegasus-frontend 始终保留在内部存储。
GBA 整合包处理完成后会自动改名为 .zip.bak，避免首次打开天马G时再次识别并重复解压覆盖。
状态与兼容性
结果页使用三种状态：绿色表示全部核验通过；黄色表示主要流程已经完成，但有应用或文件需要查看提示；红色表示天马G、RetroArch、存储授权或资料安全校验等关键步骤失败。
当系统的以下三项参数同时匹配时，授权页会显示 KONKR Pocket Advance：
- Build.MANUFACTURER=ARBOR
- Build.MODEL=GT78-VN
- Build.DEVICE=GT78-VN
其他设备会显示“未知机型，谨慎使用！”，但不会阻止继续操作。软件要求 Android 11 或更高版本，界面针对 KPA 的 960 × 640 横屏进行了优化。
下载与源码
- 项目主页：KPA-Tools
- 最新版本：下载 KPA助手 APK
- 当前包名：com.imnks.kpatools
项目以 MIT License 开源。仓库不包含第三方 APK、配置包或游戏文件；相关应用、配置、教程及游戏内容的版权归各自作者和权利人所有。
