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:
@@ -45,6 +45,7 @@
|
||||
|------|------|
|
||||
| **多设备并发任务** | 每设备一个 Worker 线程；同一设备同时只跑一个任务（可配置"抢占"打断其他任务） |
|
||||
| **设备池** | SQLite 清单 + adb 在线状态；支持手工添加、网段自动发现、一键重连、型号采集、启用/停用 |
|
||||
| **电量监控** | 后台每分钟 `dumpsys battery`（只读）采一次电量，**大屏卡片**与**监控页设备列表**都显示（按档位着色 + ⚡ 充电中）；低于阈值推 webhook 告警（**充电中不报、"插着却没充电"照报**，掉档/恢复各报一次，不刷屏）。电量只放内存不落库（见 [NOTIFY.md](doc/NOTIFY.md) §3.1） |
|
||||
| **任务调度** | 手动 / cron 定时 / 定时启停；运行窗口；失败重试（含端口耗尽类的长退避） |
|
||||
| **步骤编辑器** | 可视化拖拽编排 21 种步骤（含循环/条件/OCR/通知/录制回放），可打包成"自定义动作"复用 |
|
||||
| **拟人化操作** | 滑动默认走弧线轨迹、位置/幅度/时长每次抖动，且**每台设备有自己的手速与习惯**（同设备风格稳定、设备之间明显不同）——批量跑时不像同步机器人（见 [TASK_DEV.md](doc/TASK_DEV.md) §8.4） |
|
||||
@@ -136,6 +137,7 @@ auto_control/
|
||||
│ ├── task_manager.py # 调度器：分组/任务/APScheduler/重试/运行控制
|
||||
│ ├── adb_helper.py # adb 命令封装（全局锁，红线：绝不 kill-server）
|
||||
│ ├── device_discovery.py # 网段扫描发现设备 → 待连接池
|
||||
│ ├── device_battery.py # 设备电量采集（dumpsys 只读）+ 低电量告警
|
||||
│ ├── u2_helper.py # uiautomator2 通用辅助（等首页/安全点击等）
|
||||
│ ├── uiauto_helper.py # uiautodev 客户端（元素树 + XPath 建议）
|
||||
│ ├── ocr.py # 屏幕 OCR（RapidOCR，条件判断用）
|
||||
|
||||
@@ -0,0 +1,404 @@
|
||||
"""设备电量采集 + 低电量告警（大屏/监控展示 + webhook 通知）。
|
||||
|
||||
设计要点（都是被现有代码/实测约束逼出来的，改之前先读一遍）：
|
||||
|
||||
- **只读**：`adb -s <serial> shell dumpsys battery`（实测 0.2~0.35s/台）。
|
||||
全模块不 connect / 不 disconnect / 不 kill-server（技术红线，见 doc/DEVELOPMENT.md）。
|
||||
能查到的前提是设备已在 adb server 里（= device_pool.list_online()），
|
||||
所以连"空闲设备"也能查——**不需要 connect**，这是本模块敢每轮扫全量的原因。
|
||||
- **后台独立线程**采集（照 core/device_discovery.py 的 daemon 循环）：`/api/status`
|
||||
只读内存缓存。绝不能把 dumpsys 放进 /api/status——前端 5 秒轮询一次，
|
||||
14 台设备同步查会把 Flask 拖死（`get_status` 的 5s 缓存注释也写了这条）。
|
||||
- **不落库**：电量是易变值，重启重新采一轮即可 → 不建表、**不动备份覆盖清单**。
|
||||
- 告警走 notifier（`device.battery.low` / `device.battery.recovered`），
|
||||
**按档位做状态沿检测**（正常/低/严重），掉档才报，绝不满屏刷。
|
||||
- 配置存 `app_meta.device_battery` 一个键（照 core/step_defaults.py 的做法：
|
||||
出厂默认 + 字段白名单 + 只落"与出厂值不同"的字段）。
|
||||
"""
|
||||
import json
|
||||
import re
|
||||
import threading
|
||||
import time
|
||||
from concurrent.futures import ThreadPoolExecutor, as_completed
|
||||
|
||||
from config import USB_ADB_HOST, USB_ADB_PORT
|
||||
from core import notifier, device_pool
|
||||
from core.adb_helper import _adb, _adb_remote
|
||||
from core.logger import get_logger
|
||||
from core.models import db
|
||||
|
||||
_log = get_logger("core.battery")
|
||||
|
||||
# 出厂默认（前端「工具 → 设备发现 → 电量监控」的初始内容，也是没配过时的回退）
|
||||
FACTORY = {
|
||||
"enabled": True,
|
||||
"low": 20, # 低电量阈值（%）
|
||||
"critical": 10, # 严重低电量阈值（%）——通知等级升到 error
|
||||
"skip_charging": True, # 充电中不告警（插着充电器说明正在补电）
|
||||
"interval": 60, # 采集间隔（秒）
|
||||
}
|
||||
|
||||
# 字段规格：("num", 最小, 最大) / ("bool",)。白名单之外的一律丢弃。
|
||||
SPEC = {
|
||||
"enabled": ("bool",),
|
||||
"low": ("num", 1, 100),
|
||||
"critical": ("num", 1, 100),
|
||||
"skip_charging": ("bool",),
|
||||
"interval": ("num", 30, 3600),
|
||||
}
|
||||
|
||||
META_KEY = "device_battery"
|
||||
|
||||
# 恢复迟滞：掉到阈值下之后，要回升到 low+HYSTERESIS 才算"恢复"。
|
||||
# 没有它的话，电量在阈值上下浮动（充电器接触不良）会反复告警。
|
||||
HYSTERESIS = 5
|
||||
# 持续低电量的重复提醒间隔（秒）。0 = 只提醒一次（等恢复后才重新武装）。
|
||||
RE_NOTIFY_S = 6 * 3600
|
||||
# 单台设备读取超时（秒）。正常 0.2~0.35s，8s 已经非常宽松。
|
||||
_READ_TIMEOUT = 8
|
||||
|
||||
_app = None
|
||||
_cache = {} # serial -> {"level": int, "charging": bool, "at": ts}
|
||||
_tiers = {} # serial -> {"tier": int, "at": ts} 告警档位状态（0 正常/1 低/2 严重）
|
||||
_lock = threading.Lock()
|
||||
_stop_event = threading.Event()
|
||||
_scanning = False
|
||||
_last_scan = None # (时间串, 采集成功数, 在线数)
|
||||
|
||||
|
||||
def _ctx():
|
||||
"""后台线程访问 db 时自行推 app context（仿 device_pool._ctx）。"""
|
||||
return _app.app_context() if _app else None
|
||||
|
||||
|
||||
# ================== 配置读写 ==================
|
||||
def factory():
|
||||
"""出厂默认的拷贝（别让调用方改到常量）。"""
|
||||
return dict(FACTORY)
|
||||
|
||||
|
||||
def _clean(raw):
|
||||
"""按 SPEC 校验清洗；非法字段**丢弃**（不让脏值进库）。"""
|
||||
if not isinstance(raw, dict):
|
||||
return {}
|
||||
out = {}
|
||||
for k, rule in SPEC.items():
|
||||
if k not in raw:
|
||||
continue
|
||||
v = raw[k]
|
||||
try:
|
||||
if rule[0] == "bool":
|
||||
out[k] = bool(v)
|
||||
elif rule[0] == "num":
|
||||
out[k] = int(round(max(rule[1], min(rule[2], float(v)))))
|
||||
except (TypeError, ValueError):
|
||||
continue
|
||||
return out
|
||||
|
||||
|
||||
def get_settings():
|
||||
"""当前生效配置（读库；模块未初始化时回退出厂值，别让调用方炸）。"""
|
||||
ctx = _ctx()
|
||||
if ctx is None:
|
||||
return factory()
|
||||
try:
|
||||
from core.db_config import meta_get
|
||||
with ctx:
|
||||
raw = meta_get(META_KEY) or ""
|
||||
if not raw:
|
||||
return factory()
|
||||
return _merge(json.loads(raw))
|
||||
except Exception:
|
||||
return factory()
|
||||
|
||||
|
||||
def _merge(user):
|
||||
"""出厂默认 + 用户覆盖（逐字段合并 + 钳制）。"""
|
||||
vals = dict(FACTORY)
|
||||
vals.update(_clean(user))
|
||||
# 严重阈值不能高于低电量阈值，否则"严重"永远先触发，语义反了
|
||||
if vals["critical"] > vals["low"]:
|
||||
vals["critical"] = vals["low"]
|
||||
return vals
|
||||
|
||||
|
||||
def save_settings(payload):
|
||||
"""保存配置。返回 (ok, msg, saved)。
|
||||
|
||||
与出厂默认**相同的字段不入库**（照 step_defaults）：以后调出厂值时，
|
||||
没配过的字段能跟着更新，库里只留"用户真的改过"的部分。
|
||||
"""
|
||||
vals = _merge(payload)
|
||||
diff = {k: v for k, v in vals.items() if FACTORY.get(k) != v}
|
||||
ctx = _ctx()
|
||||
if ctx is None:
|
||||
return False, "电量模块未初始化", {}
|
||||
try:
|
||||
from core.db_config import meta_set
|
||||
with ctx:
|
||||
meta_set(META_KEY, json.dumps(diff, ensure_ascii=False))
|
||||
db.session.commit()
|
||||
except Exception as e:
|
||||
return False, f"保存失败: {e}", {}
|
||||
_log.info(f"电量监控配置已保存: {vals}")
|
||||
return True, "已保存", vals
|
||||
|
||||
|
||||
# ================== 单台读取与解析 ==================
|
||||
_BAT_LEVEL_RE = re.compile(r"^\s*level:\s*(\d+)", re.M)
|
||||
_BAT_SCALE_RE = re.compile(r"^\s*scale:\s*(\d+)", re.M)
|
||||
_BAT_STATUS_RE = re.compile(r"^\s*status:\s*(\d+)", re.M)
|
||||
# 部分 ROM 没有 status 行时的兜底：插着电就算充电中
|
||||
_POWERED_RE = re.compile(r"^\s*(?:AC|USB|Wireless) powered:\s*true", re.M)
|
||||
|
||||
|
||||
def _parse_battery(text):
|
||||
"""解析 `dumpsys battery` 输出，返回 (level, charging) 或 None。
|
||||
|
||||
status: 2=充电中 5=已充满 → charging；3=放电 4=未充电（插着但不充，
|
||||
例如劣质线/温控/满电停充）→ 不算充电中。所以"插着却掉电"仍然会告警，
|
||||
这正是最该让人知道的情况。
|
||||
"""
|
||||
if not text or "level:" not in text:
|
||||
return None
|
||||
m = _BAT_LEVEL_RE.search(text)
|
||||
if not m:
|
||||
return None
|
||||
level = int(m.group(1))
|
||||
ms = _BAT_SCALE_RE.search(text)
|
||||
scale = int(ms.group(1)) if ms else 100
|
||||
if scale > 0 and scale != 100:
|
||||
level = int(round(level * 100.0 / scale))
|
||||
st = _BAT_STATUS_RE.search(text)
|
||||
if st:
|
||||
charging = int(st.group(1)) in (2, 5)
|
||||
else:
|
||||
charging = bool(_POWERED_RE.search(text))
|
||||
return max(0, min(100, level)), charging
|
||||
|
||||
|
||||
def _read_battery(serial):
|
||||
"""读一台设备的电量，返回 (level, charging) 或 None。
|
||||
|
||||
与 device_pool.refresh_model 同思路：IP:5555 设备走本机 adb server；
|
||||
USB 设备本机看不到，再走 220 远程 adb server 兜底。
|
||||
"""
|
||||
out = ""
|
||||
try:
|
||||
out = _adb("-s", serial, "shell", "dumpsys", "battery", timeout=_READ_TIMEOUT)
|
||||
except Exception:
|
||||
out = ""
|
||||
if not out and ":" not in serial:
|
||||
try:
|
||||
out = _adb_remote(USB_ADB_HOST, USB_ADB_PORT, "-s", serial,
|
||||
"shell", "dumpsys", "battery")
|
||||
except Exception:
|
||||
out = ""
|
||||
return _parse_battery(out)
|
||||
|
||||
|
||||
# ================== 告警（档位状态沿） ==================
|
||||
def _tier_of(level, charging, spec, prev):
|
||||
"""电量档位：0 正常 / 1 低 / 2 严重。
|
||||
|
||||
充电中（且配了「充电中不告警」）直接算 0——正在补电就不用管它。
|
||||
回升要越过 low+HYSTERESIS 才回 0，避免在阈值上下反复告警。
|
||||
"""
|
||||
if spec["skip_charging"] and charging:
|
||||
return 0
|
||||
if level <= spec["critical"]:
|
||||
return 2
|
||||
if level <= spec["low"]:
|
||||
return 1
|
||||
if level >= spec["low"] + HYSTERESIS:
|
||||
return 0
|
||||
return prev # 迟滞带内：维持原档位（不报也不恢复）
|
||||
|
||||
|
||||
def _check_alerts(serial, level, charging, spec, dname, model):
|
||||
"""比上一轮档位，决定是否发通知。只在档位变化/到重复提醒点时发。"""
|
||||
now = time.time()
|
||||
with _lock:
|
||||
st = _tiers.setdefault(serial, {"tier": 0, "at": 0.0})
|
||||
prev = st["tier"]
|
||||
tier = _tier_of(level, charging, spec, prev)
|
||||
# 掉档（正常→低→严重）立刻报；同一档位停留太久到重复提醒间隔再报一次
|
||||
fire = tier > prev or (tier > 0 and now - st["at"] >= RE_NOTIFY_S)
|
||||
if fire:
|
||||
st["tier"], st["at"] = tier, now
|
||||
recovered = prev > 0 and tier == 0
|
||||
if recovered:
|
||||
st["tier"], st["at"] = 0, now
|
||||
if fire:
|
||||
notifier.notify(
|
||||
"device.battery.low", serial=serial, device_name=dname, model=model,
|
||||
battery=level, charging=charging,
|
||||
threshold=spec["critical"] if tier == 2 else spec["low"],
|
||||
level="error" if tier == 2 else "warning")
|
||||
if recovered:
|
||||
notifier.notify(
|
||||
"device.battery.recovered", serial=serial, device_name=dname,
|
||||
model=model, battery=level, charging=charging, threshold=spec["low"])
|
||||
|
||||
|
||||
# ================== 一轮全量采集 ==================
|
||||
def _scan_all():
|
||||
"""采集池内所有在线设备的电量（后台线程执行）。
|
||||
|
||||
读失败的设备（离线/超时）**保持上一次的读数不动**——大屏上显示的是
|
||||
"最后一次知道的电量"，比直接变成空白有用。
|
||||
"""
|
||||
global _scanning, _last_scan
|
||||
if _scanning:
|
||||
return
|
||||
_scanning = True
|
||||
try:
|
||||
spec = get_settings()
|
||||
try:
|
||||
online = list(device_pool.list_online())
|
||||
except Exception as e:
|
||||
_log.warning(f"电量采集: 获取在线设备失败: {e}")
|
||||
return
|
||||
if not online:
|
||||
_last_scan = (time.strftime("%H:%M:%S"), 0, 0)
|
||||
return
|
||||
# 设备名/型号：通知里要显示「A08（Redmi K40）」而不是一串 IP
|
||||
names, models, known = {}, {}, set()
|
||||
try:
|
||||
for d in device_pool.list_devices():
|
||||
s = d.get("serial") or ""
|
||||
if not s:
|
||||
continue
|
||||
known.add(s)
|
||||
names[s] = d.get("name") or ""
|
||||
models[s] = d.get("model") or ""
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
# 只采集「设备池 ∩ 在线」：平台管的是设备池（与 list_ready 同口径），
|
||||
# 池外的设备不上大屏、也不告警——adb 里能看到但不归平台管的设备不该吵人。
|
||||
# known 为空 = 设备表没读到（不能因此整轮不采），退回按在线设备采。
|
||||
targets = [s for s in online if s in known] if known else list(online)
|
||||
if not targets:
|
||||
_last_scan = (time.strftime("%H:%M:%S"), 0, 0)
|
||||
return
|
||||
|
||||
results = {}
|
||||
try:
|
||||
with ThreadPoolExecutor(max_workers=min(10, len(targets))) as pool:
|
||||
futures = {pool.submit(_read_battery, s): s for s in targets}
|
||||
for fut in as_completed(futures, timeout=_READ_TIMEOUT + 15):
|
||||
s = futures[fut]
|
||||
try:
|
||||
results[s] = fut.result()
|
||||
except Exception:
|
||||
results[s] = None
|
||||
except Exception as e:
|
||||
_log.warning(f"电量采集: 部分设备读取超时（保留已取到的）: {e}")
|
||||
|
||||
now = time.time()
|
||||
with _lock:
|
||||
for s, r in results.items():
|
||||
if r:
|
||||
_cache[s] = {"level": r[0], "charging": r[1], "at": now}
|
||||
# 设备已从池里删除的，连缓存一起清掉（避免大屏上冒出幽灵设备）。
|
||||
# ⚠️ 只在真的读到设备清单时才清理：list_devices 失败时 known 是空的，
|
||||
# 照清下去会把整份缓存抹掉、大屏全体变「—」。
|
||||
if known:
|
||||
for s in [k for k in _cache if k not in known]:
|
||||
_cache.pop(s, None)
|
||||
_tiers.pop(s, None)
|
||||
|
||||
for s, r in results.items():
|
||||
if r:
|
||||
_check_alerts(s, r[0], r[1], spec, names.get(s, ""), models.get(s, ""))
|
||||
|
||||
ok = sum(1 for r in results.values() if r)
|
||||
_last_scan = (time.strftime("%H:%M:%S"), ok, len(targets))
|
||||
_log.info(f"电量采集完成: {ok}/{len(targets)} 台（池内在线；adb 可见 {len(online)} 台）")
|
||||
except Exception as e:
|
||||
_log.warning(f"电量采集异常: {e}")
|
||||
finally:
|
||||
_scanning = False
|
||||
|
||||
|
||||
def scan_once():
|
||||
"""手动触发一轮采集（后台线程执行，不阻塞调用者）。返回是否已启动。
|
||||
|
||||
不看 enabled 开关：用户点了「立即采集」就应该采，开关只管定时循环。
|
||||
"""
|
||||
if _scanning:
|
||||
return False
|
||||
threading.Thread(target=_scan_all, name="battery-scan-once", daemon=True).start()
|
||||
return True
|
||||
|
||||
|
||||
# ================== 对外读取 ==================
|
||||
def get(serial):
|
||||
"""设备电量快照（供 /api/status 组装）或 None。
|
||||
|
||||
结构 {"level": int, "charging": bool, "at": ts, "tier": 0|1|2}。
|
||||
**带上 tier 是刻意的**：前端只按档位上色，不在 JS 里重算阈值——
|
||||
否则「工具 → 设备发现」改了阈值，大屏/监控页的判定就和告警对不上了。
|
||||
"""
|
||||
with _lock:
|
||||
v = _cache.get(serial)
|
||||
if not v:
|
||||
return None
|
||||
out = dict(v)
|
||||
st = _tiers.get(serial)
|
||||
out["tier"] = st["tier"] if st else 0
|
||||
return out
|
||||
|
||||
|
||||
def get_status():
|
||||
"""采集器状态（面板显示用）。"""
|
||||
with _lock:
|
||||
cached = len(_cache)
|
||||
return {
|
||||
"settings": get_settings(),
|
||||
"scanning": _scanning,
|
||||
"last_scan": _last_scan,
|
||||
"cached": cached,
|
||||
}
|
||||
|
||||
|
||||
# ================== 定时采集线程 ==================
|
||||
def _battery_loop():
|
||||
"""定时采集 daemon 线程。每轮重读配置（开关/间隔即时生效）。
|
||||
|
||||
启动先等 20s：让开 web_server 的预连接与型号采集（都抢 adb）。
|
||||
等待用 15s 切片，关停/改间隔 ≤15s 生效。
|
||||
"""
|
||||
try:
|
||||
_stop_event.wait(20)
|
||||
while not _stop_event.is_set():
|
||||
interval = 60
|
||||
try:
|
||||
spec = get_settings()
|
||||
interval = max(30, int(spec.get("interval", 60)))
|
||||
if spec.get("enabled"):
|
||||
_scan_all()
|
||||
except Exception as e:
|
||||
_log.warning(f"电量定时采集异常: {e}")
|
||||
waited = 0
|
||||
while waited < interval and not _stop_event.is_set():
|
||||
_stop_event.wait(min(15, interval - waited))
|
||||
waited += min(15, interval - waited)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
|
||||
def init_app(app):
|
||||
"""web_server 启动时调用：绑 app + 起定时采集 daemon 线程。"""
|
||||
global _app
|
||||
_app = app
|
||||
_stop_event.clear()
|
||||
t = threading.Thread(target=_battery_loop, name="device-battery", daemon=True)
|
||||
t.start()
|
||||
_log.info("设备电量采集线程已启动（默认 60s 一次）")
|
||||
|
||||
|
||||
def shutdown():
|
||||
"""优雅退出：置 stop_event，等待中的循环在切片边界退出。"""
|
||||
_stop_event.set()
|
||||
@@ -334,6 +334,7 @@ _FIELD_LABELS = {
|
||||
"error_msg": "错误", "count": "数量", "serials": "设备", "devices": "设备",
|
||||
"pairs": "认领", "target": "目标", "selector": "选择器", "miss_count": "连续未命中",
|
||||
"timeout_s": "超时(秒)", "task_job": "原任务", "model": "型号",
|
||||
"battery": "电量(%)", "threshold": "告警阈值(%)", "charging": "充电中",
|
||||
"apk_name": "应用", "apk_id": "应用ID", "package_name": "包名",
|
||||
"success": "成功", "failed": "失败", "skipped": "跳过", "total": "总数",
|
||||
"title": "标题", "message": "内容", "patrol_name": "巡检",
|
||||
|
||||
@@ -128,6 +128,16 @@ EVENTS = [
|
||||
_e("device.heartbeat_timeout", "心跳超时", "设备",
|
||||
["serial", "device_name", "timeout_s", "task_job", "model"],
|
||||
"设备卡死（长时间没心跳），任务可能已中断", agg_window=0, recommend=True),
|
||||
_e("device.battery.low", "设备电量低", "设备",
|
||||
["serial", "device_name", "model", "battery", "charging", "threshold"],
|
||||
"设备电量掉到阈值以下（默认 20%，可在「工具 → 设备发现 → 电量监控」改）。"
|
||||
"充电中的设备不报——插着充电器说明正在补电；"
|
||||
"「插着却没充电」（劣质线/温控/满电停充）仍会报，那正是最该知道的情况",
|
||||
agg_window=0, agg_key=_BY_SERIAL, recommend=True),
|
||||
_e("device.battery.recovered", "设备电量已恢复", "设备",
|
||||
["serial", "device_name", "model", "battery", "charging", "threshold"],
|
||||
"低电量设备重新充上电，或电量回升到阈值以上（含恢复迟滞）", agg_window=0,
|
||||
agg_key=_BY_SERIAL),
|
||||
|
||||
# ---------------- 应用安装 ----------------
|
||||
_e("apk.install.started", "应用安装开始", "安装",
|
||||
|
||||
@@ -32,6 +32,7 @@ from config import DATA_DIR
|
||||
from core.logger import get_logger
|
||||
from core.models import db, DeviceGroup as GroupRow, TaskJob as JobRow
|
||||
from core import device_pool
|
||||
from core import device_battery
|
||||
from core import notifier
|
||||
from .adb_helper import get_foreground_app, get_foreground_app_remote
|
||||
from .device_worker import (
|
||||
@@ -1122,6 +1123,9 @@ class TaskManager:
|
||||
"owner": "",
|
||||
"worker_status": w.get("status", "idle"),
|
||||
"foreground_app": self._fg_scanner.get(serial),
|
||||
# 电量（后台线程采的缓存，这里只读内存不查 adb）：
|
||||
# {"level":85,"charging":false,"at":ts} 或 None（还没采到）
|
||||
"battery": device_battery.get(serial),
|
||||
# 通用进度字段（任意 app 通用，前端统一解析展示）
|
||||
# 结构：{"done": int, "total": int, "unit": str, "action_counts": dict}
|
||||
"progress": w.get("progress", {}),
|
||||
|
||||
+11
-1
@@ -169,6 +169,9 @@
|
||||
| POST | `/api/devices/discovery/ignore` | D | 忽略待连接设备 |
|
||||
| POST | `/api/devices/discovery/reconnect` | D | 立即重连指定断联设备 |
|
||||
| POST | `/api/devices/discovery/settings` | D | 保存发现配置 |
|
||||
| GET | `/api/devices/battery` | D | 电量采集器状态 + 生效配置（`{settings, scanning, last_scan:[时间,成功,目标数], cached}`） |
|
||||
| POST | `/api/devices/battery/settings` | D | 保存电量监控配置（越界钳制，返回钳制后的生效值） |
|
||||
| POST | `/api/devices/battery/scan` | D | 立即采集一次（后台执行；上一轮没跑完返回 409） |
|
||||
|
||||
### 2.6 apks（`web/apks_api.py`）
|
||||
|
||||
@@ -321,12 +324,19 @@
|
||||
"serial": "192.168.20.206:5555", "model": "22120RN86C", "device_name": "", "present": true, "ready": true,
|
||||
"worker_status": "running", "task_job": "测试抖音评论", "attempt": 1, "max_attempts": 1,
|
||||
"current_action": "点击搜索", "progress": {"done": 5, "total": 0, "unit": "操作", "elapsed": 42},
|
||||
"foreground_app": "抖音", "last_error": "", "last_warning": "", "end_time": 0
|
||||
"foreground_app": "抖音", "last_error": "", "last_warning": "", "end_time": 0,
|
||||
"battery": {"level": 85, "charging": true, "at": 1700000000.0, "tier": 0}
|
||||
}]}
|
||||
```
|
||||
|
||||
`worker_status`：`idle` / `connecting` / `running` / `done` / `error` / `released` / `failed`。
|
||||
|
||||
`battery`：**后台线程采的缓存值**（默认 60s 一轮，`dumpsys battery` 只读），没采到时为 `null`。
|
||||
`tier` 是**告警档位**（`0` 正常 / `1` 低电量 / `2` 严重），由后端按配置阈值算好——
|
||||
前端只按 `tier` 上色，**不在 JS 里重算阈值**（阈值只在「工具 → 设备发现 → 电量监控」一处定义）。
|
||||
设备离线时保留最后一次读数（`at` 是采集时刻），页面置灰显示。详见 [NOTIFY.md](NOTIFY.md) §3 的
|
||||
`device.battery.low`。
|
||||
|
||||
### GET /api/summary
|
||||
|
||||
```json
|
||||
|
||||
+9
-6
@@ -26,6 +26,7 @@
|
||||
┌───────────────────────────▼──────────────────────────────────────────┐
|
||||
│ 领域层 task_manager（调度） device_worker（执行） device_pool（池） │
|
||||
│ system_backup（备份） apk_manager（应用） device_discovery │
|
||||
│ device_battery（电量采集 + 低电量告警） │
|
||||
└───────────────────────────┬──────────────────────────────────────────┘
|
||||
│
|
||||
┌───────────────────────────▼──────────────────────────────────────────┐
|
||||
@@ -79,7 +80,7 @@
|
||||
|------|------|---------|
|
||||
| **B** | `:28-58` | `Flask(__name__)`；会话密钥（`.env` 的 `WEB_SECRET_KEY`，缺失则随机生成并 warning）；`TEMPLATES_AUTO_RELOAD=True`；**数据库目标由 `core/db_config` 装配**（`.env` 的 `DEPLOY_ENV`/`DB_*` → URI + 引擎参数），配置错直接 `SystemExit(2)`；`LoginManager` + `login_view="auth.login"` |
|
||||
| **C** | `:60-67` | **恢复任务消费** `consume_pending_restore()`。SQLite 时代它必须在 engine 首次打开 `users.db` **之前**（Windows 无法替换被持有的文件）；改用 MySQL 后这一步的语义会变成"启动期事务替换"，见 §7 |
|
||||
| **D** | `:69-88` | `init_db(app)`（建表 → 补列 → 版本账本 → 唯一索引 → 默认管理员 → 旧 JSON 迁移）→ `notifier.init_app`（通知 dispatcher/sender 线程）与 `step_log.init_app`（步骤明细写线程）→ **恢复任务消费** `consume_pending_restore()` → **库环境标签校验 + 启动横幅**（`db_config.verify_deployment_label/print_banner`，不符拒绝启动）；`device_pool.init_app`（**起一次性线程**，3s 后采集型号）；`device_discovery.init_app`（**起常驻扫描线程**）；`TaskManager(app=app)`（APScheduler + 看门狗 + 从库加载分组/任务 + 重注册 cron）；`ApkManager(app=app)` |
|
||||
| **D** | `:69-88` | `init_db(app)`（建表 → 补列 → 版本账本 → 唯一索引 → 默认管理员 → 旧 JSON 迁移）→ `notifier.init_app`（通知 dispatcher/sender 线程）与 `step_log.init_app`（步骤明细写线程）→ **恢复任务消费** `consume_pending_restore()` → **库环境标签校验 + 启动横幅**（`db_config.verify_deployment_label/print_banner`，不符拒绝启动）；`device_pool.init_app`（**起一次性线程**，3s 后采集型号）；`device_discovery.init_app`（**起常驻扫描线程**）；`device_battery.init_app`（**起常驻电量采集线程**）；`TaskManager(app=app)`（APScheduler + 看门狗 + 从库加载分组/任务 + 重注册 cron）；`ApkManager(app=app)` |
|
||||
|
||||
### 2.3 阶段 E~G：蓝图、巡检调度器、真正启动
|
||||
|
||||
@@ -87,7 +88,7 @@
|
||||
|------|------|---------|
|
||||
| **E** | `:64-67` | `context.init(...)`；`register_blueprints(app)`（10 个蓝图）；`agent_api.set_app(app)`（供后台线程推 app context） |
|
||||
| **F** | 同上附近 | **第二个独立 APScheduler**：`CronTrigger(hour=3, minute=47)` 挂经验库巡检、`hour=4, minute=13` 挂步骤明细清理（`_purge_step_log`，自建 app context）；失败仅 warning |
|
||||
| **G** | `__main__` | `_ensure_uiauto_running()`（拉起 uiautodev:20242，写 `data/uiauto.pid`，`atexit` 清理）→ `_preconnect_pool_devices()`（后台并发 connect 池内网络设备）→ `_purge_step_log_async()`（后台清理超期步骤明细）→ `_run_server()`（候选端口依次 bind：`0.0.0.0:18050` → `127.0.0.1:18050` → `127.0.0.1:18051..18055`）；退出时 `notifier.shutdown()` + `step_log.shutdown()` + `mgr.shutdown()` + `device_discovery.shutdown()` + 停 uiautodev |
|
||||
| **G** | `__main__` | `_ensure_uiauto_running()`（拉起 uiautodev:20242，写 `data/uiauto.pid`，`atexit` 清理）→ `_preconnect_pool_devices()`（后台并发 connect 池内网络设备）→ `_purge_step_log_async()`（后台清理超期步骤明细）→ `_run_server()`（候选端口依次 bind：`0.0.0.0:18050` → `127.0.0.1:18050` → `127.0.0.1:18051..18055`）；退出时 `notifier.shutdown()` + `step_log.shutdown()` + `mgr.shutdown()` + `device_discovery.shutdown()` + `device_battery.shutdown()` + 停 uiautodev |
|
||||
|
||||
> ⚠️ **阶段 A~F 在 import 期就会起线程/调度器**，只有 uiautodev 拉起与预连接在 `__main__` 分支。以 WSGI 方式 import 本模块会得到"半个启动"的进程——本地调试请直接 `python web_server.py`。
|
||||
|
||||
@@ -105,6 +106,7 @@
|
||||
| `worker-watchdog` | `start_watchdog()` | `running/connecting` 心跳超时 → 标 `error` | 30s 检查 / 120s 阈值 |
|
||||
| `device-discovery` | `device_discovery.init_app` | 网段扫描 + 断联重连 | 首轮延迟 15s，之后 interval（默认 60s） |
|
||||
| `_refresh_models_bg` | `device_pool.init_app` | 启动后采集全部在线设备型号 | 一次性（3s 后） |
|
||||
| `device-battery` | `device_battery.init_app` | 采设备电量（`dumpsys battery` 只读）+ 低电量告警 | 首轮延迟 20s，之后 interval（默认 60s） |
|
||||
| `BaseWorker` × N | `TaskManager._run_with_retry` | 单设备任务执行 | 任务期 |
|
||||
| `_run_with_retry` × N | 同上 | 单设备重试循环 | 任务期 |
|
||||
| `fg-scan-once` | `_ForegroundScanner.scan_once` | 前台 App 扫描 | 手动触发，`Event` 防重入 |
|
||||
@@ -127,6 +129,7 @@
|
||||
| `_engine_lock` | `core/ocr.py` | OCR 引擎懒加载 + 推理串行 | 推理 0.2~0.5s，锁开销可忽略 |
|
||||
| `_scan_lock` / `_stop_event` | `core/device_discovery.py` | 定时/手动扫描互斥 | `acquire(blocking=False)` |
|
||||
| `_status_cache_lock` | `core/task_manager.py` | 状态缓存（TTL 5s） | 避免 `/api/status` 每次都查库 + adb |
|
||||
| `device_battery._lock` | `core/device_battery.py` | 电量缓存 `_cache` + 告警档位 `_tiers` | 采集线程 / `/api/status` / 告警状态机共用 |
|
||||
|
||||
**无锁部分**：`device_pool` 与 `models` 不持显式锁，依赖"每次操作独立 app context" + 数据库自身的并发控制（MySQL 下是 InnoDB 行锁 + READ COMMITTED，回退 SQLite 时是 WAL + `busy_timeout=5000`）。
|
||||
|
||||
@@ -267,7 +270,7 @@ connecting ──获取设备──▶ u2 连接 ──▶ running ──▶ set
|
||||
|
||||
### 6.1 单页应用
|
||||
|
||||
- 主页面 `templates/admin/monitor.html`：一个内联 `<style>` + 7 个 Tab 面板 + 7 个模态框容器 + 11 个 `<script src>`
|
||||
- 主页面 `templates/admin/monitor.html`：一个内联 `<style>` + 7 个 Tab 面板 + 10 个模态框容器 + 15 个 `<script src>`
|
||||
- 独立页面：`login.html`（登录）、`wall.html`（监控大屏，**完全自包含**，自带 CSS/JS，不加载 `static/admin/*.js`）
|
||||
- 服务端内联页：`GET /locate`（设备端定位大字页，免登录）
|
||||
- 响应头强制 `no-store`，避免后台改版后浏览器拿旧页面
|
||||
@@ -282,7 +285,7 @@ connecting ──获取设备──▶ u2 连接 ──▶ running ──▶ set
|
||||
| 用户 | `users` | `admin` | — |
|
||||
| 工具 | `tools` | `admin` | `clipboard` / `adb` / `ts` / `apks` / `appver` / `devapps` / `devpool` / `groups` |
|
||||
| AI 控制台 | `agent` | `admin` | — |
|
||||
| 系统 | `system` | `admin` | `backup` 数据备份 / `restore` 导入恢复 |
|
||||
| 系统 | `system` | `admin` | `backup` 数据备份 / `restore` 导入恢复 / `notify` 通知 Webhook |
|
||||
|
||||
子分栏会记住上次选中位置（`_activeSubs`）；`devpool` 子分栏自带 10s 轮询，切走即停。
|
||||
|
||||
@@ -293,10 +296,10 @@ connecting ──获取设备──▶ u2 连接 ──▶ running ──▶ set
|
||||
| `base.js` | esc / CSRF / 权限 / API 封装 / Toast / Tab 与子分栏切换 / 模态框 / 常量表 | 所有模块的公共底座 |
|
||||
| `markdown.js` | 轻量 Markdown 渲染（`renderMarkdown`） | 无 CDN 依赖；**先转义再套标记** |
|
||||
| `list.js` | 统一列表组件：搜索 + 分页 + 排序 | 状态注册表 `_LIST_PAGERS`；`setListPager` **不重置**页码/搜索/排序（避免轮询刷新打断用户） |
|
||||
| `monitor.js` | 监控页：设备表、批量操作、异常汇总、任务概况卡片（含覆盖设备 chip） | 5s 轮询 + 脏检查（签名不变不重渲染） |
|
||||
| `monitor.js` | 监控页：设备表（含**电量列**，按 `battery.tier` 上色）、批量操作、异常汇总、任务概况卡片（含覆盖设备 chip） | 5s 轮询 + 脏检查（签名不变不重渲染） |
|
||||
| `editor.js` | 步骤编辑器（拖拽 / 参数表单 / 条件分支 / 元素抓取 / 测试此步骤）+ `saveTask` | 最大的前端文件；`_stepEditor` 单例 |
|
||||
| `tasks.js` | 任务 Tab：任务 CRUD / 调度解析 / 运行窗口 + 自定义动作 | |
|
||||
| `tools.js` | 工具 Tab：剪贴板、adb 终端、Tailscale、设备池、自动发现、远程看屏 | |
|
||||
| `tools.js` | 工具 Tab：剪贴板、adb 终端、Tailscale、设备池、自动发现、远程看屏、**电量监控配置**（阈值/间隔/立即采集） | 电量表单只回填一次，10s 轮询不冲掉用户正在输的值 |
|
||||
| `apps.js` | 应用管理：APK 上传/安装/删除、设备已装应用 | |
|
||||
| `admin.js` | 分组、日志、用户 + **全局初始化入口**（末尾 `initCsrf(); loadMe(); showTab('monitor')`） | |
|
||||
| `agent.js` | AI 控制台·聊天：会话、SSE 流、Markdown / 推理链 / token 渲染、实时画面、经验库 / 动作库 | |
|
||||
|
||||
@@ -278,6 +278,7 @@ UTF-8 等价于字节序）。
|
||||
| `deployment_claimed_at` | 标签写入时间 | 同上 |
|
||||
| `notify_webhooks` | **通知 / Webhook 全部配置**（JSON：`{version, settings, webhooks[]}`，见 [NOTIFY.md](NOTIFY.md) §4）。**不建表**——新增/删除 webhook 都只改这一个键 | 系统 → 通知 页 |
|
||||
| `step_defaults` | **步骤默认值**（JSON：`{步骤类型: {字段: 值}}`，见 [TASK_DEV.md](TASK_DEV.md) §3.1）。新建步骤时预填用。**只存与出厂值不同的字段**，这样以后调出厂默认能跟着走 | 任务 → 动作配置 页 |
|
||||
| `device_battery` | **电量监控配置**（JSON：`{enabled, low, critical, skip_charging, interval}`，见 [NOTIFY.md](NOTIFY.md) §3.1）。**只存与出厂值不同的字段**（出厂：`low=20 critical=10 skip_charging=true interval=60`）。**电量本身不落库**——只放采集线程的内存缓存（重启重新采一轮），所以没有对应表、不动备份覆盖清单 | 工具 → 设备发现 → 电量监控 |
|
||||
|
||||
> ⚠️ `agent_api_key` 是**明文存储**，导出备份的 zip 里也含它——备份预览会固定给出"含敏感信息"告警。
|
||||
> **同理 `notify_webhooks` 里的 webhook URL 本身就是凭据**（企业微信 `?key=`、钉钉 `?access_token=`、
|
||||
|
||||
@@ -54,6 +54,7 @@
|
||||
| 1 | **绝不 `adb kill-server`** | 会断掉所有设备的 adb transport，运行中任务全废 | `core/adb_helper.py` 只 connect 不 kill；Web 层硬拦截 `kill-server`/`disconnect` 字符串 |
|
||||
| 2 | **绝不对 `IP:5555` 设备 `adb disconnect`** | 该地址的 adb transport 是共享的 | `adb_disconnect` **全项目零调用方**；`STFDevice.release()` 空实现 |
|
||||
| 3 | **空闲设备扫描不主动 connect/disconnect** | 避免扰动共享连接 | 前台扫描对空闲设备直接返回"空闲"；设备发现用 socket 探测 |
|
||||
| 3b | （3 的边界）**只读 `adb -s <serial> shell …` 是允许的**，它不建立/断开 transport | 设备已在 `adb devices` 里就说明 transport 现成，读一下不扰动任何人 | 电量采集 `core/device_battery.py` 就是这么读**包括空闲设备在内**的全部在线设备（`dumpsys battery`，实测 0.2~0.35s/台）；**别"顺手"给它加 connect** |
|
||||
| 4 | **adb key 保持历史 key 不变** | 设备信任该 key，换 key 全部 `unauthorized` | 部署沿用 `~/.android/adbkey` |
|
||||
| 5 | **生产（220）默认只读** | 生产事故成本高 | 任何写操作（pull/重启/改文件）都需负责人确认 |
|
||||
| 6 | **新增持久化表必须进备份覆盖清单** | 漏登记 = 等于没备份 | `SUMMARY_TABLES` 已由模型元数据自动派生（加了 ORM 表就进清单）；**手工要做的只有补 `TABLE_LABELS` 中文标签**，详见 [DEPLOY.md](DEPLOY.md) §5.2 |
|
||||
|
||||
+26
-1
@@ -54,7 +54,7 @@ daemon 线程。所以：
|
||||
| 业务 | `task.selector.invalid`（选择器连续 10 次未命中——"任务成功但什么都没做"的隐蔽故障） |
|
||||
| 业务·任务自己发 | `task.notify.custom`（步骤「发通知」）/ `task.patrol.hit`（任务「公共巡检」命中）——**标题正文由任务自己写**，见下 |
|
||||
| Worker | `worker.connected` · `.attempt.done` · `.attempt.error`（单次尝试级，噪音大，默认没人勾） |
|
||||
| 设备 | `device.online` · `.offline` · `.discovered` · `.claimed` · `device.heartbeat_timeout` |
|
||||
| 设备 | `device.online` · `.offline` · `.discovered` · `.claimed` · `device.heartbeat_timeout` · `device.battery.low` · `.battery.recovered` |
|
||||
| 安装 | `apk.install.started` · `.finished` |
|
||||
| 系统 | `system.backup.exported` · `.imported` · `.restored` · `.restore_failed` · `service.started` · `.stopping` · `user.login` |
|
||||
| AI | `ai.audit.finished` · `.failed` · `.skipped` |
|
||||
@@ -106,6 +106,31 @@ daemon 线程。所以：
|
||||
- 谁能收到仍然只看 webhook 的**事件订阅**：想让某个群收任务自定义消息，就在那条
|
||||
webhook 上勾 `task.notify.custom` / `task.patrol.hit`。
|
||||
|
||||
### 3.1 设备电量告警（`device.battery.low` / `.battery.recovered`）
|
||||
|
||||
采集与判定都在 `core/device_battery.py`（后台线程 `device-battery`，默认 60s 一轮，
|
||||
`adb -s <serial> shell dumpsys battery` **只读**查询）。阈值配置在
|
||||
**「工具 → 设备发现 → 电量监控」**，存在 `app_meta.device_battery`（见 [DATA_MODEL.md](DATA_MODEL.md) §5）。
|
||||
|
||||
阈值语义（**这是唯一判定处，前端只读后端算好的 `tier` 上色**）：
|
||||
|
||||
| 档位 | 条件 | 通知 |
|
||||
|---|---|---|
|
||||
| `0` 正常 | `电量 >= 低电量阈值 + 5`（迟滞）或 充电中 | 从低/严重回到 0 → 发 `device.battery.recovered` |
|
||||
| `1` 低 | `严重阈值 < 电量 <= 低电量阈值` | **掉到这一档才发** `device.battery.low`（`warning`） |
|
||||
| `2` 严重 | `电量 <= 严重阈值` | 掉到这一档再发一次（`error`），阈值字段是严重阈值 |
|
||||
|
||||
- **迟滞 +5**：回升要到 `低电量阈值 + 5` 才算恢复。没有它，电量在阈值上下浮动
|
||||
（充电器接触不良）会反复告警。
|
||||
- **"充电中"看的是 `status:` 行**（`2` 充电中 / `5` 已充满），不是"插着电"。
|
||||
所以**"插着却没充电"**（劣质线、温控停充、满电停充 `status:4`）**仍然会告警**——
|
||||
那正是最该让人知道的情况。想连充电中一起报，把「充电中不告警」勾掉即可。
|
||||
- **重复提醒**：同一档位持续不恢复时，每 **6 小时**再提醒一次（`core/device_battery.RE_NOTIFY_S`）。
|
||||
- 只对**「设备池 ∩ 在线」**的设备告警：adb 里能看到但不归平台管的设备不吵人。
|
||||
- 一周内改了阈值**不用重启**：采集线程每轮重读配置，档位下一轮就按新阈值算。
|
||||
|
||||
排查：`logs/core.log` 搜 `core.battery`（每轮一行「电量采集完成: N/M 台」）。
|
||||
|
||||
---
|
||||
|
||||
## 4. 配置
|
||||
|
||||
+20
-1
@@ -13,6 +13,9 @@ function _sortValue(dev,key){
|
||||
// 按状态优先级排序：running>connecting>idle>done>error>released
|
||||
const order={running:0,connecting:1,idle:2,done:3,released:4,error:5,failed:6};
|
||||
v=order[dev.worker_status]||99;
|
||||
}else if(key==='battery'){
|
||||
// 没采到电量的排最后（用 -1 而不是 0，0% 是真实电量）
|
||||
v=dev.battery?dev.battery.level:-1;
|
||||
}else{
|
||||
v=dev[key]||'';
|
||||
}
|
||||
@@ -325,6 +328,22 @@ function renderDevices(){
|
||||
applyListPager('devices');
|
||||
initListSearch('devices','search-devices');
|
||||
}
|
||||
// 电量单元格：告警档位（tier 0 正常/1 低/2 严重）由后端算好，前端只上色——
|
||||
// 阈值只在「工具 → 设备发现 → 电量监控」一处定义，两边不重复判
|
||||
function _battCell(dev){
|
||||
const b=dev.battery;
|
||||
if(!b)return '<span class="text-muted">-</span>';
|
||||
const t=b.tier||0;
|
||||
const cls=t===2?'label-danger':(t===1?'label-warning':'label-success');
|
||||
const mins=b.at?Math.floor((Date.now()/1000-b.at)/60):-1;
|
||||
const ageTxt=(mins<0?'':(mins<1?'刚刚':mins+' 分钟前'));
|
||||
const chg=b.charging?' ⚡':'';
|
||||
const tip=(t===2?'电量严重不足':(t===1?'电量低':'电量正常'))
|
||||
+(b.charging?'（充电中）':'')+(ageTxt?'（'+ageTxt+'采集）':'')
|
||||
+(dev.present?'':'（设备已离线，显示最后一次读数）');
|
||||
const stale=dev.present?'':'<div style="font-size:11px;color:#94a3b8">'+ageTxt+'</div>';
|
||||
return '<span class="label '+cls+'" title="'+tip+'">'+b.level+'%'+chg+'</span>'+stale;
|
||||
}
|
||||
function renderDeviceRow(dev){
|
||||
const offline=dev.present?'':' <span class="label label-danger">离线</span>';
|
||||
const st=STATUS_MAP[dev.worker_status]||{t:dev.worker_status,c:'default'};
|
||||
@@ -366,7 +385,7 @@ function renderDeviceRow(dev){
|
||||
const checked=_selectedSerials.has(dev.serial)?'checked':'';
|
||||
const rowCls=_selectedSerials.has(dev.serial)?'row-checked':'';
|
||||
const cb='<input type="checkbox" '+checked+' onclick="toggleDevice(\''+esc(dev.serial)+'\',this.checked)">';
|
||||
return '<tr class="'+rowCls+'"><td class="col-cb">'+cb+'</td><td>'+devLabel+'</td><td>'+esc(dev.model)+'</td><td>'+wb+'</td><td>'+fg+'</td><td>'+prog+'</td><td>'+tname+retry+endInfo+'</td><td class="text-muted">'+esc(dev.current_action||'-')+warnInfo+'</td><td class="err-text" title="'+esc(dev.last_error||'')+'">'+esc(dev.last_error||'-')+'</td><td>'+btns+'</td></tr>';
|
||||
return '<tr class="'+rowCls+'"><td class="col-cb">'+cb+'</td><td>'+devLabel+'</td><td>'+esc(dev.model)+'</td><td>'+_battCell(dev)+'</td><td>'+wb+'</td><td>'+fg+'</td><td>'+prog+'</td><td>'+tname+retry+endInfo+'</td><td class="text-muted">'+esc(dev.current_action||'-')+warnInfo+'</td><td class="err-text" title="'+esc(dev.last_error||'')+'">'+esc(dev.last_error||'-')+'</td><td>'+btns+'</td></tr>';
|
||||
}
|
||||
|
||||
async function loadJobsForMonitor(){
|
||||
|
||||
@@ -43,6 +43,7 @@ async function loadToolsDevices(force){
|
||||
|
||||
// ================== 设备自动发现（扫描 → 待连接池 → 确认） ==================
|
||||
function loadDiscovery(){
|
||||
loadBattery(); // 电量监控与发现同住一个子面板，跟着它的 10s 轮询一起刷新状态行
|
||||
apiGet('/api/devices/discovery').then(r=>{
|
||||
if(!r||!r.ok)return;
|
||||
const status=document.getElementById('discovery-status');
|
||||
@@ -116,6 +117,62 @@ function loadDiscovery(){
|
||||
}
|
||||
});
|
||||
}
|
||||
// ================== 设备电量监控（定时采集 + 低电量告警） ==================
|
||||
// 电量本身随 /api/status 下发（监控页电量列 / 大屏卡片），这里只管配置与采集器状态。
|
||||
let _batteryLoaded=false; // 表单只回填一次：10s 轮询不能把用户正在输的值冲掉
|
||||
|
||||
function loadBattery(){
|
||||
apiGet('/api/devices/battery').then(r=>{
|
||||
if(!r||!r.ok)return;
|
||||
const en=document.getElementById('battery-enabled');
|
||||
if(!en)return; // 面板不在页面上
|
||||
const s=r.settings||{};
|
||||
if(!_batteryLoaded){
|
||||
en.checked=!!s.enabled;
|
||||
document.getElementById('battery-low').value=s.low;
|
||||
document.getElementById('battery-critical').value=s.critical;
|
||||
document.getElementById('battery-skip-charging').checked=!!s.skip_charging;
|
||||
document.getElementById('battery-interval').value=s.interval;
|
||||
_batteryLoaded=true;
|
||||
}
|
||||
const st=document.getElementById('battery-status');
|
||||
if(r.scanning)st.textContent='采集中...';
|
||||
else if(r.last_scan)st.textContent='上次采集 '+r.last_scan[0]+' · 成功 '+r.last_scan[1]+'/'+r.last_scan[2]+' 台';
|
||||
else st.textContent='尚未采集';
|
||||
});
|
||||
}
|
||||
|
||||
function saveBatterySettings(){
|
||||
const body={
|
||||
enabled:document.getElementById('battery-enabled').checked,
|
||||
low:document.getElementById('battery-low').value,
|
||||
critical:document.getElementById('battery-critical').value,
|
||||
skip_charging:document.getElementById('battery-skip-charging').checked,
|
||||
interval:document.getElementById('battery-interval').value,
|
||||
};
|
||||
apiPost('/api/devices/battery/settings',body).then(r=>{
|
||||
if(!r||!r.ok){showToast('保存失败: '+((r&&r.error)||''),'error');return;}
|
||||
showToast(r.msg||'已保存','success');
|
||||
// 回填后端钳制后的真实值（填 999 会被钳到 100，严重阈值高于低电量会被压回来）
|
||||
const s=r.settings;
|
||||
if(s){
|
||||
document.getElementById('battery-low').value=s.low;
|
||||
document.getElementById('battery-critical').value=s.critical;
|
||||
document.getElementById('battery-interval').value=s.interval;
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
function scanBatteryNow(){
|
||||
apiPost('/api/devices/battery/scan',{}).then(r=>{
|
||||
if(r&&r.ok){
|
||||
showToast(r.msg||'采集已启动','success');
|
||||
setTimeout(loadBattery,3000);
|
||||
if(typeof loadMonitor==='function')setTimeout(loadMonitor,3000); // 监控页设备表跟着更新
|
||||
}else showToast('采集失败: '+((r&&r.error)||''),'error');
|
||||
});
|
||||
}
|
||||
|
||||
function reconnectPoolDev(serial){
|
||||
apiPost('/api/devices/discovery/reconnect',{serial}).then(r=>{
|
||||
if(r&&r.ok){
|
||||
|
||||
@@ -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()">
|
||||
|
||||
@@ -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>':'');
|
||||
|
||||
+35
-1
@@ -4,7 +4,7 @@ from concurrent.futures import ThreadPoolExecutor, as_completed
|
||||
|
||||
from flask import Blueprint, jsonify, request
|
||||
|
||||
from core import device_pool, device_discovery
|
||||
from core import device_battery, device_pool, device_discovery
|
||||
from core.adb_helper import adb_connect, adb_connect_light
|
||||
from core.logger import get_logger
|
||||
from web.auth import perm_required, PERM_DEVICES
|
||||
@@ -411,6 +411,40 @@ def api_devices_discovery_settings():
|
||||
return jsonify({"ok": True, "msg": msg})
|
||||
|
||||
|
||||
# ================== API：设备电量（采集/阈值/告警） ==================
|
||||
# 电量本身通过 /api/status 随设备列表一起下发（大屏/监控同一份数据）；
|
||||
# 这里是它的配置与采集器状态。低电量告警走通知子系统（事件 device.battery.low）。
|
||||
@bp.route("/api/devices/battery", methods=["GET"])
|
||||
@perm_required(PERM_DEVICES)
|
||||
def api_devices_battery():
|
||||
"""电量采集器状态 + 当前配置（面板显示"上次采集 12:00 · 14/14 台"）。"""
|
||||
try:
|
||||
return jsonify({"ok": True, **device_battery.get_status()})
|
||||
except Exception as e:
|
||||
_log.warning(f"电量状态获取失败: {e}")
|
||||
return jsonify({"ok": False, "error": str(e)[:120]}), 503
|
||||
|
||||
|
||||
@bp.route("/api/devices/battery/settings", methods=["POST"])
|
||||
@perm_required(PERM_DEVICES)
|
||||
def api_devices_battery_settings():
|
||||
"""保存电量监控配置：{enabled?, low?, critical?, skip_charging?, interval?}。"""
|
||||
data = request.json or {}
|
||||
ok, msg, saved = device_battery.save_settings(data)
|
||||
if not ok:
|
||||
return jsonify({"ok": False, "error": msg}), 400
|
||||
return jsonify({"ok": True, "msg": msg, "settings": saved})
|
||||
|
||||
|
||||
@bp.route("/api/devices/battery/scan", methods=["POST"])
|
||||
@perm_required(PERM_DEVICES)
|
||||
def api_devices_battery_scan():
|
||||
"""立即采集一次（后台执行，约 1-3 秒；看「上次采集」或大屏刷新确认）。"""
|
||||
if not device_battery.scan_once():
|
||||
return jsonify({"ok": False, "error": "上一轮采集还没跑完，稍等一下"}), 409
|
||||
return jsonify({"ok": True, "msg": "采集已启动（约 1-3 秒）"})
|
||||
|
||||
|
||||
# ================== API：Tailscale 管理（仅管理员） ==================
|
||||
# 通过 Tailscale 官方 API v2 管理 tailnet 设备（列表/改名/授权/密钥不过期/删除/生成 auth key）。
|
||||
# 设备 IP 由 tailnet 自动分配，API 无法修改，列表只读展示。
|
||||
|
||||
@@ -98,6 +98,9 @@ device_pool.init_app(app)
|
||||
# 设备自动发现：定时扫描网段 → 待连接池（确认后才入池）
|
||||
from core import device_discovery
|
||||
device_discovery.init_app(app)
|
||||
# 设备电量采集：定时 dumpsys battery（只读）→ 内存缓存 → /api/status 展示 + 低电量告警
|
||||
from core import device_battery
|
||||
device_battery.init_app(app)
|
||||
mgr = TaskManager(app=app)
|
||||
# 设备换地址（认领/迁址）后同步分组与任务的引用：它们的"内存副本"在 TaskManager 里
|
||||
# （调度用内存对象），device_pool 只改库不改内存不生效，所以在此注册回调打通
|
||||
@@ -352,4 +355,5 @@ if __name__ == "__main__":
|
||||
pass
|
||||
mgr.shutdown()
|
||||
device_discovery.shutdown()
|
||||
device_battery.shutdown()
|
||||
_stop_uiauto()
|
||||
|
||||
Reference in New Issue
Block a user