Root 自动化最危险的不是脚本写错一行,而是错误会在无人看守时反复执行。充电控制又直接碰到 OEM 内核驱动与电源管理芯片,机型差异很大。本篇优先推荐系统自带充电保护;确实没有时,才用 ACC 的容量上限做一次白天、有人值守的 80% 暂停/70% 恢复实验,并用 Tasker 或 MacroDroid 做独立高温告警。
你会完成什么#
- 判断是否应该直接使用 OEM 原生充电上限。
- 安装并盘点 ACC,不手工猜测 /sys 充电开关。
- 只设置 pause_capacity=80 与 resume_capacity=70。
- 建立不依赖 ACC 的 42°C 告警和人工拔线急停。
- 观察一次暂停/恢复边界,再恢复默认、停守护进程或卸载。
先看结论#
| 情况 | 建议 | 理由 |
|---|---|---|
| 系统已有 80%/自适应充电 | 用系统功能,不装 ACC | OEM 对电池与驱动最了解,更新兼容性更好 |
| 无原生上限、机型有 ACC 成功报告 | 先做本篇单周期实验 | 容量阈值比自定义电压/电流容易观察和回滚 |
| 电池鼓包、异常掉电、温度传感器跳变 | 停止软件实验并检修 | 自动化不能修复硬件 |
| 小米/Poco 等机型有无法恢复充电报告 | 不在主力机尝试 | ACC 上游明确警告部分 PMIC 可能被触发异常 |
| 需要夜间无人值守 | 本篇不授权 | 首次配置必须白天、有备用充电手段并能持续观察 |
| 想改电压、电流、thermal 或 sysfs | 不做 | 错值可能造成不充电、过热、重启或硬件风险 |
心智模型#
OEM 原生上限?──是→ 使用原生功能并结束
│否
↓
ACC 守护进程:仅 70% ↔ 80% 容量窗口
│ ↑
├─ acc -i / 日志观察 │
└─ OEM 充电开关适配 ┘
+
独立温度告警(Tasker/MacroDroid,≥42°C)
↓
人工拔线 → acc -e → 停 daemon → 默认配置/卸载
ACC 不是“电池保养魔法”,而是根据配置调用内核暴露的充电控制接口。不同机型的开关语义可能相反或无法可靠恢复,所以不能照搬别人的 sysfs 路径。独立温度告警不负责改内核;它只确保当 ACC、充电器或环境异常时,人能及时拔线并执行救援。
工具清单#
| 工具 | 本篇角色 | 使用范围 | 本篇不做 |
|---|---|---|---|
| ACC | 容量窗口与状态/日志 | 官方稳定发行、80/70、默认温控 | 自定义电压/电流、强制开关、sysfs、夜间计划 |
| Root 管理器/Root 终端 | 安装模块并执行 acc 命令 | 核对来源、记录版本、可撤销 | 运行网上一键调参脚本 |
| Tasker 或 MacroDroid | 独立温度告警 | 充电中且温度≥42°C时通知/响铃 | 自动点 UI、循环 Root 命令或静默忽略告警 |
| 系统电池页面 | 第二数据源 | 百分比、温度(若显示)、是否充电 | 把单一瞬时读数当长期健康结论 |
| Zuan Kernel Manager | 了解高级 Root 调参工具范围 | 只读查看项目能力 | 不同时改 CPU/GPU/thermal/充电参数 |
| DisplayToggle | 自动化动作的窄用途示例 | 以后在实验机研究屏幕开关 | 与充电无关,本篇不编译、不授 Root |
项目全景:自动化与调优的 19 个项目,一个不漏#
以“让设备自动完成一个可验证任务”为主题,按 AI Agent、无障碍/测试框架、ADB 设备控制、性能调优和安全分析组织项目,并把农业公司 Root AI 等词义误收条目公开纠正。
| 技术路线 | 项目数 | 处理等级 | 在主题任务中的位置 |
|---|---|---|---|
| AI Agent 与 MCP 设备控制 | 4 | 候选路线 | 用 Autonion、NeuralBridge、agentic-nexus 和视觉模型 Agent 展示从意图到动作的链路,要求屏幕预览、危险动作确认、权限最小化和本地日志清理。 |
| 手势录制、宏与测试框架 | 6 | 候选路线 | 把 MacroDroid、Auto.js 打卡脚本、uiautomator 多后端、getevent 回放和 Appium 页面对象模型放进从录制到断言的流程;账号自动操作需遵守平台规则。 |
| ADB、远程设备与显示控制 | 3 | 候选路线 | 覆盖云端模拟器、DisplayToggle、无线 ADB 自启和基于 ADB 的自动化,说明配对、端口、网络暴露、撤销授权和设备离线恢复。 |
| Root/Shizuku 性能与内核调优 | 2 | 候选路线 | 用内核管理器和 ReAppzuku 一类项目展示“测量—修改—复测—恢复”,不把杀后台或内核预设宣传成无条件省电提速。 |
| 安全分析自动化及其边界 | 2 | 候选路线 | SSL pinning 与攻击链关联项目只放在自有应用或企业 SOC 场景,说明它们与日常 Android 自动化的差异,并给出迁往 reverse_hook/DevSecOps 的建议。 |
| 专项工具与同名误收条目 | 2 | 边界复核 | 逐项覆盖剩余项目;Root AI 农业机器人公司等非 Android 条目只作一句辨析并建议迁类,描述不足的工具明确标记“未验证”,不补写不存在的能力。 |
1. AI Agent 与 MCP 设备控制 · 4#
用 Autonion、NeuralBridge、agentic-nexus 和视觉模型 Agent 展示从意图到动作的链路,要求屏幕预览、危险动作确认、权限最小化和本地日志清理。
本组共 4 项:4 个源项目、0 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| niki914/agentic-nexus | 主题用途:将 niki914/agentic-nexus 纳入「AI Agent 与 MCP 设备控制」候选路线,根据 agent · android · automation · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Take over your Android voice assistant with a custom AI agent — connect any LLM (Claude, GPT, Gemini), use MCP tools, Shell/SSH, and Root/Shizuku automation | 未归档源项目 · ★ 67 · MIT · 2026-07-19。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| dondetir/NeuralBridge_mcp | 主题用途:将 dondetir/NeuralBridge_mcp 纳入「AI Agent 与 MCP 设备控制」候选路线,根据 accessibility-service · ai-agents · android · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):🧠 AI-native Android automation via MCP. Give Claude, GPT, Gemini or any AI agent full control over Android — tap, swipe, type, screenshot — with ~6ms latency. 100x faster than Appium. 43 tools. No root required. | 未归档源项目 · ★ 22 · NOASSERTION · 2026-03-16。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| xjyzs/Operator-on-Android | 主题用途:将 xjyzs/Operator-on-Android 纳入「AI Agent 与 MCP 设备控制」候选路线,根据 agent · ai · ai-agent · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):On-Device Mobile Agent: Control your phone directly with Vision Language Models, untethered from any PC. 手机直接调用视觉大模型 ,无需连接电脑,让 AI 直接操作你的手机! | 未归档源项目 · ★ 6 · MIT · 2026-07-04。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| Autonion/Automation-Companion | 主题用途:将 Autonion/Automation-Companion 纳入「AI Agent 与 MCP 设备控制」候选路线,根据 accessibility-service · ai · android · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):AI-powered Android automation — no root required. Record gestures, build visual workflows, trigger automations by location/time/Wi-Fi, and run LLM-driven agentic tasks on-device or via Cloud APIs. Core of the Autonion cross-device ecosystem. | 未归档源项目 · ★ 5 · NOASSERTION · 2026-06-02。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
2. 手势录制、宏与测试框架 · 6#
把 MacroDroid、Auto.js 打卡脚本、uiautomator 多后端、getevent 回放和 Appium 页面对象模型放进从录制到断言的流程;账号自动操作需遵守平台规则。
本组共 6 项:6 个源项目、0 个 Fork,其中 1 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| georgehuan1994/DingDing-Automatic-Clock-in | 主题用途:将 georgehuan1994/DingDing-Automatic-Clock-in 纳入「手势录制、宏与测试框架」候选路线,根据 996 · 996icu · autojs · JavaScript 核对功能、平台与版本适配。 上游自述(保留原文):钉钉全自动打卡脚本,基于auto.js,免root,适用于蓝牙考勤机 | 已归档源项目 · ★ 977 · 协议未声明 · 2022-07-08。已归档:保留作历史、迁移或兼容性参考,不作为默认安装源。 |
| BespredeL/MacroDroid | 主题用途:将 BespredeL/MacroDroid 纳入「手势录制、宏与测试框架」候选路线,根据 android · android-automation · android-tools 核对功能、平台与版本适配。 上游自述(保留原文):MacroDroid macros collection for Android automation: control your Android via Telegram, automate tasks, monitor devices, send notifications and manage smart workflows without root. | 未归档源项目 · ★ 72 · MIT · 2026-07-03。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| hansalemaos/cyandrocel | 主题用途:将 hansalemaos/cyandrocel 纳入「手势录制、宏与测试框架」候选路线,根据 adb · android · automation · Cython 核对功能、平台与版本适配。 上游自述(保留原文):Android Automation Framework for real devices without root access with multiple backends (uiautomator, uiautomator2, fragment parser, tesseract ...)! | 未归档源项目 · ★ 70 · MIT · 2025-08-17。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| hansalemaos/geteventplayback | 主题用途:将 hansalemaos/geteventplayback 纳入「手势录制、宏与测试框架」候选路线,根据 android · automation · capture · Python 核对功能、平台与版本适配。 上游自述(保留原文):A pure Python module for recording and processing low-level Android input events (Mouse/Keyboard/Touchpad) - no dependencies | 未归档源项目 · ★ 10 · MIT · 2023-12-16。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| nabilalakhani/appiumJAVA | 主题用途:将 nabilalakhani/appiumJAVA 纳入「手势录制、宏与测试框架」候选路线,根据 Java 核对功能、平台与版本适配。 上游自述(保留原文):This is a generic Page Object Model which solves all your automation needs with single codebase. We often tend to create different test frameworks for different platforms and it's very difficult for anyone to serve all platform needs in one test automation framework. OneFramework solves all your needs. You just give the locator and leave the rest to OneFramework. Contents: Features Libraries Used Prerequisites Installations Appium Setup How This Framework Works How To Run Tests How To See Allu | 未归档源项目 · ★ 6 · 协议未声明 · 2022-05-18。边界命中:先读 README,确认它确实属于当前任务,再决定是否使用。 |
| theGeekyLad/replay.it | 主题用途:将 theGeekyLad/replay.it 纳入「手势录制、宏与测试框架」候选路线,根据 adb · android · android-automation · Java 核对功能、平台与版本适配。 上游自述(保留原文):Automate everything on Android! Send messages on WhatsApp at a scheduled time or maybe even fill your timesheet everyday. | 未归档源项目 · ★ 5 · 协议未声明 · 2020-05-20。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
3. ADB、远程设备与显示控制 · 3#
覆盖云端模拟器、DisplayToggle、无线 ADB 自启和基于 ADB 的自动化,说明配对、端口、网络暴露、撤销授权和设备离线恢复。
本组共 3 项:3 个源项目、0 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| mouldybread/adb-auto-enable | 主题用途:将 mouldybread/adb-auto-enable 纳入「ADB、远程设备与显示控制」候选路线,根据 adb · android · automation · Java 核对功能、平台与版本适配。 上游自述(保留原文):Automatically enable wireless ADB and switch to port 5555 on Android device boot - no root required. Seamless wireless debugging on Chromecast with Google TV and other Android devices. | 未归档源项目 · ★ 151 · MIT · 2025-12-18。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| HunterXProgrammer/DisplayToggle | 主题用途:将 HunterXProgrammer/DisplayToggle 纳入「ADB、远程设备与显示控制」候选路线,根据 adb · android · display 核对功能、平台与版本适配。 上游自述(保留原文):Turn ON/OFF the display of your Android phone screen, like scrcpy, using ADB Shell or Root. | 未归档源项目 · ★ 83 · 协议未声明 · 2025-03-14。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| 0xN404T/cloud-phone | 主题用途:将 0xN404T/cloud-phone 纳入「ADB、远程设备与显示控制」候选路线,根据 adb · android · automation · Shell 核对功能、平台与版本适配。 上游自述(保留原文):📱 Self-hosted Android Emulator — full root, ADB remote, app automation, browser-based control panel | 未归档源项目 · ★ 16 · MIT · 2026-05-31。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
4. Root/Shizuku 性能与内核调优 · 2#
用内核管理器和 ReAppzuku 一类项目展示“测量—修改—复测—恢复”,不把杀后台或内核预设宣传成无条件省电提速。
本组共 2 项:1 个源项目、1 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| gree1d/ReAppzuku | 主题用途:将 gree1d/ReAppzuku 纳入「Root/Shizuku 性能与内核调优」候选路线,根据 android · appmanager · appops · Java 核对功能、平台与版本适配。 上游自述(保留原文):Simple tool to improve your phone's performance by managing background and foreground apps. Make your phone great again 🚀 | 未归档 Fork · ★ 131 · GPL-3.0 · 2026-07-19。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| ZUANVFX01/ZKM | 主题用途:将 ZUANVFX01/ZKM 纳入「Root/Shizuku 性能与内核调优」候选路线,根据 application · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Zuan Kernel Manager App For Root Device Android With Material 3 Expressive Modern Style. | 未归档源项目 · ★ 95 · GPL-3.0 · 2026-02-22。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
5. 安全分析自动化及其边界 · 2#
SSL pinning 与攻击链关联项目只放在自有应用或企业 SOC 场景,说明它们与日常 Android 自动化的差异,并给出迁往 reverse_hook/DevSecOps 的建议。
本组共 2 项:2 个源项目、0 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| ezztahoun/attack_flow_detector | 主题用途:将 ezztahoun/attack_flow_detector 纳入「安全分析自动化及其边界」候选路线,根据 correlation · cyber-analytics · cybersecurity · Python 核对功能、平台与版本适配。 上游自述(保留原文):Find relevant incidents, logs, events, and alerts to all of your incidents. (Attack Flows, Attack Chains, & Root Cause Discovery - NO LLMs, NO Queries, Just Explainable Machine Learning) >> Use it for free here: https://app.cypienta.io | 未归档源项目 · ★ 74 · MIT · 2025-04-18。边界命中:先读 README,确认它确实属于当前任务,再决定是否使用。 |
| 0xSHAK1B/Meta-Business-Suite-SSL-Pinning-Bypass | 主题用途:将 0xSHAK1B/Meta-Business-Suite-SSL-Pinning-Bypass 纳入「安全分析自动化及其边界」候选路线,根据 brup-suite · bug-bounty · business-suite · Shell 核对功能、平台与版本适配。 上游自述(保留原文):Bypass Meta Business Suite SSL/TLS certificate pinning on Android to intercept & analyze HTTPS traffic — root & no-root, works with Burp Suite & mitmproxy (2026). | 未归档源项目 · ★ 12 · MIT · 2026-06-27。边界命中:先读 README,确认它确实属于当前任务,再决定是否使用。 |
6. 专项工具与同名误收条目 · 2#
逐项覆盖剩余项目;Root AI 农业机器人公司等非 Android 条目只作一句辨析并建议迁类,描述不足的工具明确标记“未验证”,不补写不存在的能力。
本组共 2 项:2 个源项目、0 个 Fork,其中 0 项已归档。它们的平台、用途或分类存在边界,只作逐项核验,不当作默认安装候选。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| valentin00013/RootAI | 主题用途:将 valentin00013/RootAI 作为「专项工具与同名误收条目」边界条目,通过 仓库名、README 与发布记录 核对它实际是否属于本教程。 上游自述(保留原文):Root AI, the company – A robotics and AI company that specialized in agricultural automation. They developed autonomous harvesting robots like “Virgo” before being acquired by AppHarvest. | 未归档源项目 · ★ 60 · 协议未声明 · 2025-02-05。边界条目:先核对实际平台、用途和分类理由,不作为默认安装源。 |
| Olechka2002/RootAI | 主题用途:将 Olechka2002/RootAI 作为「专项工具与同名误收条目」边界条目,通过 仓库名、README 与发布记录 核对它实际是否属于本教程。 上游自述(保留原文):Public Root AI, the company – A robotics and AI company that specialized in agricultural automation. They developed autonomous harvesting robots like “Virgo” before being acquired by AppHarvest. | 未归档源项目 · ★ 35 · 协议未声明 · 2025-02-07。边界条目:先核对实际平台、用途和分类理由,不作为默认安装源。 |
开始前#
先在系统“电池”里寻找充电上限、保护电池或自适应充电。若能满足需求,直接用它。本篇只适合状态稳定的备用/可恢复设备:电池不鼓包、充电口正常、Root 可撤销、能进入 Root 终端,且电量在 40%–75% 之间。准备原装/可信充电器、计时器与一条书面救援卡。
救援卡写明并提前理解:acc -i 查看状态;acc -e 尝试恢复充电;acc -D stop 停止守护进程;acc -s r 恢复默认配置;acc -U 完全卸载。确认 Root 管理器也能禁用 ACC 模块。实验全程有人看守,不放在床上/车内/阳光下,不进行游戏、导航或相机压力负载。
操作步骤#
1. 保存原生基线与救援路径#
卸载/关闭其他充电控制模块、内核管理器配置和自动化,避免多方写同一开关。记录 Android/build、内核、Root 方案、ACC 版本、当前百分比、温度、充电器,以及系统原生保护功能状态。插电观察五分钟,确认未装 ACC 的基线能稳定充电,再拔线。
在 Root 终端依次测试能否打开 su 会话、能否退出,以及 Root 管理器的模块禁用入口。不要先执行任何 /sys 写入。救援卡放在另一台设备或纸上,避免手机界面故障时无法查看。
2. 安装 ACC 并只读盘点#
仅从 VR-25/acc 上游发行页获取稳定包,按你的 Root 管理器官方模块流程安装。安装后先运行 acc -D、acc -i 和 acc -s p,保存守护进程、充电信息与当前配置;如果命令不存在、日志报错或机型开关检测异常,卸载并结束。
运行 acc 交互向导时保持不了解的选项为默认。不要选择自定义 charging_switch,不设置电压、电流、温度、强制快充、开机脚本或定时任务。
3. 设置 80/70 容量窗口#
运行 acc 80 70;ACC 官方快捷方式的顺序是“暂停容量、恢复容量”。再用 acc -s p 查看并确认 pause_capacity=80、resume_capacity=70,其他参数仍为默认。若输出不是这两个值,不重复乱输,运行 acc -s r 恢复默认并查看官方帮助。
此时不要叠加 Tasker Root shell 控制。容量策略由 ACC 守护进程独立负责,自动化工具只做告警,减少两个调度器互相打架。
4. 建立独立温度告警#
在 Tasker 或 MacroDroid 新建一个配置:触发条件为“电源已连接”且“电池温度≥42°C”;动作为高优先级通知、声音/振动,并显示“立即拔线,运行 acc -i,必要时 acc -e 与 acc -D stop”。再建一个低于 40°C 的恢复提示即可,不执行任何 Root shell。
用工具的“测试动作”验证通知和声音可见,不要通过加热手机来触发。确认自动化有总开关,并把它加入救援卡。若系统不向工具提供可靠温度变量,就放弃自动告警,改用实验期间每五分钟人工查看。
5. 观察一周期并演练回滚#
白天将设备置于不燃、通风表面插电,每五至十分钟记录系统百分比/温度与 acc -i。接近 80% 时应转为未充电/空闲,百分比不再持续上升;拔线正常使用至接近 70%,再次插电应恢复充电。这个自然周期可能超过标注的主动操作时间,不可用高负载加速放电。
验证后先运行 acc -s r 恢复默认。如果不再使用,运行 acc -D stop,再运行 acc -U,按 Root 管理器提示完成移除并重启。插电观察十分钟,确认系统恢复原生充电行为;关闭/删除温度告警并记录最终状态。
验证#
| 检查项 | 成功标准 | 危险信号 |
|---|---|---|
| 变更范围 | 只有 80/70 容量值改变 | 电压、电流、温控、switch 或 sysfs 也被改 |
| 温度急停 | 42°C 规则能测试通知,且有总开关 | 告警静默、依赖同一 ACC 脚本或自动忽略 |
| 80% 暂停 | 状态转为空闲/未充电,温度正常 | 百分比继续升、状态抖动或发热 |
| 70% 恢复 | 重新插电能稳定恢复充电 | 不充电、反复连接或意外重启 |
| 回滚 | 默认配置/停服/卸载后原生充电正常 | acc -e 和停服后仍无法充电 |
| 权限清理 | 无其他调参工具或 Root 循环任务 | 多个工具同时写电源/thermal 节点 |
排错#
| 现象 | 常见原因 | 安全处理 |
|---|---|---|
| 80% 没暂停 | 机型开关不受支持、OEM 原生策略冲突 | 拔线,导出 ACC 日志并恢复默认;不手填未知 sysfs |
| 低于 70% 仍不充电 | 开关无法恢复或 PMIC/驱动状态异常 | 保持电量>25%,执行 acc -e、停 daemon、禁用/卸载并重启;仍失败就关机检修 |
| 状态在充电/未充电间抖动 | 阈值、充电器或开关语义不稳定 | 立即拔线结束,不用更窄窗口“修复” |
| 温度告警频繁误报 | 变量单位/传感器或工具事件不可靠 | 关闭自动化,以系统/ACC读数交叉核对;不覆盖温度传感器 |
| 重启或模块管理卡住 | 内核/Root/ACC 兼容问题 | 禁用 ACC 模块并保留日志,回到原生方案 |
| 想加 Tasker shell“更智能” | 多调度器造成竞态和无人值守风险 | 保持 ACC 单一写入者;Tasker/MacroDroid 只告警 |
完成清单#
- 我先检查并优先考虑 OEM 原生充电保护。
- 我保存了基线、ACC 状态和离线救援卡。
- 我只设置 80/70,没有改电压、电流、温控、switch 或 sysfs。
- 我建立并测试了独立 42°C 告警,且没有用加热触发。
- 我在白天有人看守时验证暂停与恢复,没有高负载加速。
- 我演练了默认配置、停服/卸载,并确认原生充电恢复。