English support is currently suspended
本文档已部分过时
古法（？） CPU 调度：eBPF + Rust + FAS 帧感知调度 + CLG 负载调速器
ChiRi是一个以日用场景为主的Android CPU调度，以流畅度为主，其次是轻度游戏 低功耗并不是主要目标，但并不代表极差的续航水平 中高负载日用场景尚可，游戏差点意思（ 请记住，这不是一个以游戏性能为主的调度。
- CLG - 基于 eBPF 实时负载数据的自适应调频，替代传统内核调速器。
- WebUI - KernelSU 管理器内置界面直接管理调度配置，无需安装额外 App
- 场景特调 - ？！特调？！白名单应用（如明日方舟、视频播放）前台时自动切换专属参数，退出自动还原
- 热更新 - 无需重启设备即可更新调度，详见如何不重启设备更新调度
flowchart TB
subgraph BOOT["安装与开机"]
CUST["customize.sh：安装"]
SH["service.sh：启动"]
WD["看门狗 sh：daemon 退出后自动重启"]
ACT["action.sh：手动重启调度"]
CUST ~~~ SH
SH --> WD
WD ~~~ ACT
end
WD ~~~ KV
subgraph UI["WebUI（KernelSU 管理器 WebView）"]
KV["ksu.* API → shell 命令"]
V["总览 / 配置 / 应用 / 日志<br/>二级页：实验室 / 电池 / 高级"]
KV --> V
end
subgraph FS["模块目录（配置）"]
META["meta.yaml"]
RHINE["rhine.chr"]
DOWNF["down.chr"]
EMBED["编译嵌入：feature / rules / 白名单"]
META ~~~ RHINE
RHINE ~~~ DOWNF
DOWNF ~~~ EMBED
end
subgraph K1["内核（eBPF 采集）"]
SSW["sched_switch tracepoint"]
QB["queueBuffer uprobe"]
TELE["sched_wakeup / sched_migrate_task 探针：遥测计数"]
SSW ~~~ QB
QB ~~~ TELE
end
DOWNF ~~~ SSW
SSW --> LOAD
QB --> FPS
TELE --> SCSV
subgraph DAEMON["chiri 守护进程（Rust）"]
subgraph WATCH["inotify 监听"]
CW["config_watcher：meta.yaml"]
RW["rhine_watcher：rhine.chr"]
DW["down_watcher：down.chr"]
CW ~~~ RW
RW ~~~ DW
end
subgraph MON["监控线程"]
APP["app_detect：前台应用识别"]
LOAD["cpu_monitor：CPU 负载"]
FPS["fps_monitor：FPS"]
SCR["screen_detect：亮灭屏"]
EVT["事件队列 DaemonEvent"]
APP ~~~ LOAD
LOAD ~~~ FPS
FPS ~~~ SCR
APP --> EVT
LOAD --> EVT
FPS --> EVT
SCR --> EVT
end
DW ~~~ APP
DECIDE["调度主循环 scheduler_ipc<br/>FAS 白名单 > 特调 > 应用配置 > 全局"]
subgraph GOV["接管者（互斥）"]
CLG["CLG：reduce / default / boost"]
TUNED["TunedGovernor：akmode / playback"]
FAS["FasManager：PID + 档位状态机"]
LAB["实验室：vector / contingency / babel / frozen"]
CLG ~~~ TUNED
TUNED ~~~ FAS
FAS ~~~ LAB
end
subgraph SIDE["常驻功能"]
TOUCH["touch_detect：触摸升频"]
THERMAL["Thermal：热保护"]
AFF["AffinityManager：线程亲和"]
CC["CoreCtlManager：核心在线"]
FAST["FastLock：极速锁频"]
TWEAK["apply_system_tweaks：cpuidle / IO / cpu_boost / Sched 参数"]
TOUCH ~~~ THERMAL
THERMAL ~~~ AFF
AFF ~~~ CC
CC ~~~ FAST
FAST ~~~ TWEAK
end
subgraph OBS["对外文件与日志"]
CURM["current_mode.chr"]
LIVE["LiveTime.chr"]
PWR["PowerAVG.chr"]
EXP["special_tuned / fas_whitelist 导出"]
MISC["active_config / pf / rhine-back.chr"]
DLOG["daemon.log"]
SCSV["status.csv"]
DEVIMP["devimp：main_ / aff_"]
ARCH["logd/ 归档"]
CURM ~~~ LIVE
LIVE ~~~ PWR
PWR ~~~ EXP
EXP ~~~ MISC
MISC ~~~ DLOG
DLOG ~~~ SCSV
SCSV ~~~ DEVIMP
DEVIMP ~~~ ARCH
end
NT["notify：常驻通知"]
CW --> DECIDE
RW --> DECIDE
DW --> DECIDE
EVT --> DECIDE
TOUCH --> DECIDE
DECIDE --> GOV
DECIDE --> CURM
LAB ~~~ TOUCH
TWEAK ~~~ CURM
ARCH ~~~ NT
end
WD --> DAEMON
KV -- "写" --> META
KV -- "写" --> RHINE
KV -- "写" --> DOWNF
KV -- "读" --> OBS
META --> CW
RHINE --> RW
DOWNF --> DW
EMBED -.-> DECIDE
subgraph K2["内核（写入目标）"]
GOVF["cpufreq：scaling_governor / scaling_max_freq"]
AFFN["cpuset / core_ctl / cpu online"]
UCL["uclamp"]
TWEAKN["cpuidle / IO 调度器 / cpu_boost / Sched 参数"]
PROC["/proc/sys/kernel：sched_migration_cost_ns"]
GOVF ~~~ AFFN
AFFN ~~~ UCL
UCL ~~~ TWEAKN
TWEAKN ~~~ PROC
end
GOV --> GOVF
THERMAL --> GOVF
FAST --> GOVF
AFF --> AFFN
CC --> AFFN
AFF --> UCL
TWEAK --> TWEAKN
FAS --> PROC
classDef boot fill:#e8f5e9,stroke:#43a047,color:#1b5e20
classDef daemon fill:#e3f2fd,stroke:#1e88e5,color:#0d47a1
classDef kernel fill:#ede7f6,stroke:#7e57c2,color:#4527a0
classDef fs fill:#fff8e1,stroke:#fbc02d,color:#5d4037
classDef webui fill:#fce4ec,stroke:#ec407a,color:#880e4f
class CUST,SH,WD,ACT boot
class APP,LOAD,FPS,SCR,EVT,DECIDE,CLG,TUNED,FAS,LAB,TOUCH,THERMAL,AFF,CC,FAST,TWEAK,CURM,LIVE,PWR,EXP,MISC,DLOG,SCSV,DEVIMP,ARCH,NT,CW,RW,DW daemon
class SSW,QB,GOVF,AFFN,UCL,TWEAKN,PROC kernel
class META,RHINE,DOWNF,EMBED fs
class KV,V webui
同一时刻只有一个调度器处于接管状态；切换时先还原上一个调度器写入的频率上限、governor 与核心分组，再由新的调度器接管。不在适配列表的 SoC 不启动调度，只运行监控、WebUI 与日志。
Android 8.0 (API 26) 及以上 ARM64 (AArch64) 并拥有 Root 权限
内核支持 eBPF（需要 CONFIG_BPF、CONFIG_BPF_SYSCALL 等内核选项）和 schedutil 调速器
ChiRi 提供以下模式：
| 模式 | 描述 | 启用场景 |
|---|---|---|
| scenemode | 树懒模式，尽可能降低功耗 | 暂不支持手动启用 |
| reduce | 降低响应，延长续航 | 待机、轻度使用 |
| default | 自适应调频，平衡 | 万金油 |
| boost | 高响应配置，性能优先 | 中高负载 |
| 特调 | 白名单应用专属参数组 | 前台命中白名单自动触发 |
| FAS | 帧时间间隔感知 | FAS 白名单内的游戏 |
ChiRi CLG 调度核心，使用白名单适配soc 已适配soc列表 没有你的soc或功能适配不完全？当前处于早期测试阶段，正在增加soc适配 不支持的 SoC 不接管 CPU（仅监控/WebUI/日志） 不支持部分特调的soc会回退到CLG模式
- 高性能 Rust 实现: 极低的系统资源占用，运行功耗极低。
- eBPF 内核级监控: 通过
sched_switchtracepoint 精确采集每核心 CPU 利用率和线程运行时间；通过queueBufferuprobe 捕获渲染帧间隔（只在 FAS 或播放态挂载，平时零开销）。 - 实时配置监听: meta.yaml 改完即时生效，不用重启；调优参数和白名单都编译在二进制里，改它们要重新编译。
- 内置 FAS 引擎: PID 控制器驱动的帧感知调度，支持自动容量权重探测、per-app 配置、CPU 利用率辅助调频。
- CLG 负载调速器: 基于 eBPF 实时负载的自适应调频，替代内核原生调速器。
- 多语言国际化: 基于 Fluent 的 i18n 系统，支持中英文日志输出。
default 模式覆盖大部分场景。 特调白名单里的应用（明日方舟、哔哩哔哩等）前台时自动切换专属模式，不用手动操作。
FAS 白名单内的游戏（明日方舟：终末地、王者荣耀等）前台时会自动进入帧感知调度，不用手动切。 白名单外的游戏用 default 模式，性能不足时切换到 boost 模式。 请谨慎使用 vector 模式，此模式下 CPU 频率可能会锁定为最大（实验室功能，需手动启用）。
待更新
- QQ群 - 1091201364
- GitHub Issues - 项目问题和建议
| Project | License | Repository | Platform |
|---|---|---|---|
| imacte/yumi | GPL v3.0 | GitHub | ALL |
| Sutoliu/AppOptR | GPL v3.0 | Gitee | ALL |
| android-common | Apache License 2.0 | Google Source | ALL |
| android-gs-caimito-6.1-android15-qpr1 | Apache License 2.0 | Google Source | part |
| kdrag0n/freqbench | MIT | GitHub | part |
| kerneltoast/freqbench | MIT | GitHub | part |
| OnePlusOSS/android_kernel_oneplus_sm8475 | GPL-2.0 WITH Linux-syscall-note | GitHub | SM8475 |
| torvalds/linux | GPL-2.0 WITH Linux-syscall-note | GitHub | SM8550 |
| AYNTechnologies/linux | GPL-2.0 WITH Linux-syscall-note | Github | SM8550 |
| OnePlusOSS/android_kernel_oneplus_sm8550 | GPL-2.0 WITH Linux-syscall-note | GitHub | SM8550 |
| OnePlusOSS/android_kernel_oneplus_sm8650 | GPL-2.0 WITH Linux-syscall-note | GitHub | SM8650 |
| OnePlusOSS/android_kernel_oneplus_sm8750 | GPL-2.0 WITH Linux-syscall-note | GitHub | SM8750 |
| Title | Contributors | Patch |
|---|---|---|
| [PATCH 07/10] arm64: dts: qcom: sm8550: Update EAS properties | Xilin Wu wuxilin123@gmail.com | Patchew |
| Project/Resource | License | Link |
|---|---|---|
| LittleYouran_CTS_3 | GPL v3.0 | GitHub |
| socpk | socpk | |
| nanoreview.net | nanoreview | |
| GSMArena | gsmarena | |
| Wikipedia | CC BY-SA | wikipedia |
| Timisy_小添 | bilibili |
| Font | License | Repository | 使用位置 / 注册名 |
|---|---|---|---|
| Poppins | SIL OFL 1.1 | GitHub | WebUI 拉丁字母与数字 |
| Noto Sans SC（思源黑体） | SIL OFL 1.1 | GitHub | WebUI 中文 |
| JetBrains Mono | SIL OFL 1.1 | GitHub | 全部等宽文本 |
ChiRi - 千漓