feat(设备): 电量显示(大屏 + 监控页)+ 低电量 webhook 告警

需求:大屏和监控页都要能看到每台设备的电量,并且"低于多少电量就发通知"。

数据从哪来:`adb -s <serial> shell dumpsys battery`(**只读**,实测 0.2~0.35s/台,
11 台并发一轮 0.44s)。设备只要在 `adb devices` 里就说明 transport 现成,
**不需要 connect**——所以连空闲设备也能查。这是本模块敢每轮扫全量的前提,
也是这条只读路径与"空闲设备不主动 connect"红线(DEVELOPMENT.md §2 #3)的边界,
已写进文档免得后人误加 connect。

- core/device_battery.py(新):后台 daemon 线程 `device-battery`(照 device_discovery
  的 init_app/shutdown 模式),默认 60s 一轮,采「设备池 ∩ 在线」(与 list_ready 同口径,
  adb 可见但不归平台管的设备不上屏也不告警)。
  · 结果**只放内存**(不落库 → 不建表、不动备份覆盖清单),离线设备保留最后读数;
  · 读失败不清缓存:list_devices 失败时若照清会把整份缓存抹掉、大屏全体变「—」;
  · 配置存 `app_meta.device_battery`(照 step_defaults:出厂值 + 白名单 + 范围钳制 +
    只落与出厂值不同的字段),改阈值不用重启(线程每轮重读配置)。
- 告警:事件 `device.battery.low` / `device.battery.recovered`(默认关,去通知页勾订阅)。
  **按档位做状态沿**(0 正常 / 1 低 / 2 严重):掉档才报、严重再报一次、恢复报一次;
  迟滞 +5% 避免在阈值上下反复告警;同档位每 6h 重复提醒一次。
  "充电中"看的是 `status:` 行(2/5),**不是"插着电"**——所以"插着却没充电"
  (劣质线/温控/满电停充 status:4)仍会告警,那正是最该知道的情况(实测 fleet 里
  就有一台 8% 插着 AC 但 `Max charging current: 0`)。
- GET /api/status 每台设备多一个 `battery`:`{level,charging,at,tier}`。
  **tier 由后端算好**,前端只按它上色——阈值只在「工具 → 设备发现 → 电量监控」一处定义,
  免得 JS 里再判一遍、两边不一致。
- 前端:大屏卡片型号行右侧加电量徽标(绿/黄/红 + ⚡ 充电中,离线置灰),
  `cardHtml`/`renderGrid` 增量更新/脏检查白名单三处都改了(漏一处就不刷新);
  监控页设备表新增可排序的「电量」列(空表 colspan 11 顺带对齐了)。
- 接口:GET/POST /api/devices/battery[/settings] + POST /scan(需设备权限,
  与 /api/devices/discovery/* 同权限档)。

自测:单元 30 项(解析真机输出/档位/状态机/钳制,含 scale=255、无 status 行、
垃圾输出等边界)、集成 27 项(临时库自建设备池:缓存/通知/离线保留/删设备清理/
配置往返/阈值改动即时生效)、真实 11 台设备一轮 0.44s 全读到、API 端到端
(登录/权限/钳制/越界/REST 往返/页面 DOM)、两份前端各自语法检查 + 渲染用例。
This commit is contained in:
2026-09-24 08:37:42 +08:00
parent 773cfbb763
commit beb51637dd
16 changed files with 651 additions and 13 deletions
+34 -3
View File
@@ -73,6 +73,17 @@ main{position:relative;z-index:2;height:calc(100vh - 88px);overflow-y:auto;paddi
.card .info .name{font-size:13.5px;font-weight:700;color:#f1f4f8;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
.card .info .ip{font-family:var(--mono);font-size:12px;color:var(--muted);margin-top:2px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
.card .info .model{font-size:10.5px;color:var(--faint);margin-top:2px}
/* 型号 + 电量同一行(省一行高度,卡片本来就矮) */
.card .info .meta{display:flex;align-items:center;gap:8px;margin-top:2px;white-space:nowrap;overflow:hidden}
.card .info .meta .model{margin-top:0;overflow:hidden;text-overflow:ellipsis}
.card .info .batt{margin-left:auto;display:inline-flex;align-items:center;gap:2px;font-size:11px;color:var(--faint);flex:0 0 auto}
.card .info .batt .lv{font-family:var(--mono);font-weight:700}
.card .info .batt.ok .lv{color:var(--green)}
.card .info .batt.low .lv{color:var(--amber)}
.card .info .batt.crit .lv{color:var(--red)}
.card .info .batt.crit{animation:pulse 1.6s infinite}
.card .info .batt.stale{opacity:.4}
.card .info .batt .chg{color:var(--teal)}
.card .info .action{font-size:11.5px;color:var(--muted);margin-top:6px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;min-height:16px}
.card .info .action b{color:var(--amber);font-weight:600}
.card .info .prog{margin-top:7px;height:4px;background:#1d242e;border-radius:99px;overflow:hidden}
@@ -202,8 +213,8 @@ async function refreshStatus(){
const r=await apiGet('/api/status');
if(!r||!r.ok)return;
const devs=(r.devices||[]).sort((a,b)=>a.serial.localeCompare(b.serial));
const changed=JSON.stringify(devs.map(d=>[d.serial,d.present,d.worker_status,d.task_job,d.current_action,d.progress,d.device_name,d.model]))!==
JSON.stringify(_devices.map(d=>[d.serial,d.present,d.worker_status,d.task_job,d.current_action,d.progress,d.device_name,d.model]));
const changed=JSON.stringify(devs.map(d=>[d.serial,d.present,d.worker_status,d.task_job,d.current_action,d.progress,d.device_name,d.model,d.battery]))!==
JSON.stringify(_devices.map(d=>[d.serial,d.present,d.worker_status,d.task_job,d.current_action,d.progress,d.device_name,d.model,d.battery]));
_devices=devs;
renderStats(devs);
if(changed)renderGrid(visibleDevs(devs));
@@ -249,6 +260,22 @@ function fmtProgress(p){
}
function shortIp(serial){return String(serial||'').replace(/:5555$/,'');}
// 电量:告警档位(tier 0 正常/1 低/2 严重)由后端算好,前端只上色——
// 阈值只在「工具 → 设备发现 → 电量监控」一处定义,前端不重复判,免得两边不一致
function battHtml(d){
const b=d.battery;
if(!b)return '<span class="batt">🔋<span class="lv">—</span></span>';
const t=b.tier||0;
const cls=t===2?'crit':(t===1?'low':'ok');
const chg=b.charging?'<span class="chg" title="充电中">⚡</span>':'';
const mins=b.at?Math.floor((Date.now()/1000-b.at)/60):-1;
const minsTxt=(mins<0?'未知':(mins<1?'刚刚':mins+' 分钟前'));
const tip=(t===2?'电量严重不足':(t===1?'电量低':'电量正常'))
+'('+minsTxt+'采集'+(d.present?'':',设备已离线,显示最后一次读数')+')';
return '<span class="batt '+cls+(d.present?'':' stale')+'" title="'+tip+'">🔋'
+'<span class="lv">'+b.level+'%</span>'+chg+'</span>';
}
function cardHtml(d, i){
const cls=cardCls(d);
const serial=esc(d.serial);
@@ -268,7 +295,8 @@ function cardHtml(d, i){
'<div class="info">'+
'<div class="name">'+name+'</div>'+
'<div class="ip">'+ip+'</div>'+
'<div class="model">'+esc(d.model||'')+'</div>'+
'<div class="meta"><span class="model">'+esc(d.model||'')+'</span>'
+'<span class="batt-wrap">'+battHtml(d)+'</span></div>'+
action+fmtProgress(d.progress)+
'<div class="hint">点击进入设备操作</div>'+
'</div>'+
@@ -306,6 +334,9 @@ function renderGrid(devs){
card.querySelector('.name').textContent=d.device_name||d.model||'设备';
card.querySelector('.ip').textContent=shortIp(serial);
card.querySelector('.model').textContent=d.model||'';
// 电量(与型号同一行,见 .meta)
const bw=card.querySelector('.batt-wrap');
if(bw)bw.innerHTML=battHtml(d);
const action=d.current_action
?(d.task_job?'<b>'+esc(d.task_job)+'</b> · ':'')+esc(d.current_action)
:(d.task_job?'<b>'+esc(d.task_job)+'</b>':'');