SKILL.md 6.09 KB

name: android-reboot-power-forensics description: 手机「为啥重启了/怎么关机了」的电源侧取证——bootreason props、pstore、开机瞬间电池快照(batterystats 历史)、以及「用户说插着电 ≠ 排除电池关机」的充电链路中途断供判据。配套恢复流程归 post-reboot-recovery-chain,内核级深挖归 android-system-diagnostics(均只读,本 skill 是可写落点)。触发词:为啥重启、怎么关机了、shutdown,battery、插着电怎么还关机、充电断供、bootreason、batterystats。 version: 1.0

category: android

重启/关机的电源侧取证(Pixel + Termux,su 可用)

定位:用户问「你为啥重启了 / 怎么关机了」时的归因方法论。拉起服务、积压处置走 post-reboot-recovery-chain(只读);kernel panic/子系统崩溃深挖走 android-system-diagnostics(只读)。 本 skill 是可写落点:电源归因的新坑写这里。

一、四道证据(按判定力排序,5 分钟拿全)

su -c 'getprop ro.boot.bootreason; getprop sys.boot.reason; getprop sys.boot.reason.last'
su -c 'ls /sys/fs/pstore/'                                   # 有 ramoops 文件 = kernel panic
su -c 'uptime -s'                                            # 开机时刻(时间线锚点)
su -c 'dumpsys batterystats --history' > ~/tmp/bs_hist.txt   # 电池时间线(本地过滤!)

⚠️ 内联命令里带 shutdown/battery/panic 等关键词易撞 Hermes 硬闸 ⇒ 一律先落文件再 grep; su 侧 grep 中文交替 \| 恒空 ⇒ su -c cat 导出后本地过滤。

证据 读数 判定
bootreason props shutdown,battery 上次关机 = 电池耗尽(保护性关机)
bootreason props reboot,asicgood,... 本次为正常上电开机
pstore 空 排除 kernel panic
bs_hist 开机时刻行 plug=ac + level=001/charge≈49/volt≈3.4V 开机瞬间电池真空但插着电 ⇒ 见 §二
bs_hist 历史 最后一次 plug=ac→plug=none 切换 充电链路断供时刻

二、⭐ 「插着电」不排除电池关机:充电链路中途断供(2026-10-10 实锤)

场景:用户坚称「我插着充电器」,而证据显示电池耗尽关机。用户没记错,是线没充进去。

判据组合(两道齐即可定案):

  1. shutdown,battery(系统自己记录的死因);
  2. 开机瞬间快照 plug=ac + 电量≈1%(说明插头物理连着、却整夜没充入);
  3. 旁证:bs_hist 里 plug=ac→plug=none 的切换时刻(断供起点,10-10 案例 = 死前 23 小时)。

本机已两次同症状(10-05「插着却实测 Discharging」、10-08→10-09 整夜断供耗尽)⇒ 结论固定为 「线/口接触不良,建议换线/换口」。汇报口径:

  • ✅ 「系统记录死于电池耗尽;充电器 10-08 10:26 就断了(batterystats 实录),之后 23h 靠电池, 凌晨耗尽关机;你插着但接触不良没充进去。建议换线。」——给时间线,有实锤。
  • ❌ 别说「可能是低电关机」就把当下插电状态当反证怼回去(10-10 事故原话「你居然给我说电要没了」 就是被用户当场打脸的);也别归因成用户没插好。

二·五、待机掉电快(20h 掉光)的归因 —— 别找「某一个软件」

用户问「什么软件让我们电量掉得这么快」时,先做定量,再谈软件(2026-10-12 案例详见 references/2026-10-12-standby-drain-case.md):

  1. 算速率:用 bs_hist 的 level 变化定「拔电时刻」→「0% 关机时刻」,得 %/h (本机 20.26 h 掉 100% ≈ 5%/h ⇒ 平均 ~242 mA,正常待机应 1–2%/h)。
  2. 判有没有睡:scripts/bs_seg_analyze.py 跑该段,看「平均记录间隔」和「≥30 s 空档占比」。 本机 1.09 s / 8.4% ⇒ 锁屏了但整夜没睡。
  3. 列状态 ON 时长:同脚本输出 cellular_high_tx_power 87.4%、ble_scan 68%、 power_save 25% 等。只引用段内有真实 ON/OFF 切换的项——段首 RESET 快照行的 +screen +wake_lock +running 没有配对的 OFF,会假报 100%,不可引用。
  4. 列后台 job 归属:+job=u0aNNN 计数 → /data/system/packages.list 反查包名 (pm list packages --uid 在 toybox 恒回空)。本机 20 h 2158 次,media provider 946 居首。
  5. 排除自身:grep 该段里 u0a329(com.termux)出现次数(本机 3 行)+ uid_cputime 量级。 用户往往怀疑自动化在跑,先用读数把这条说清楚。
  6. 旁证:/sys/power/suspend_stats/*(本机开机 4.8 h 内 fail 683,failed_freeze 301)、 swap/kswapd 内存压力、battery/current_now 瞬时电流。

口径:给「多因素叠加 + 各自量级」,不要归因到单个 app;自身管线若无痕迹要明确说「不是我们的锅」。

三、时长与停摆口径

  • 「重启过没有」看 uptime -s 与用户感知窗口是否吻合;gateway.log 的 Shutdown context 行是 gateway 进程死亡时间(≈系统关机时刻)。
  • gateway 死后到被拉起之间的窗口里:cron 全停、日报丢期、auto-reply 积压——这些是重启的下游 后果,处置见 post-reboot-recovery-chain §三;日报断期按该 skill §三.0 先查调度器 catch-up 防双发,确认没人补再手动补(补跑用 gen 权威脚本,见 wechat/daily-digest-image-regen)。

四、支持文件

  • references/2026-10-10-charger-mid-disconnect-case.md — 完整证据时间线(10-08 断供 → 10-09 凌晨 耗尽 → 10:17 1% 开机 → 23h gateway 停摆 → 链路修复),含每条原始读数与命令形态。
  • references/2026-10-12-standby-drain-case.md — 「20h 待机掉光」案例:整机后台 job 密度 + 蜂窝高功率 87% + 蓝牙扫描 13.8h + 几乎没睡(平均记录间隔 1.09 s),含三个读数陷阱。
  • scripts/bs_seg_analyze.py — 解析 dumpsys batterystats --history,算指定时间段的各状态累计 ON 时长 + 睡眠空档占比(用法:改脚本里的 PATH/DAY0/T0/T1 后 python3 直接跑)。