# ChiRiScene
**Repository Path**: Aibeto/ChiRiScene
## Basic Information
- **Project Name**: ChiRiScene
- **Description**: ChiRi 千漓调度
- **Primary Language**: Rust
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-18
- **Last Updated**: 2026-10-23
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[Read this document in English](README.en.md)
> English support is currently suspended
> 本文档已部分过时
# ChiRi 调度
**古法（？） CPU 调度：eBPF + Rust + FAS 帧感知调度 + CLG 负载调速器**
---
## 项目介绍
**ChiRi**是一个以日用场景为主的Android CPU调度，以流畅度为主，其次是轻度游戏
低功耗并不是主要目标，但并不代表极差的续航水平
中高负载日用场景尚可，游戏差点意思（
请记住，这不是一个以游戏性能为主的调度。
## 基石
- 模块 fork 自 [yumi](https://github.com/imacte/yumi)，部分核心代码来自上游（上游调度兜底已移除，非目标 SoC 不接管 CPU）。
- 线程调整功能有部分参考了 [AppOptR](https://gitee.com/sutoliu/AppOptR) 。
### 主要特性
- **CLG** - 基于 eBPF 实时负载数据的自适应调频，替代传统内核调速器。
- **WebUI** - KernelSU 管理器内置界面直接管理调度配置，无需安装额外 App
- **场景特调** - ？！特调？！白名单应用（如明日方舟、视频播放）前台时自动切换专属参数，退出自动还原
- **热更新** - 无需重启设备即可更新调度，详见[如何不重启设备更新调度](/mdocs/updateWithoutRestart.md)
## 架构
```mermaid
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["总览 / 配置 / 应用 / 日志
二级页：实验室 / 电池 / 高级"]
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
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列表](/mdocs/socList.md)
没有你的soc或功能适配不完全？当前处于早期测试阶段，正在增加soc适配
不支持的 SoC 不接管 CPU（仅监控/WebUI/日志）
不支持部分特调的soc会回退到CLG模式
#### 核心特性
- **高性能 Rust 实现**: 极低的系统资源占用，运行功耗极低。
- **eBPF 内核级监控**: 通过 `sched_switch` tracepoint 精确采集每核心 CPU 利用率和线程运行时间；通过 `queueBuffer` uprobe 捕获渲染帧间隔（只在 FAS 或播放态挂载，平时零开销）。
- **实时配置监听**: meta.yaml 改完即时生效，不用重启；调优参数和白名单都编译在二进制里，改它们要重新编译。
- **内置 FAS 引擎**: PID 控制器驱动的帧感知调度，支持自动容量权重探测、per-app 配置、CPU 利用率辅助调频。
- **CLG 负载调速器**: 基于 eBPF 实时负载的自适应调频，替代内核原生调速器。
- **多语言国际化**: 基于 Fluent 的 i18n 系统，支持中英文日志输出。
## 性能优化建议
### 日常使用
default 模式覆盖大部分场景。
特调白名单里的应用（明日方舟、哔哩哔哩等）前台时自动切换专属模式，不用手动操作。
### 游戏优化
FAS 白名单内的游戏（明日方舟：终末地、王者荣耀等）前台时会自动进入帧感知调度，不用手动切。
白名单外的游戏用 default 模式，性能不足时切换到 boost 模式。
请谨慎使用 vector 模式，此模式下 CPU 频率可能会锁定为最大（实验室功能，需手动启用）。
## 故障排除
### 常见问题
待更新
## 项目统计
## Star History
ChiRi - 千漓