一键重载模块(gs_quick_reload)· 三星 Galaxy Z Fold7 专用
一个按钮,让 KernelSU 模块生效——不用拿折叠屏的副屏去换。
点「执行」后按 KernelSU 自己的流程跑
post-fs-data/services,再只重启 zygote, 跳过stop/start;SurfaceFlinger 全程存活,副屏(port=148)不掉。
适用机型:仅限三星 Galaxy Z Fold7
SM-F966B,One UI 9 / Android 17,内核 6.6.127(KMI android15-6.6,android15 只是内核分支名),
root 用 GhostSam 晚加载临时 root(或任意 KernelSU 兼容分支)。
看门狗时序、夜间模式判据、lspd 健康判据都是在这台机器上实测出来的,compatibility.androidMinApi 钉在 37。
其他折叠屏或系统版本原理相通但未经实测:先跑一次 check,出问题请附机型与系统版本提 issue。
- 作者:CodeFishK · https://github.com/CodeFishK
一、它解决什么问题
KernelSU 自带的「软重启」实际是 ksud 的 soft_reboot():
stop → post-fs-data → start → services → 等 boot_completed
stop 会把 SurfaceFlinger 一起停掉,整个显示栈重建。在折叠屏上,重建后 composer HAL
不再重发 hotplug,HWC 里就只剩内屏,副屏整场会话都不亮,只能冷启动恢复。
本模块只做中间那两步,跳过 stop/start:
ksud post-fs-data # 挂载模块、跑 post-fs-data.sh、加载 system.prop
ksud services # 跑 service 阶段脚本
setprop ctl.restart zygote # 只重启 zygote,SurfaceFlinger 活着
代价:所有应用退出一次(zygote 重启),约 20 秒回到锁屏。
收益:副屏不受影响。实测 SurfaceFlinger 可连续存活一整天,port=147 / port=148 都在线。
二、安装
- 在 KernelSU 管理器中安装本模块的 ZIP
- 装完提示「重启生效」时可以忽略——本模块不挂载任何文件,装完即可点「执行」
前提:设备已有 root(KernelSU 或兼容分支)。本模块不提供 root,也不修改系统分区。
三、使用
装好后进入模块页,点「执行」。终端等价命令:
sh /data/adb/modules/gs_quick_reload/gs-reload-modules.sh
只体检、不重启(建议先跑这个看现状):
sh /data/adb/modules/gs_quick_reload/gs-reload-modules.sh check
子命令
| 命令 | 作用 |
|---|---|
| 无参数 | 完整流程:ksud 两阶段 + 重启 zygote |
-n |
只跑到 services,不重启(调试用) |
-f |
兜底模式:逐个模块目录跑脚本,不走 ksud |
check |
只体检:显示设备、模块画像、守护实例、注入健康、夜间模式 |
mods |
导出模块清单到 /data/local/tmp/gs-modules.txt |
dump <模块id> |
把某个模块目录打包成 tar,便于离线分析 |
trim |
清理重复的 lspd(保留持有监听 socket 的那个) |
trim --zn |
连 zn-daemon 一起清(有风险,见第五节) |
night |
把夜间模式还原成「自动(日落到日出)」并纠正昼夜判定,不需要 root |
夜间模式自愈
ui_night_mode 取值:0 = 自动(日落到日出)、1 = 始终浅色、2 = 始终深色、
3 = 自定义时间表。注意 0 不是「始终浅色」,很容易搞反。
重启 zygote 会让 TwilightService 丢状态,之后系统不会自己重算:要么直接翻深色,
要么卡在浅色不动,一直等到你手动去设置里重设一次。
从 v2.3 起,守护改用「绝对判据」:算出「此刻应该深色还是浅色」,不再和「重启前是什么」比较。 判据按优先级取:
dumpsys uimode里的sunrise/sunset(Twilight 真的有值时);- 三星自带的「黑暗模式定时」
settings get system display_night_theme_*(定时开启 + 自定义时间); - 兜底 19:00–07:00。
- 重启后 45 秒、90 秒各查一次(这个窗口最容易丢判定);
- 之后每 2 分钟复查一次、持续 12 小时 —— v2.3 的 10 分钟间隔太粗,实测里出现「屏幕亮了近 2 分钟才被纠回」;
- 你一旦自己改了模式(切成始终浅色 / 深色),守护立刻退出,不跟你抢;
- 防拉锯:30 分钟内被外部改回 5 次,就主动让位 45 分钟 —— 说明有别的例程在争这个开关, 继续对打只会耗电,日志里会写明「让位」。
三个实测结论:
cmd uimode night auto在判定卡错时不会触发重算 —— 单发 auto 数值不动, 必须先给一个明确的固定值(night no/night yes)顶过去,再回 auto 才有效。- 「顶」那一步若被打断(终端断开、进程被 kill),模式会停在固定值上,
表现就是「夜间模式不再自动」。因此守护带
trap:任何退出路径都还原原模式, 并回读settings get secure ui_night_mode校验。 - 不能拿「重启前那一刻的判定」当基准。11-12 20:19 那次重载:日落 17:11,
重启前后都是
false,旧版据此判定「正确」就收工,整晚没变深色,直到手动重设。 现在算绝对答案,这类情况在第一次检查(重启后 45 秒)就会被纠正。 - Z Fold7 上 Twilight 经常是空的(
mTwilightService.getLastTwilightState()=null), 而且系统会自己把模式拨回浅色 —— 11-13 00:12 就是com.samsung.android.lool干的。 所以判据要能在「没有日出日落」时退到三星自己的定时设置上,复查间隔也不能太长。
想调节奏可以用环境变量:NIGHT_STEP(复查间隔,默认 120 秒)、NIGHT_SPAN(守护总时长,默认 43200 秒)。
真遇到了,用 night 子命令收尾:
sh /data/adb/modules/gs_quick_reload/gs-reload-modules.sh night
四、日志
都在 /sdcard/GS/logs/,不需要 root 就能读,方便直接贴出来求助:
| 文件 | 内容 |
|---|---|
gs-reload.log |
主日志:每轮开始时间、各阶段 exit code、守护进程数、实际运行的脚本副本 |
gs-boot-wd.log |
sys.boot_completed 看门狗(仅当有模块等待该属性时才启动) |
gs-night.log |
夜间模式守护:重启前后的昼夜判定对比 |
gs-boot-wd.err |
看门狗 helper 的 stderr(正常为空) |
脚本自身另备份在 /data/adb/gs/gs-reload-modules.sh,即使 /data/local/tmp
被别的模块清空也仍可用。
五、几个已经踩过的坑
-
zn-daemon会一次比一次多 Zygisk Next 的service.sh每执行一次就多一个守护进程,都是 sleeping,不影响功能, 但会线性增长。不要随手trim它:监听 socket 在 fork 出来的zygiskd里, 从自身 fd 判不出持有者,误杀会让所有新启动的应用报zn-zygisk-loader64: connect daemon failed with 111(丢注入,已运行的应用不受影响)。 嫌多就冷启动一次。 -
resetprop -w sys.boot_completed 1会永久挂起 该等待只在属性发生 0→1 变化时唤醒;若等待开始时值已是 1,就再也醒不过来。 某些模块(如 RCQ 环境)依赖它分段执行,于是「启动太快」时后续片段永不执行。 脚本会先扫描模块脚本里有没有这类等待者,有才在重启后主动制造一次 0→1 边沿 (距重启 ≥25 秒,确保等待已开始);没有就只保留「卡 0 太久 → 置 1」的安全网。 -
不要把日志放在
/data/local/tmp某些「隐藏 root / 清理环境」模块会rm -rf /data/local/tmp/*,脚本和日志一起消失。 -
临时 root(如 GhostSam)冷启动后全部丢失 root、模块挂载、脚本进程都会没有,需要重新获取 root 再点一次「执行」。 这是临时 root 的固有行为,不是模块的问题。
六、排错顺序
sh <脚本> check—— 副屏端口(port=147/port=148)、lspd实例数、zn-daemon数量、注入失败数、夜间模式/sdcard/GS/logs/gs-reload.log—— 哪一步 exit 非 0、卡在哪个阶段pidof lspd—— LSPosed 是否在跑(只看这个;/proc/net/unix被改成 440 时 非 root 读不到是正常的)logcat | grep LSPosedFramework—— 真正的注入证据,形如(com.tencent.mobileqq:MSF)[...] installed 1 QQ hooks- 副屏不亮且
port=148缺失 —— 说明显示栈被stop重建过, 检查是不是用了管理器自带的「软重启」而不是本模块
七、卸载
KernelSU → 模块 → 移除本模块即可,不会留下挂载。
/data/adb/gs/ 与 /sdcard/GS/logs/ 是纯脚本与文本,可一并手动删除。
免责
脚本会重启 zygote 并调用 ksud 的阶段命令,属于对系统运行状态有实际影响的操作,
请自行判断风险。本模块不修改系统分区,也不触碰 /data/property 等危险路径,
但任何 root 操作都不能保证在所有 ROM 版本上零风险。
相关项目与致谢
- GhostSam —— 三星机型的临时 root 方案, 本模块的所有实测都在它提供的晚加载 root 环境下完成。没有它,Z Fold7 上连调试的 入口都没有。
- KernelSU / KernelSU Next —— 模块框架与
ksud的阶段命令。 - 本模块作者:CodeFishK(https://github.com/CodeFishK)。
许可证
MIT。见 LICENSE。