Specter启动流程与完整性流水线解剖:详解action.sh与调度器
Specter启动流程与完整性流水线解剖:详解action.sh与调度器
Specter 是一款面向 Android 根权限设备的统一 Play Integrity 与 root 隐藏模块。本文带你完整拆解 Specter 的启动流程:从安装阶段的 customize.sh、开机的 service.sh,到核心的完整性流水线 action.sh 和后台调度器 scheduler.sh,理解每一步在做什么、日志在哪里看。
🧩 Specter 是什么
Specter 定位为一个"干净、专注、无冗余"的完整性工具栈(模块信息见 module.prop):
- Keybox 管理:多来源目录、自定义 keybox、Google 吊销检查、备份/恢复
- Auto Target:通过 inotify + 轮询自动发现新安装的应用
- 安全补丁 / ROM 指纹 / ADB 禁用 / PIF 变体处理 等一键功能
- WebUI:浏览器内的完整控制面板
- 调度器:周期性刷新 keybox 信息、自动定向、自动 PIF
它需要 Magisk / KernelSU / APatch 之一提供 root,并依赖 Tricky Store、TEESimulator(或 RS 版)或 OhMyKeymint 提供 keystore 后端,再配合 Play Integrity Inject / Fork 工作。
整个模块的入口脚本都集中在 src/ 目录,这也是本文解剖的范围:
| 脚本 | 触发时机 |
|---|---|
| customize.sh | 安装 / 更新时 |
| post-fs-data.sh | 开机早期(文件系统就绪后) |
| service.sh | 开机服务启动阶段 |
| action.sh | 首次开机 / WebUI 手动 / 热更新 |
| lib/scheduler.sh | service.sh 之后常驻后台 |
📦 安装阶段:customize.sh 做了哪些准备
customize.sh 运行在 root 方案的安装器环境中,相当于 Specter 的"出厂装配线":
- 环境探测:识别 root 方案(Magisk / KernelSU / APatch)、Zygisk 变体,并打印 Tricky Store / TEESimulator / OhMyKeymint / PIF 的检测结果,见 customize.sh#L18-L60。
- 自动补齐后端:如果检测不到任何 keystore 后端,会自动安装 TEESimulator-RS,省去手动步骤,见 customize.sh#L70-L81。
- 打首次开机标记:
touch .first_boot_pending,告诉下一次开机"需要跑一遍完整初始化",见 customize.sh#L84-L86。 - 部署 inotifyd:按 CPU 架构(aarch64 / armv7l / x86_64 / i686)选择对应的 inotifyd 二进制并赋权限,这是后续"新装应用秒级定向"的基础,见 customize.sh#L99-L113。
- KernelSU 热更新:在 KernelSU 环境下更新已安装模块时,可跳过重启直接"活体应用",失败则提示从 WebUI 手动运行
action.sh,实现见 lib/hotinstall.sh。
💡 注意:安装阶段不做完整性流水线的实际工作,它只做准备。真正的"重活"留到首次开机。
🔀 开机早期:post-fs-data.sh 与冲突处理
post-fs-data.sh 非常短,只做两件事:detect_root_solution 识别 root 方案,然后 resolve_conflicts 处理模块冲突。
冲突处理策略定义在 lib/conflicts.sh,针对 8 类重叠模块分三档:
- 激进(aggressive):100% 功能重叠,直接卸载对方模块
- 中度(moderate):重命名禁用对方的 action 脚本,Specter 接管全部功能
- 被动(passive):部分重叠,默认让出功能、与对方共存
这套机制保证后续流水线执行每个功能前都能先"确认领地"——判断逻辑就是 _feature_should_run,见 lib/conflicts.sh#L40-L47:先查 WebUI 里的功能开关,再查是否被其他模块"认领"。
🚀 开机主流程:service.sh 的引导任务
service.sh 是每次开机的"总指挥",按顺序完成:
- 消费首次开机标记:发现
.first_boot_pending后立即删除(防止崩溃残留),并记录本次为首次开机,见 service.sh#L9-L10。 - 配置迁移:把旧版散落的
.val配置迁入val/子目录,并按改名表更新键名(如kb_provider→keybox_provider),老用户升级无缝衔接,见 service.sh#L20-L45。 - 写入开关默认值:所有
toggle_*开关有内置默认值(定义在 lib/constants.sh),首次运行自动落盘。 - 运行开机特性:
adb_disabler、rom_fingerprint、pif_props、crom_props逐个执行,每个都有独立日志boot_*.log,见 service.sh#L50-L56。 - 首次开机初始化:调用 features/first_boot_setup.sh,先备份 keybox / 目标列表 / 安全补丁等原文件,等网络就绪(最多 10 秒),然后以
SPECTER_FIRST_BOOT=1触发完整流水线,见 first_boot_setup.sh#L49-L54。 - 拉起调度器:若
toggle_scheduler开启,后台启动scheduler.sh并记录 PID,见 service.sh#L78-L81。
所有输出写入 log/boot.log(自动轮转),这是排查"开机到底做了什么"的第一站。
⚙️ 完整性流水线核心:action.sh 逐段解剖
action.sh 是 Specter 的心脏——"Full integrity pipeline"。它有三个触发入口:首次开机(由 first_boot_setup 带着标记调用)、WebUI 手动点击 Action、KernelSU 热更新后自动执行。
第 0 步:确定"是否首次开机"
SPECTER_FIRST_BOOT=1 环境变量或 .first_boot_pending 文件任一存在即视为首次开机,见 action.sh#L28-L30。这个标记决定了几处行为差异,下文会提到。
五个流水线阶段
每个阶段都由 _feature_should_run 守门——功能开关关闭或功能被冲突机制让出时整段跳过,见 action.sh#L35-L101:
| 阶段 | 脚本 | 做什么 | 首次开机差异 |
|---|---|---|---|
| Play Store 清理 | features/kill_play_store.sh | 强杀 DroidGuard / GMS 进程、可选清除商店数据 | 跳过清数据,保护刚装好的登录态 |
| 应用定向 | features/target.sh | --merge 模式合并目标列表,写入 keystore 后端 |
无差异 |
| 安全补丁 | features/security_patch.sh | 在线拉取最新安全补丁,离线时用内置兜底 | 无差异 |
| Keybox | features/keybox.sh | 按配置的来源获取/写入 keybox | 无差异 |
| Play Integrity Fix | features/pif.sh | 检测 PIF 变体、拉取指纹、屏蔽伪造引擎 | 见下文 |
PIF 阶段是最"智能"的一段,逻辑见 action.sh#L63-L101:
- 没装 PIF:首次开机直接静默跳过;终端交互时提示"按音量上键安装、下键跳过"(10 秒超时);
- 已装 PIF 且首次开机:先用
_pif_validate_fingerprint校验现有指纹是否为有效的 Google release-keys 格式(action.sh#L14-L26),有效则跳过抓取,无效才重新拉取。
收尾三件事
流水线尾部依次执行:刷新设备信息缓存、刷新 keybox / keystore 状态信息(供 WebUI 展示)、恢复 module.prop.bak 并刷新模块描述行。非首次开机还会追加一条 JSON 记录到 log/history.jsonl,供 WebUI 的"历史"页面回放,见 action.sh#L103-L117。
整个过程用 tee -a 双写到 log/action.log,所以你在 WebUI 终端里看到的每一行,都能在日志文件里找到对应。
⏰ 后台调度器:scheduler.sh 如何保持状态常新
安装完成不是终点——root 隐藏是"持续作战"。lib/scheduler.sh 由 service.sh 后台拉起,职责是周期性刷新 + 事件驱动两条线:
任务表(每 57 秒巡检一次)
| 任务 | 脚本 | 默认间隔 | 作用 |
|---|---|---|---|
| keybox_info | keybox_info.sh | 6 小时 | 刷新 keybox 状态供 WebUI 展示 |
| auto_target | auto_target.sh | 5 分钟 | 轮询兜底发现新装应用 |
| autopif | pif.sh | 1 天 | 定期重新校验 PIF 指纹 |
| autokeybox | keybox.sh | 1 天 | 定期轮换 keybox |
任务表见 scheduler.sh#L67-L96。每个任务都有独立开关(toggle_*)和可自定义间隔(${任务名}_interval,最小 10 秒),上次运行时间戳记录在 scheduler_tasks/ 目录,任务日志单独存为 log/sched_*.log。
事件驱动:inotifyd 监听
/data/app目录:新应用一落盘就触发auto_target.sh定向,实现"装完即隐藏",见 scheduler.sh#L34-L55;- 壁纸目录:壁纸更换时运行
monet.sh,为新主题生成 Monet 色值配置。
调度器启动时会检查 PID 文件防止重复拉起(scheduler.sh#L18-L29),退出时通过 trap 清理 PID 与 inotify 处理器。
📊 日志地图:出问题时先翻哪里
| 日志文件 | 内容 |
|---|---|
log/boot.log |
每次开机的 service.sh 全量输出 |
log/action.log |
每次完整流水线的执行记录 |
log/boot_*.log |
各开机特性(adb_disabler、rom_fingerprint 等)单独输出 |
log/sched_*.log |
调度器各任务单独输出 |
log/history.jsonl |
结构化执行历史,WebUI"历史"页直接渲染 |
WebUI 内置终端页(webroot/js/terminal.ts)可按 action / boot / 调度等分类实时查看,配合 features/export_logs.sh 一键导出完整日志包用于排查。
❓ 新手常见疑问
Q1:为什么首次开机会跳过商店清数据? 首次开机刚完成登录与购买信息初始化,立即清除会触发重复生物识别验证;流水线在后续手动 Action 中才会启用完整清理。
Q2:调度器任务可以全关吗?
可以。toggle_scheduler 总开关关闭后不再拉起调度器;单个任务(如 autokeybox 默认就是关闭的)也可在 WebUI 里独立控制。
Q3:action.sh 失败会中断整个流水线吗?
不会。每个阶段都带 || true 容错,单点失败只记录错误日志,其余阶段照常执行,最终仍会完成模块描述刷新与历史记录。
📚 获取源码与延伸阅读
git clone https://gitcode.com/gh_mirrors/specter9/specter
- 完整功能与依赖说明:README.md
- 更新历史:changelog.md
- 模块路径与冲突清单:config/conflicts.txt
- WebUI 多语言资源:webroot/lang/zh.json
理解完 customize.sh → post-fs-data.sh → service.sh → action.sh → scheduler.sh 这条主线,你基本就掌握了 Specter "装得好、开得快、守得住" 的全部设计逻辑。🔍