"""设备池管理 API(本地 SQLite 清单)。""" import threading from concurrent.futures import ThreadPoolExecutor, as_completed from flask import Blueprint, jsonify, request 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 _log = get_logger("web") bp = Blueprint("devices", __name__) def _lan_ip(): """挑一个手机连得上的本机地址:优先 192.168.x,其次 10.x。 不能用 gethostbyname(hostname) —— 这台机器上它可能返回 Tailscale 的 100.x(CGNAT 地址,手机不在 tailnet 里根本连不上),或 docker 的 172.17。 """ import socket candidates = [] try: for info in socket.getaddrinfo(socket.gethostname(), None, socket.AF_INET): ip = info[4][0] if ip.startswith("127.") or ip.startswith("169.254."): continue candidates.append(ip) except Exception: pass for ip in candidates: if ip.startswith("192.168."): return ip for ip in candidates: if ip.startswith("10."): return ip return candidates[0] if candidates else "本机IP" @bp.route("/api/devices/qrcode") @perm_required(PERM_DEVICES) def api_devices_qrcode(): """给某台设备生成「配置二维码」——设备端 Agent 扫一下就把自己配好。 二维码里是一段 JSON(平台地址 + 设备令牌 + 这台设备的指纹),扫码即完成: 填 server/token/指纹 三件事,不用在手机上打字,也不用连 adb。 ⚠️ 两条使用前提(都会在返回里给提示,不静默失败): 1. 平台要先在「应用管理 → 设备端应用商店」启用(令牌是从那儿来的) 2. **要用局域网地址打开本页面**(二维码里的地址取自当前访问地址; 如果你是用 localhost 打开的,手机会连不上,这里会明确告诉你) """ import base64 import io import json as _json serial = (request.args.get("serial") or "").strip() if not serial: return jsonify({"ok": False, "error": "缺少 serial"}), 400 dev = None for d in device_pool.list_devices(): if d.get("serial") == serial: dev = d break if dev is None: return jsonify({"ok": False, "error": "设备不在池里"}), 404 # 令牌必须先启用设备端商店才有 from core.db_config import meta_get from web.device_agent_api import store_enabled, ensure_token if not store_enabled(): return jsonify({"ok": False, "error": "还没启用设备端商店:先到「应用管理 → 设备端应用商店」勾选启用"}), 400 token = ensure_token() server = request.host_url.rstrip("/") warn = "" if "127.0.0.1" in server or "localhost" in server: warn = ("你现在是用本机地址打开平台的,二维码里的地址手机会连不上 —— " "请改用局域网地址(如 http://%s:18050)重新打开本页再生成。" % _lan_ip()) fp = dev.get("fingerprint") or "" if not fp: warn = (warn + " " if warn else "") + \ "这台设备还没采集到指纹,扫码后平台认不出它是哪一台(设备端会显示「未登记」);" \ "建议先让它在线并刷新一次型号/指纹,再生成二维码。" payload = {"v": 1, "server": server, "token": token, "fingerprint": fp, "name": dev.get("name") or ""} text = _json.dumps(payload, ensure_ascii=False, separators=(",", ":")) try: import qrcode img = qrcode.make(text) buf = io.BytesIO() img.save(buf, format="PNG") png = "data:image/png;base64," + base64.b64encode(buf.getvalue()).decode() except Exception as e: _log.error(f"生成二维码失败: {e}") return jsonify({"ok": False, "error": f"生成二维码失败: {e}"}), 500 _log.info(f"生成设备配置二维码: {dev.get('name') or serial}") return jsonify({"ok": True, "serial": serial, "name": dev.get("name") or "", "fingerprint": fp, "png": png, "payload": text, "warn": warn}) @bp.route("/api/devices/pool", methods=["GET"]) @perm_required(PERM_DEVICES) def api_devices_pool_list(): """设备池清单(SQLite,含实时在线状态)。""" try: online = set(device_pool.list_online()) except Exception: online = set() rows = device_pool.list_devices() for r in rows: r["online"] = r["serial"] in online return jsonify({"ok": True, "devices": rows}) @bp.route("/api/devices/pool/add", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_pool_add(): """添加/更新设备:{serial, name, note?}。 **名称必填且唯一**(设备在平台里的身份标识,分组/任务/日志都靠它认设备)。 IP:5555 设备添加后立即尝试 adb connect 并读取**设备指纹**:若指纹命中池中已有 设备(同一台设备换了 IP),自动**认领**——迁移旧记录(保留原名)并同步 分组与任务里的引用,而不是新增一条。 """ data = request.json or {} serial = (data.get("serial") or "").strip() if not serial: return jsonify({"ok": False, "error": "请输入设备 serial(如 100.100.10.20:5555)"}), 400 name = (data.get("name") or "").strip() note = (data.get("note") or "").strip() if not name: return jsonify({"ok": False, "error": "请填写设备名称——名称是设备在平台里的唯一标识" "(分组、任务目标、日志都用它认设备)"}), 400 # 重名先查(放在 adb 之前:连不上的 IP 不该让用户白等) if device_pool.name_taken(name, exclude_serial=serial): return jsonify({"ok": False, "error": f"名称『{name}』已被其它设备占用,请换一个"}), 400 # 轻量 connect(单次、短超时,不用 5 次重试的 adb_connect,避免不可达设备把接口卡住) if ":" in serial: try: adb_connect_light(serial) except Exception: pass fp = device_pool.read_fingerprint(serial) if ":" in serial else "" claimed_old, claimed_name = device_pool.claim_device(serial, fp) if fp else (None, "") # 认领时保留设备**原有名称**(身份优先于本次输入),没有原名才用输入值 use_name = (claimed_name or name).strip() if use_name != name and device_pool.name_taken(use_name, exclude_serial=serial): return jsonify({"ok": False, "error": f"名称『{use_name}』已被其它设备占用,请换一个"}), 400 is_new = device_pool.add_device(serial, name=use_name, note=note, fingerprint=fp) # 后台采集型号 + 指纹(不阻塞添加响应) threading.Thread(target=device_pool.refresh_info, args=(serial,), daemon=True).start() if claimed_old: msg = (f"已认领:这是『{use_name}』(原地址 {claimed_old})," f"分组与任务的引用已自动同步") else: msg = "已添加" if is_new else "已更新" _log.info(f"设备池管理: {msg} {serial} name={use_name}") return jsonify({"ok": True, "msg": msg, "is_new": is_new, "claimed": bool(claimed_old), "old_serial": claimed_old or ""}) @bp.route("/api/devices/pool/rename", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_pool_rename(): """重命名设备:{serial, name}。名称必填且唯一。""" data = request.json or {} serial = (data.get("serial") or "").strip() name = (data.get("name") or "").strip() if not serial or not name: return jsonify({"ok": False, "error": "缺少 serial 或 name"}), 400 if device_pool.name_taken(name, exclude_serial=serial): return jsonify({"ok": False, "error": f"名称『{name}』已被其它设备占用,请换一个"}), 400 if not device_pool.rename_device(serial, name): return jsonify({"ok": False, "error": "设备不存在"}), 404 return jsonify({"ok": True, "msg": f"已重命名为『{name}』"}) @bp.route("/api/devices/pool/relocate", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_pool_relocate(): """人工认领(换地址兜底):{old_serial, new_serial}。 用于设备换了 IP 但**旧地址已断联、指纹也没采过**、自动认领无从匹配时: 由人工指认"这条记录就是那台设备,现在在新地址",迁移并同步分组/任务引用。 """ data = request.json or {} old_serial = (data.get("old_serial") or "").strip() new_serial = (data.get("new_serial") or "").strip() if not old_serial or not new_serial: return jsonify({"ok": False, "error": "缺少 old_serial 或 new_serial"}), 400 if ":" in new_serial: try: adb_connect_light(new_serial) except Exception: pass fp = device_pool.read_fingerprint(new_serial) if ":" in new_serial else "" ok, name, msg = device_pool.relocate_device(old_serial, new_serial, fingerprint=fp) if not ok: return jsonify({"ok": False, "error": msg}), 400 # 新地址若在待连接池里,一并清掉(已经是池内设备了) try: device_discovery.ignore_pending(new_serial) except Exception: pass threading.Thread(target=device_pool.refresh_info, args=(new_serial,), daemon=True).start() _log.info(f"设备池管理: 人工认领 {old_serial} → {new_serial}({name})") return jsonify({"ok": True, "msg": msg, "name": name}) @bp.route("/api/devices/pool/remove", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_pool_remove(): """从设备池删除(不再参与调度;不影响其他系统)。""" serial = (request.json or {}).get("serial", "").strip() if not serial: return jsonify({"ok": False, "error": "缺少 serial"}), 400 ok = device_pool.remove_device(serial) if not ok: return jsonify({"ok": False, "error": "设备不存在"}), 404 return jsonify({"ok": True, "msg": "已删除"}) @bp.route("/api/devices/pool/toggle", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_pool_toggle(): """启用/停用设备(停用后不参与调度)。""" data = request.json or {} serial = (data.get("serial") or "").strip() enabled = data.get("enabled") if not serial or enabled is None: return jsonify({"ok": False, "error": "缺少参数"}), 400 ok = device_pool.set_enabled(serial, bool(enabled)) if not ok: return jsonify({"ok": False, "error": "设备不存在"}), 404 return jsonify({"ok": True, "msg": "已" + ("启用" if enabled else "停用")}) @bp.route("/api/devices/pool/reconnect", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_pool_reconnect(): """一键重连:并发 adb connect 池内全部 IP:5555 设备(后台执行,不阻塞)。""" def _run(): try: serials = [s for s in device_pool.list_configured() if ":" in s] except Exception: return if not serials: return from concurrent.futures import ThreadPoolExecutor, as_completed with ThreadPoolExecutor(max_workers=10) as pool: futures = {pool.submit(adb_connect, s): s for s in serials} for _ in as_completed(futures): pass _log.info(f"设备池一键重连完成({len(serials)} 台)") # 重连后顺手刷新型号 try: device_pool.refresh_all_models() except Exception: pass import threading threading.Thread(target=_run, daemon=True).start() return jsonify({"ok": True, "msg": "重连已启动(后台并发,约 10-20 秒)"}) @bp.route("/api/devices/pool/refresh_models", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_pool_refresh_models(): """批量采集池内在线设备的型号(后台执行,不阻塞)。""" import threading threading.Thread(target=device_pool.refresh_all_models, daemon=True).start() return jsonify({"ok": True, "msg": "型号采集已启动(后台并发,约 10 秒)"}) # ================== API:设备自动发现(扫描 → 待连接池 → 确认) ================== # 扫描只把设备放进待连接池(pending),用户确认后才加入正式设备池并连接。 @bp.route("/api/devices/discovery", methods=["GET"]) @perm_required(PERM_DEVICES) def api_devices_discovery(): """发现状态 + 待连接列表 + 正式池断联设备(前端 10s 轮询一次请求)。""" try: status = device_discovery.get_status() pending = device_discovery.list_pending() pool_offline = device_discovery.list_pool_offline() except Exception as e: _log.warning(f"discovery 状态获取失败: {e}") return jsonify({"ok": False, "error": str(e)[:120]}), 503 status["pending"] = pending status["pool_offline"] = pool_offline return jsonify({"ok": True, **status}) @bp.route("/api/devices/discovery/scan", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_discovery_scan(): """手动触发一轮扫描(后台执行,约 5-30 秒)。""" ok, result = device_discovery.scan_once(manual=True) if not ok: return jsonify({"ok": False, "error": result.get("error", "扫描失败")}), 409 if "error" in result: return jsonify({"ok": False, "error": result["error"]}), 400 return jsonify({"ok": True, "msg": "扫描已启动(后台执行,约 5-30 秒)", "result": result}) @bp.route("/api/devices/discovery/confirm", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_discovery_confirm(): """确认连接:待连接 → 正式设备池 + 后台 adb connect + 采型号。 名称规则:**新设备必须填名称**;若指纹命中池中已有设备(同一台换了 IP), 则不需要名称——保留原记录与原名,并把分组/任务引用同步到新地址。 """ data = request.json or {} serial = (data.get("serial") or "").strip() name = (data.get("name") or "").strip() if not serial: return jsonify({"ok": False, "error": "缺少 serial"}), 400 if ":" in serial: try: adb_connect_light(serial) except Exception: pass fp = device_pool.read_fingerprint(serial) if ":" in serial else "" matched = device_pool.find_by_fingerprint(fp) if fp else None in_pool = serial in device_pool.list_configured() if not in_pool and not matched and not name: return jsonify({"ok": False, "error": "请为该设备填写名称(名称是设备在平台里的唯一标识)"}), 400 if name and device_pool.name_taken(name, exclude_serial=serial if in_pool else ""): return jsonify({"ok": False, "error": f"名称『{name}』已被其它设备占用,请换一个"}), 400 ok, msg, is_new = device_discovery.confirm_pending(serial, name=name, fingerprint=fp) if not ok: return jsonify({"ok": False, "error": msg}), 404 if ":" in serial: def _connect(): try: adb_connect(serial) except Exception: pass try: device_pool.refresh_info(serial) except Exception: pass threading.Thread(target=_connect, daemon=True).start() _log.info(f"设备池管理: 发现确认 {serial}") return jsonify({"ok": True, "msg": msg, "is_new": is_new}) @bp.route("/api/devices/discovery/ignore", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_discovery_ignore(): """忽略:从待连接池删除(下轮扫描可能再次发现)。""" serial = (request.json or {}).get("serial", "").strip() if not serial: return jsonify({"ok": False, "error": "缺少 serial"}), 400 ok, msg = device_discovery.ignore_pending(serial) if not ok: return jsonify({"ok": False, "error": msg}), 404 return jsonify({"ok": True, "msg": msg}) @bp.route("/api/devices/discovery/reconnect", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_discovery_reconnect(): """手动立即重连正式池断联设备(后台 adb connect + 采型号)。 日常无需手动——发现线程每轮(默认 60s)自动重连断联设备; 本端点用于不想等下一轮扫描时立即拉起。 """ serial = (request.json or {}).get("serial", "").strip() if not serial: return jsonify({"ok": False, "error": "缺少 serial"}), 400 from core import device_pool if serial not in device_pool.list_configured(): return jsonify({"ok": False, "error": "设备不在设备池中"}), 404 def _reconnect(): try: if ":" in serial: adb_connect(serial) # 无论是否连上,采一次型号(模型失败静默) try: device_pool.refresh_model(serial) except Exception: pass except Exception as e: _log.warning(f"手动重连 {serial} 异常: {e}") threading.Thread(target=_reconnect, daemon=True).start() _log.info(f"设备池管理: 手动重连 {serial}") return jsonify({"ok": True, "msg": "重连已启动(约 5-15 秒生效)"}) @bp.route("/api/devices/discovery/settings", methods=["POST"]) @perm_required(PERM_DEVICES) def api_devices_discovery_settings(): """保存发现配置(部分字段更新):{enabled?, subnets?, interval?, port?}。""" data = request.json or {} ok, msg = device_discovery.save_settings( enabled=data.get("enabled"), subnets=data.get("subnets"), interval=data.get("interval"), port=data.get("port"), auto_claim=data.get("auto_claim")) if not ok: return jsonify({"ok": False, "error": msg}), 400 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 无法修改,列表只读展示。