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
+32
View File
@@ -553,6 +553,7 @@ body{background:var(--bg);font-family:var(--body);color:var(--text);font-size:14
<th class="col-cb"><input type="checkbox" id="cb-all" onclick="toggleAllDevices(this.checked)" title="全选/取消全选"></th>
<th data-sort="serial" onclick="_lpSort('devices','serial')">设备</th>
<th data-sort="model" onclick="_lpSort('devices','model')">型号</th>
<th data-sort="battery" onclick="_lpSort('devices','battery')" title="后台每分钟采集一次(dumpsys battery);颜色按告警档位上色,阈值在「工具 → 设备发现 → 电量监控」里配">电量</th>
<th data-sort="worker_status" onclick="_lpSort('devices','worker_status')">任务状态</th>
<th data-sort="foreground_app" onclick="_lpSort('devices','foreground_app')">前台App</th>
<th data-sort="progress" onclick="_lpSort('devices','progress')">进度</th>
@@ -1205,6 +1206,37 @@ body{background:var(--bg);font-family:var(--body);color:var(--text);font-size:14
</table>
</div>
</div>
<!-- 电量监控:定时采集设备电量(大屏 + 监控页设备列表展示),低于阈值推 webhook 通知 -->
<div style="border-bottom:1px solid var(--border);margin-bottom:10px;padding-bottom:10px">
<div class="toolbar" style="flex-wrap:wrap">
<label style="display:inline-flex;align-items:center;gap:4px">
<input type="checkbox" id="battery-enabled" onchange="saveBatterySettings()"> 电量监控
</label>
<span class="text-muted" style="margin-left:8px">低电量</span>
<input type="number" id="battery-low" style="width:70px" min="1" max="100"
title="电量低于这个值就告警">
<span class="text-muted">% · 严重</span>
<input type="number" id="battery-critical" style="width:70px" min="1" max="100"
title="低于这个值时通知等级升到「严重」(error)。不能高于低电量阈值。">
<span class="text-muted">%</span>
<label style="display:inline-flex;align-items:center;gap:4px;margin-left:10px"
title="充电中(status=充电中/已充满)不告警——插着充电器说明正在补电。注意「插着却没充电」(劣质线/温控/满电停充)仍会告警,那正是最该知道的情况。">
<input type="checkbox" id="battery-skip-charging"> 充电中不告警
</label>
<span class="text-muted" style="margin-left:8px">采集间隔</span>
<input type="number" id="battery-interval" style="width:70px" min="30" max="3600">
<span class="text-muted">秒</span>
<button class="btn" onclick="saveBatterySettings()">保存设置</button>
<button class="btn" onclick="scanBatteryNow()">立即采集</button>
<span id="battery-status" class="text-muted"></span>
</div>
<div class="help">定时用 <code>dumpsys battery</code>(只读)采集池内在线设备的电量,显示在
<b>「监控 → 设备列表」的电量列</b>与<b>大屏卡片</b>上。<br>
低于阈值时推 webhook 通知(事件 <code>device.battery.low</code>,要在「系统 → 通知」里勾选订阅才发):
<b>掉到低电量报一次、掉到严重再报一次、恢复再报一次</b>,不做重复刷屏。<br>
电量只放内存、<b>不落库</b>(重启后重新采一轮),所以不占数据库、不影响备份。
设备离线时显示最后一次读数(置灰),不会变成空白。</div>
</div>
<div class="toolbar">
<input type="text" id="devpool-serial" class="form-control" style="width:220px;font-family:monospace"
placeholder="serial,如 100.100.10.20:5555" onkeydown="if(event.key==='Enter')addPoolDev()">