安装与升级

环境要求

• 已安装 Magisk、KernelSU、APatch 或兼容方案
• 使用 WebUI 需支持模块 WebUI 的管理器（如 KernelSU / SukiSU / APatch 系 / MMRL / WebUI-X）
• 伴侣 APP 需 Android 8+（minSdk 26），读写模块需 Root

该下哪个？先看这三句

1. 多数人：只下 QSC-Battery_v<版本>-full.zip 刷入即可（双守护 + WebUI，也可选装内嵌伴侣 APP）。管理器「检查更新」也是拉这个。
2. 只要核心停充、包越小越好：下 -lite.zip（无 WebUI、无内嵌 APK、无守护）。
3. Release 里的 QSC-Battery_v*.apk、qscd-*：一般不用单独下——APK 可在刷非 lite 模块时选装，守护可由 full 自带或之后在 WebUI / APP 里装。

下面按文件类型说明；不确定时选 full。

Release 文件一览

每个正式版在 GitHub Releases 里大致包含三类资产。

1. 模块 zip（刷进 Magisk / KernelSU）

文件名	自带守护	WebUI	内嵌 APK	适合谁
…-full.zip	Rust + C	有	有（可选装）	推荐默认；装完即用，安装时自检挑一套守护
…-rust.zip	仅 Rust	有	有	明确只要 Rust 守护（阈值过滤 / 原生进程检测等）
…-c.zip	仅 C	有	有	明确只要更轻量的 C 守护
…-sh.zip	无	有	有	想先装界面，守护以后在 WebUI 再下
…-lite.zip	无	无	无	只要脚本停充；用 APP / qsc.sh / 改配置文件

说明：

• 守护仅 arm64 / armv7；其它 CPU 可跳过守护，停充仍可用。
• Rust 与 C 只能二选一（行为不完全相同：Rust 版额外提供阈值事件过滤与原生进程检测，C 版更轻量）；full 安装时按配置自检选用其一。
• -sh / -lite 刷入时可询问联网下载守护；失败不中断安装。lite 无 WebUI，之后可用伴侣 APP 或 CLI 管理守护。
• 带 -debug 后缀的是调试包（多测试脚本），日常不要用。

2. 伴侣 APP

文件名	作用
QSC-Battery_v<版本>.apk	独立安装的 Compose 客户端（状态 / 策略 / 动态 / 主题等）

• 非 lite 的模块 zip 可能已内嵌同款 APK；默认安装会直接装，自定义安装仍可用音量键选择。
• 已装过 APP、或不想用 APP：可忽略这个文件。
• APP 自身更新走独立通道（app-update.json），与模块 zip 更新分开。

3. 事件守护二进制（qscd）

文件名	作用
qscd-rust-arm64 / qscd-rust-arm	Rust 版守护（64 / 32 位）
qscd-c-arm64 / qscd-c-arm	C 版守护（64 / 32 位）

• 普通用户不必手动下载。-full 已带齐；-sh 可在 WebUI「事件唤醒」里下载；也可由发版托管到文档站供模块内拉取。
• 只有在手工替换、离线拷贝、或排查安装问题时，才需要从 Release 取这些单文件。
• 它们不是 Magisk 模块：不能当 zip 刷；需放到模块的 bin/qscd 并由配置启用。

安装步骤

1. 从 GitHub Releases 按上表选一个 模块 zip（推荐 -full）
2. 在模块管理器中刷入
3. 选择安装方式（约 20 秒；超时 → 默认安装）
   • 音量上 · 默认安装（推荐）：全量组件；有旧配置则保留核心项；不联网下守护
   • 音量下 · 自定义安装：逐项选择（配置 / WebUI / 电流控制 / 守护 / 伴侣 APP）
4. 重启（热更新成功时可免重启）
5. 用 WebUI / APP / config.conf 调整；见 WebUI、APP

无人值守（/data/adb/qsc/install_auto 或 QSC_NONINTERACTIVE=1）：跳过音量键，仍按原先安全默认（装 WebUI/电流控制、保留核心配置、不下守护、不装伴侣 APP）。

Action 按钮

• 音量上（或超时）：刷新状态
• 音量下：已插电 → 快速测开关；未插电 → 诊断报告 /sdcard/qsc_diagnose.txt

完整测开关也可：sh .../bin/qsc.sh test-switch 或 bin/test_switch.sh（须插电）。

在线更新

module.prop 配置了 updateJson，管理器默认拉 -full 包。升级会尽量保留已下载的守护。APP、守护有独立通道，见 伴侣 APP。

更新配置怎么处理

• 默认安装：有旧配置则自动保留核心停充项，省电用新版默认
• 自定义安装 / 检测到已装时再问：
  • 音量上：保留核心配置（停充等），省电间隔用新版默认
  • 音量下：全部用新版默认
  • 超时：保留核心配置

曾改过省电间隔想继续用旧值：更新后到 WebUI「省电策略」改回即可。

自定义安装会再问 WebUI / 电流控制 / APK / 守护；默认安装不再逐项询问。

从旧版模块升级

显示名 充电控制，id QSC_Battery。

若仍装有下列旧版，本版会自动卸载且不迁移配置：

显示名	模块 id
QSC定量停充	QuantitativeStopCharging
QSC定量停充_独立开关版	QuantitativeStopCharging_switch

请安装后重新设阈值。

热更新说明

支持免重启热更新（管理器 / APP 安装模块时）。失败会回退到需重启的标准更新。诊断与临时文件可能位于 /data/adb/qsc/（更新完成后清理）。细节见 WebUI 文档「热更新」小节。

卸载

在模块管理器卸载即可。软关闭不必卸载：WebUI / APP / qsc.sh off 写 data/module_off。