Android 应用/游戏线程 CPU 亲和性优化工具，以 Magisk/KernelSU 模块形式运行。

总的来说，这是本人的第二个开源的RUST作品吧，也是一个极具我个人风格的作品呢 emm...艇长猫猫还是很喜欢大家的使用哒～使用艇长是俺的荣幸哦～ 项目会不断更新，有啥问题可以去issues(虽然猫猫不咋看啦)提交，不过最好的方法还是直接去俺群里把俺艾特出来～千万不要直接骂艇长唔，猫猫很怕凶的(哭哭) 猫猫虽然平时很深情，但代码是认真的！请见俺的README～

=======

预打包的 out/*.zip 已内置编译好的 eBPF 程序（ebpf_target.o），普通用户刷入即可，无需构建环境。

修改 ebpf/ 下的 BPF 源码后需在 WSL（Ubuntu 发行版）中重编译：

• WSL 内安装 Rust nightly：rustup toolchain install nightly（建议配置国内镜像 RUSTUP_DIST_SERVER=https://rsproxy.cn）
• 需要 Android clang（如 ~/kernel/bin/clang19，提供 LLVM 库），或安装 llvm 系统包

export PATH="$HOME/.cargo/bin:$PATH"
export LLVM_SYS_190_PREFIX="$HOME/kernel/bin/clang19"
cd ebpf
cargo +nightly build --target bpfel-unknown-none --release -Zbuild-std=core
cp target/bpfel-unknown-none/release/aether-ebpf ../ebpf_target.o

或直接运行 scripts/wsl_ebpf_build.sh。

# 一键编译 + 打包
python build.py

# 输出
out/Aether-OptExt_YYYYMMDD_HHMMSS.zip

• Rust
• Android NDK（自动检测 $ANDROID_NDK_HOME）
• 编译目标: rustup target add aarch64-linux-android

Magisk / KernelSU 中刷入 out/Aether-OptExt_*.zip 即可。

{
  "features": { "ebpf": true, "auto-for-none": true },
  "rules": [
    {
      "friendly": "原神",
      "packages": ["com.miHoYo.Yuanshen"],
      "cpuset": {
        "other": "0-5",
        "comm": {
          "6-7": ["UnityMain", "UnityGfxDeviceW"],
          "0-5": ["NativeThread"]
        }
      }
    }
  ]
}

• features.ebpf — 启用 eBPF 加速（需内核支持）
• features.auto-for-none — 启用自动分配缓存
• features.foreground — 前台感知（默认 true）：缓存后台进程（oom_score_adj >= 900）自动收缩到能效核，回前台恢复配置目标；仅作用于包级 other，线程规则不受影响
• features.load_aware — 动态负载感知（默认 true）：按 /proc/{tid}/stat 的 tick 增量实测线程占用率，高负载并入超大核、空闲收缩到能效核，仅作用于包级 other
• features.blacklist — 用户黑名单（默认空数组）：列入的包名完全不受控，不绑核、不纳入自动分配缓存、不注入 eBPF 白名单、不发 fg_hint 信号，优先级高于一切规则；含 :suffix 的进程按其基础包名判定
• features.render_guard — 渲染安全护栏（默认 true）：① 渲染管线线程（RenderThread/Gfx/Vulkan/RHI/Surface 等）若被配到与性能核无交集的集合，自动升档到 {hp_core}/{p_core}；② 绑核目标少于 2 核时拒绝并回退（单核在负载波动下易饿死线程，触发 fence 超时黑屏）。降级动作会写入 safety: 日志
• features.min_cpus — 包级最小核数（默认 4）：包级 other 目标核数不足时，按 {p_core} → {hp_core} → 全在线核顺序并入，避免多线程应用全挤在小核上导致卡顿；设为 1 禁用。仅作用于包级 other，用户手写的线程规则不扩充
• other — 该应用所有线程的默认绑核
• comm — 按线程名匹配的绑核规则（支持 * 通配符）

挂载 sched/sched_process_exec tracepoint，新进程执行时 BPF 程序在纳秒级将 PID 写入 HASH map。主循环每轮读取 map 获取新进程，先于 /proc 扫描发现。需内核支持以下配置：

CONFIG_BPF_SYSCALL=y
CONFIG_BPF_EVENTS=y
CONFIG_KPROBE_EVENTS=y
CONFIG_PERF_EVENTS=y

通过 features.ebpf: true/false 控制。

注：若内核使用 Android Vendor Hooks（CONFIG_ANDROID_VENDOR_HOOKS=y），BPF map 创建可正常进行，但 bpf_perf_event_output 等高级功能受限，程序自动回退 /proc 轮询。

当配置文件中未收录某个用户应用时，自动扫描其线程，按线程名估算负载后分配核心，保存到 /sdcard/Android/Aether/threads_cache，下次启动自动合并到规则集。

负载分级：

通过 features.auto-for-none: true/false 控制。

规则中的 cpus 使用语义占位符，安装时按设备拓扑自动展开为实际核号，无需为每种 CPU 规格单独写配置：

层级命名惯例大核在前：1+3+4 = 超大核 1 + 大核 3 + 小核 4。2 层 SOC 时 {p_core} 展开为空（无中核可绑），1 层时 {hp_core} 回退到 {e_core}。

缓存按包名去重，已知系统包名（com.miui.*、com.xiaomi.*、vendor.* 等）被自动过滤。模块更新时清除旧缓存。

设备安装 asoul 模块（/data/adb/asoul_affinity_opt 存在）时，自动读取 /sdcard/Android/Aether/gamelist（默认 316 个游戏包），名单内包名完全豁免：不匹配规则、不自动分配、不绑核，与 asoul 互不干扰。gamelist 可直接编辑增删。

绑核规则按 calculate_rule_priority 算法排序，每个线程取优先级最高的匹配：

安装时通过 cpufreq policy 目录自动检测 CPU 集群分布（支持 1/2/3/4 层 SOC），将 threads.json 中的语义占位符展开为实际核号，生成 /sdcard/Android/Aether/threads.json：

• 最低频组 → {e_core}（小核）
• 中间组 → {p1_core} / {p2_core}（中核/大核，2/3 层时相应为空）
• 最高频组 → {hp_core}（超大核）

同一套模板自适应任意 CPU 规格，无需按拓扑维护多份配置文件。auto-for-none 自动分配同样按 4 层分级（big/mid1/mid2/little）绑定。

GPL-3.0