跳到主要内容
KernelSU 模块

一键重载模块(Fold7)

不可变 Release 已同步

三星 Galaxy Z Fold7(Android 17)专用:一键重载 KernelSU 模块,只重启 zygote、跳过 stop/start,副屏不掉;附体检与夜间模式自愈。

介绍

一键重载模块(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。


一、它解决什么问题

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 都在线。


二、安装

  1. 在 KernelSU 管理器中安装本模块的 ZIP
  2. 装完提示「重启生效」时可以忽略——本模块不挂载任何文件,装完即可点「执行」

前提:设备已有 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 起,守护改用「绝对判据」:算出「此刻应该深色还是浅色」,不再和「重启前是什么」比较。 判据按优先级取:

  1. dumpsys uimode 里的 sunrise / sunset(Twilight 真的有值时);
  2. 三星自带的「黑暗模式定时」settings get system display_night_theme_*(定时开启 + 自定义时间);
  3. 兜底 19:00–07:00。
  • 重启后 45 秒、90 秒各查一次(这个窗口最容易丢判定);
  • 之后每 2 分钟复查一次、持续 12 小时 —— v2.3 的 10 分钟间隔太粗,实测里出现「屏幕亮了近 2 分钟才被纠回」;
  • 你一旦自己改了模式(切成始终浅色 / 深色),守护立刻退出,不跟你抢;
  • 防拉锯:30 分钟内被外部改回 5 次,就主动让位 45 分钟 —— 说明有别的例程在争这个开关, 继续对打只会耗电,日志里会写明「让位」。

三个实测结论:

  1. cmd uimode night auto 在判定卡错时不会触发重算 —— 单发 auto 数值不动, 必须先给一个明确的固定值(night no / night yes)顶过去,再回 auto 才有效。
  2. 「顶」那一步若被打断(终端断开、进程被 kill),模式会停在固定值上, 表现就是「夜间模式不再自动」。因此守护带 trap:任何退出路径都还原原模式, 并回读 settings get secure ui_night_mode 校验。
  3. 不能拿「重启前那一刻的判定」当基准。11-12 20:19 那次重载:日落 17:11, 重启前后都是 false,旧版据此判定「正确」就收工,整晚没变深色,直到手动重设。 现在算绝对答案,这类情况在第一次检查(重启后 45 秒)就会被纠正。
  4. 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 被别的模块清空也仍可用。


五、几个已经踩过的坑

  1. zn-daemon 会一次比一次多 Zygisk Next 的 service.sh 每执行一次就多一个守护进程,都是 sleeping,不影响功能, 但会线性增长。不要随手 trim 它:监听 socket 在 fork 出来的 zygiskd 里, 从自身 fd 判不出持有者,误杀会让所有新启动的应用报 zn-zygisk-loader64: connect daemon failed with 111(丢注入,已运行的应用不受影响)。 嫌多就冷启动一次。

  2. resetprop -w sys.boot_completed 1 会永久挂起 该等待只在属性发生 0→1 变化时唤醒;若等待开始时值已是 1,就再也醒不过来。 某些模块(如 RCQ 环境)依赖它分段执行,于是「启动太快」时后续片段永不执行。 脚本会先扫描模块脚本里有没有这类等待者,有才在重启后主动制造一次 0→1 边沿 (距重启 ≥25 秒,确保等待已开始);没有就只保留「卡 0 太久 → 置 1」的安全网。

  3. 不要把日志放在 /data/local/tmp 某些「隐藏 root / 清理环境」模块会 rm -rf /data/local/tmp/*,脚本和日志一起消失。

  4. 临时 root(如 GhostSam)冷启动后全部丢失 root、模块挂载、脚本进程都会没有,需要重新获取 root 再点一次「执行」。 这是临时 root 的固有行为,不是模块的问题。


六、排错顺序

  1. sh <脚本> check —— 副屏端口(port=147/port=148)、lspd 实例数、 zn-daemon 数量、注入失败数、夜间模式
  2. /sdcard/GS/logs/gs-reload.log —— 哪一步 exit 非 0、卡在哪个阶段
  3. pidof lspd —— LSPosed 是否在跑(只看这个;/proc/net/unix 被改成 440 时 非 root 读不到是正常的)
  4. logcat | grep LSPosedFramework —— 真正的注入证据,形如 (com.tencent.mobileqq:MSF)[...] installed 1 QQ hooks
  5. 副屏不亮且 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。

历史版本

v2.4

最新 v2.4 · 夜间模式:2 分钟复查 + 防拉锯

版本代码 6 v2.4.0

下载

夜间守护第二次收紧:被系统拨回浅色后 2 分钟内纠回。

  • 复查间隔 10 分钟 → 2 分钟:11-13 00:12 com.samsung.android.lool 把判定拨回浅色,旧版要 2 分钟才发现
  • 判据多一层:Twilight 日出日落 → 三星「黑暗模式定时」(display_night_theme_*) → 19:00–07:00 兜底。本机 Twilight 恒为 null,以前只能吃硬编码
  • 防拉锯:30 分钟内被外部改回 5 次即让位 45 分钟,不跟系统例程对打
  • 日志加 源=sun/sched/fallback、zen=、每 30 分钟一次心跳
  • 说明文字精简:module.prop description / module.yaml summary / README 开头

适用:三星 Galaxy Z Fold7(SM-F966B / Android 17)。完整变更见 CHANGELOG。

文件 1

gs_quick_reload-6-v2.4.zip 24.1 KiB

SHA-256 d648ee99e7641171fa3e972df507cf2f85b85f65db0ebd61fdcbd20b5b88ff51 · Attestation

v2.3

v2.3 · 夜间模式修复(Twilight 绝对判据 + 12h 复查)

版本代码 5 v2.3.0

下载

v2.3 —— 夜间模式改成「绝对判据 + 周期复查」(versionCode 5)

修一个会让「日落到日出」整晚不生效的判定缺陷。

  • 根因:v2.1 的守护拿「重启前那一刻的昼夜判定」当基准,重启前若已经是错的,
    纠正逻辑就会把错的当成对的。11-12 20:19 那次:日落 17:11,重启前后都是浅色,
    守护写「判定正确」就收工,整晚没变深色,只能手动重设。
  • 现在:每次从 dumpsys uimode 读 sunrise / sunset(拿不到按 19:00–07:00),
    算出「此刻应该深色还是浅色」,不再参考重启前的值。
  • 重启后 45 秒、90 秒各查一次;之后每 10 分钟复查、持续 12 小时,
    日落/日出两个边界即使系统没生效也会在 10 分钟内被拉回。
  • 你一旦自己改了模式(切成始终浅色/深色),守护立即退出,不跟用户抢。
  • 新增 NIGHT_STEP / NIGHT_SPAN 两个环境变量可调节奏;night 子命令同样改为按 Twilight 判定。
  • 读取 dumpsys 失败的轮次直接跳过,不会因为读不到状态而乱改模式。

文件 1

gs_quick_reload-5-v2.3.zip 23.2 KiB

SHA-256 52fde2fac09d838ee9d24a29cd9509aa0492eeb31d0e7ace576a829ce0dd1dfe · Attestation

v2.2

v2.2 · 三星 Galaxy Z Fold7 专用(Android 17)

版本代码 4 v2.2.0

下载

v2.2 —— 机型定位与系统版本订正(versionCode 4)

修正说明文字:系统实际为 Android 17(One UI 9),面向机型明确为 三星 Galaxy Z Fold7。
脚本逻辑无改动,只改元信息与文档,装了 v2.1 可以不升级。

  • module.prop / module.yaml 的名称改为「一键重载模块(Fold7)」,说明开头即写明
    三星 Galaxy Z Fold7(SM-F966B / One UI 9 / Android 17)专用
  • compatibility.androidMinApi 由 35(Android 15)改为 37(Android 17),
    与文档一致;内核分支名 android15-6.6 是 KMI 命名,与系统版本无关,文档里已注明
  • README 新增「适用机型:三星 Galaxy Z Fold7(专用)」一节,说明实测环境与未实测机型的边界

文件 1

gs_quick_reload-4-v2.2.zip 21.5 KiB

SHA-256 b64553a9fcb1e9f6412dcd984d5bc8adcc7cbf0e55c1071ce9aa141df071820d · Attestation

v2.1

v2.1 初始发布

版本代码 3 v2.1.0

下载

v2.1 —— 初始发布(versionCode 3)

首个公开版本。一个按钮让 KernelSU 模块生效,而不用拿折叠屏的副屏去换。

  • 按 KernelSU 自己的流程执行 post-fs-data / services 两个阶段,然后只 setprop ctl.restart zygote,
    不执行 stop / start,SurfaceFlinger 全程存活,副屏(port=148)不掉
  • boot_completed 看门狗:先扫描模块脚本里有没有 resetprop -w 等待者,有才在重启后制造一次
    0→1 边沿;没有就只保留「卡 0 太久 → 置 1」的安全网
  • lspd 健康检查:三条硬指标(有 daemon、lspbridge 监听 ≥1、pid 不在旧快照)不满足就放弃重启
    zygote,避免「要点两次才生效」
  • 夜间模式自愈:重启后若昼夜判定被改,先顶一个固定值再还原用户原本的模式;trap 保证任何
    退出路径(终端断开 / 进程被杀)都会还原
  • 子命令:check 体检、mods 清单、dump <id> 打包、trim 清理重复实例、night 一条命令还原自动
  • 日志落在 /sdcard/GS/logs/,不需要 root 就能读

作者:CodeFishK。实测环境:GhostSam 临时 root(三星 Z Fold7),
理论上任意 KernelSU / 兼容分支通用。

说明:v1.x、v2.0 是作者本机的内部迭代版本,从未对外发布,故不在此列出。

文件 1

gs_quick_reload-3-v2.1.zip 21.0 KiB

SHA-256 4643bf9379f46514d0d26a4174b06dfd35b371261ead12ebc8ba50cd36e2b954 · Attestation

透明度

Tag
v2.4.0 不可变 Release
Tag commit
2e12e86a5b6a
内容 commit
2e12e86a5b6a
SHA-256
d648ee99e7641171fa3e972df507cf2f85b85f65db0ebd61fdcbd20b5b88ff51
最近同步到变更

自行复核

KernelSU 模块不对模块签名,也不审计模块代码。SHA-256 只证明下载内容与本索引一致。可使用 GitHub CLI 自行复核:

gh release verify v2.4.0 -R CodeFishK/gs-quick-reload
gh release verify-asset v2.4.0 gs_quick_reload-6-v2.4.zip -R CodeFishK/gs-quick-reload