fix(设备名): 选择设备与所有通知都显示名称而不是 IP

用户反馈：① 元素抓取的选择设备列表显示的是 IP；② 所有 webhook 通知里都是 IP；
要都显示设备名。

- 通知链路统一补名字（调用点不用动）：`core/notifier.py`
  · 新增 `set_device_name_resolver()` + `fill_device_names()`，在 `notify()` 与
    `build_message()`（预览/测试发送也走它）里把 `serial` 补成 `device_name`、
    把 `serials`/`devices` 列表逐项换成名字。
  · 补一处就全带名字了——标题主体、字段表、聚合样本认的都是 `device_name`。
  · **做成"纯内存回调"是刻意的**：notify() 的硬红线是零 DB，不能为了取个名字去查库
    （那等于在业务线程里加一次阻塞查询）。
  · 降级规则：调用点自己传了 device_name 就用它的；查不到名字（没命名/不在池里）
    保留原地址；解析器缺失或抛异常都只是降级，绝不影响发送。
- `core/device_pool.py`：维护 `serial → 名称` 内存快照——`init_app` 同步刷一次、
  增删改名/迁址后各刷一次（改名立刻生效）、`device-names` 线程每 60s 兜底刷一次
  （覆盖整库恢复这类进程外改动）。`name_of()` 只读内存，可在通知路径上安全调用。
- `web_server.py`：装配层接上 `notifier.set_device_name_resolver(device_pool.name_of)`。
- 元素抓取/测试此步骤的设备列表：`GET /api/uiauto/devices` 的 `name` 改用**平台名**，
  前端 `editor.js` 新增共用的 `_devCard()`——名字做主标题（粗体），
  `型号 · 地址` 作副标题。
  · 池外设备**退回地址而不是 uiautodev 的 name**：实测那份 name 是设备 codename
    （一柜子机器全叫 "earth"），拿它认设备等于没名字，地址至少唯一。
  · 「测试此步骤」的设备列表原来连状态角标都没有，一并统一成同一个卡片。
- 顺带修一个**既有 bug（不是本次需求）**：`/locate` 设备端定位页从 ce47a5b 那次
  web 蓝图拆分起就一直 500——拆分时漏掉了 `render_template_string` 与
  `markupsafe.escape as _esc` 两个 import。后者不只是缺个名字：定位页把 query 里的
  serial 拼进 HTML，而 `render_template_string` 的模板名是 "<template>"、
  **不会自动转义**，所以那还是个反射 XSS。已显式转义（已用 `<img onerror>` 验证）。

自测：device_pool 快照/改名即时生效、fill_device_names 全分支（含列表、
未命名保留地址、不在池保留地址、解析器缺失/抛异常降级）、真消息渲染断言
**通篇不含 IP**；GET 路由冒烟 54 个 0 个 500；前端语法 + 卡片渲染截图核对。

core/device_pool.py

@@ -39,13 +39,59 @@ def init_app(app):
     并后台刷新一次设备型号（首次启动/设备更换后型号可能变化）。"""
     global _app
     _app = app
+    refresh_names()          # 同步刷一次名称快照，让通知从第一条起就有名字
     try:
         t = threading.Thread(target=_refresh_models_bg, daemon=True)
         t.start()
+        t2 = threading.Thread(target=_names_loop, name="device-names", daemon=True)
+        t2.start()
     except Exception:
         pass
 
 
+# ================== 名称内存快照（给通知用） ==================
+# 为什么单独存一份：webhook 通知里要显示"是哪台设备"（A08）而不是地址（IP），
+# 但 `notifier.notify()` 有一条硬红线——**零 DB 访问**（不能为了取个名字去查库，
+# 更不能在业务线程里阻塞）。所以由这里维护一份 serial→名称 的内存快照：
+# 启动刷一次、池子有变动时刷一次、再兜底每 60s 刷一次（覆盖整库恢复等外部改动）。
+_names = {}
+_names_lock = threading.Lock()
+_NAMES_INTERVAL = 60
+
+
+def refresh_names():
+    """把设备池的 serial→名称刷进内存快照（只查库，不碰 adb）。返回条数。"""
+    try:
+        rows = list_devices()
+    except Exception as e:
+        _log.debug(f"刷新设备名快照失败: {e}")
+        return 0
+    m = {}
+    for d in rows:
+        s = d.get("serial") or ""
+        if s:
+            m[s] = d.get("name") or ""
+    with _names_lock:
+        _names.clear()
+        _names.update(m)
+    return len(m)
+
+
+def name_of(serial):
+    """serial 对应的设备名称（**纯内存，可在通知路径上调用**）。没有则返回 ""。"""
+    if not serial:
+        return ""
+    with _names_lock:
+        return _names.get(str(serial), "")
+
+
+def _names_loop():
+    """兜底定时刷新名称快照（覆盖整库恢复这类进程外改动）。"""
+    while True:
+        time.sleep(_NAMES_INTERVAL)
+        refresh_names()
+
+
 def _refresh_models_bg():
     """后台批量采集在线设备型号（启动时/手动触发）。失败静默，不影响启动。"""
     time.sleep(3)  # 等服务起来再查
@@ -183,6 +229,7 @@ def _move_device_row(old, new_serial, fingerprint=""):
     if fingerprint:
         old.fingerprint = fingerprint
     db.session.commit()
+    refresh_names()          # 键变了（serial → 名称的映射也跟着变）
     if _move_hook is not None:
         try:
             _move_hook(old_serial, new_serial)
@@ -255,11 +302,13 @@ def add_device(serial, name="", note="", enabled=True, fingerprint=""):
             if fingerprint:
                 d.fingerprint = fingerprint
             db.session.commit()
+            refresh_names()          # 名字可能改了：通知里要立刻用新名字
             return False
         db.session.add(Device(serial=serial, name=name or "", note=note or "",
                               enabled=enabled, fingerprint=fingerprint or "",
                               created_at=time.strftime("%Y-%m-%d %H:%M")))
         db.session.commit()
+        refresh_names()
         _log.info(f"设备池新增设备: {serial}")
         return True
 
@@ -274,6 +323,7 @@ def rename_device(serial, name):
         old = d.name or ""
         d.name = name
         db.session.commit()
+        refresh_names()
         _log.info(f"设备池重命名: {old or serial} → {name}（{serial}）")
         return True
 
@@ -301,6 +351,7 @@ def remove_device(serial):
             return False
         db.session.delete(d)
         db.session.commit()
+        refresh_names()
         _log.info(f"设备池删除设备: {serial}")
         return True
 

core/notifier.py

@@ -356,6 +356,53 @@ def _label(k):
     return _FIELD_LABELS.get(k, k)
 
 
+# ================== 设备名解析（让通知显示名字而不是 IP） ==================
+# 由装配层注册（web_server.py）：`notifier.set_device_name_resolver(device_pool.name_of)`。
+# **刻意做成"纯内存回调"**：notify() 的红线是零 DB——不能为了取个名字去查库。
+# 快照由 device_pool 维护（启动/池子变动/每 60s 兜底刷新）。
+_device_name_fn = None
+
+
+def set_device_name_resolver(fn):
+    """注册 serial → 设备名 的解析器。必须是**纯内存**实现（不得查库/发请求）。"""
+    global _device_name_fn
+    _device_name_fn = fn
+
+
+def _dev_name(serial):
+    """尽力把地址解析成设备名；解析不到返回 ""（调用方保留原值）。"""
+    if not serial or _device_name_fn is None:
+        return ""
+    try:
+        return str(_device_name_fn(str(serial)) or "")
+    except Exception:
+        return ""
+
+
+def fill_device_names(fields):
+    """把 fields 里的设备地址补成设备名（**原地改**，返回同一个 dict）。
+
+    两类字段：
+      · `serial` → 补 `device_name`（原来没填才补）——标题主体、字段表、
+        聚合样本认的都是 `device_name`，补上这一处就全带名字了；
+      · `serials` / `devices`（多设备事件，如设备断联）→ 逐项换成名字，
+        通知里不该出现一串 IP。
+    查不到名字（设备没命名 / 已不在池里）就**保留原值**，绝不把内容弄丢。
+    """
+    if not isinstance(fields, dict):
+        return fields
+    s = fields.get("serial")
+    if s and not fields.get("device_name"):
+        n = _dev_name(s)
+        if n:
+            fields["device_name"] = n
+    for k in ("serials", "devices"):
+        v = fields.get(k)
+        if isinstance(v, (list, tuple)) and v:
+            fields[k] = [_dev_name(x) or x for x in v]
+    return fields
+
+
 def _subject(ev, fields):
     """标题主体：**用户自己写的 title 优先**，其次任务名，再次设备名/serial。"""
     if fields.get("title"):
@@ -373,6 +420,7 @@ def _subject(ev, fields):
 def build_message(ev, fields, hook=None):
     """把事件渲染成统一消息体（title/summary/fields/level/markdown）。"""
     fields = dict(fields or {})
+    fill_device_names(fields)     # 同 notify()：预览/测试发送也要显示设备名
     merged = fields.pop("_merged", None)
     level = _level_of(ev.key, fields)
     subj = _subject(ev, fields)
@@ -1007,6 +1055,7 @@ def notify(event, **fields):
                                                  for p in h["events"])]
         if not hooks:
             return
+        fill_device_names(fields)   # 地址 → 设备名（纯内存快照，不查库）
         for h in hooks:
             keys = tuple(str(fields.get(k, "")) for k in (ev.agg_key or ()))
             # 聚合窗口：事件自己声明「立即发」（agg_window=0，低频高危事件，如批次结束 /

doc/API.md

@@ -567,7 +567,7 @@
 | 接口 | 请求 | 响应要点 |
 |------|------|---------|
 | `GET /api/uiauto/status` | — | uiautodev（:20242）是否在跑，前端据此禁/启用"抓取元素" |
-| `GET /api/uiauto/devices` | — | 可选设备列表（uiautodev 设备 + 池内在线补全） |
+| `GET /api/uiauto/devices` | — | 可选设备列表（uiautodev 设备 + 池内在线补全）。每项 `{serial, name, model, product, status}`；**`name` 是平台给设备起的名字**（`cs1`/`A08`），池外设备退回 `serial`——uiautodev 自带的 name 是设备 codename（实测一柜子全是 `earth`），不能用来认设备 |
 | `GET /api/uiauto/elements?serial=` | — | 扁平元素列表（走 uiautodev），每项带 `suggested`、`bounds`、`depth` |
 | `GET /api/uiauto/snapshot?serial=` | — | **一次取齐**：截图 + 元素树（原生 u2 同一连接背靠背）→ `{image,width,height,elements,unstable,screen_state,cost_ms}`；抓取弹窗与 MCP 的 `de_snapshot` 都用它，失败返回 **502** |
 | `GET /api/uiauto/screenshot?serial=` | — | JPEG |

doc/ARCHITECTURE.md

@@ -79,7 +79,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`（**刷一次 `serial→名称` 内存快照** + **起线程**：3s 后采集型号、另起 `device-names` 每 60s 刷名称）；`device_discovery.init_app`（**起常驻扫描线程**）；`TaskManager(app=app)`（APScheduler + 看门狗 + 从库加载分组/任务 + 重注册 cron）；`ApkManager(app=app)`；`notifier.set_device_name_resolver(device_pool.name_of)`（通知里显示设备名而不是 IP，见 [NOTIFY.md](NOTIFY.md) §7） |
 
 ### 2.3 阶段 E~G：蓝图、巡检调度器、真正启动
 
@@ -104,6 +104,7 @@
 | **巡检调度器** `BackgroundScheduler` | `web_server.py` | 经验库 AI 巡检 | 每日 03:47 |
 | `worker-watchdog` | `start_watchdog()` | `running/connecting` 心跳超时 → 标 `error` | 30s 检查 / 120s 阈值 |
 | `device-discovery` | `device_discovery.init_app` | 网段扫描 + 断联重连 | 首轮延迟 15s，之后 interval（默认 60s） |
+| `device-names` | `device_pool.init_app` | 刷 `serial → 名称` 内存快照（通知显示设备名用；只查库） | 60s（另有启动/增删改名时主动刷） |
 | `_refresh_models_bg` | `device_pool.init_app` | 启动后采集全部在线设备型号 | 一次性（3s 后） |
 | `BaseWorker` × N | `TaskManager._run_with_retry` | 单设备任务执行 | 任务期 |
 | `_run_with_retry` × N | 同上 | 单设备重试循环 | 任务期 |
@@ -294,7 +295,7 @@ connecting ──获取设备──▶ u2 连接 ──▶ running ──▶ set
 | `markdown.js` | 轻量 Markdown 渲染（`renderMarkdown`） | 无 CDN 依赖；**先转义再套标记** |
 | `list.js` | 统一列表组件：搜索 + 分页 + 排序 | 状态注册表 `_LIST_PAGERS`；`setListPager` **不重置**页码/搜索/排序（避免轮询刷新打断用户） |
 | `monitor.js` | 监控页：设备表、批量操作、异常汇总、任务概况卡片（含覆盖设备 chip） | 5s 轮询 + 脏检查（签名不变不重渲染） |
-| `editor.js` | 步骤编辑器（拖拽 / 参数表单 / 条件分支 / 元素抓取 / 测试此步骤）+ `saveTask` | 最大的前端文件；`_stepEditor` 单例 |
+| `editor.js` | 步骤编辑器（拖拽 / 参数表单 / 条件分支 / 元素抓取 / 测试此步骤）+ `saveTask` | 最大的前端文件；`_stepEditor` 单例；设备选择卡 `_devCard` 供「抓取元素」「测试此步骤」共用（**名字优先**，型号·地址作副标题） |
 | `tasks.js` | 任务 Tab：任务 CRUD / 调度解析 / 运行窗口 + 自定义动作 | |
 | `tools.js` | 工具 Tab：剪贴板、adb 终端、Tailscale、设备池、自动发现、远程看屏 | |
 | `apps.js` | 应用管理：APK 上传/安装/删除、设备已装应用 | |

doc/NOTIFY.md

@@ -222,6 +222,23 @@ Bark `/…/<key>`、Slack `/services/T…/B…/X…`）→ 接口回显、发送
 - 事件的 `fields` 是前端字段表与模板占位符的白名单，只写真正有用的
 - 高频事件（每台设备/每次尝试都会发生的）把 `agg_window` 设大一点或 `recommend=False`
 
+**设备一律只传 `serial`，名字自动补**（不用每个调用点自己去查名字）：
+
+群消息里没人想看 `192.168.20.110:5555`，要看「A09」。这件事在通知链路里
+**统一做掉**，调用点照旧只传 `serial` 就行：
+
+| 环节 | 做什么 |
+|---|---|
+| `core/device_pool.py` | 维护一份 `serial → 名称` 的**内存快照**：启动刷一次、池子增删改名/迁址时刷一次、每 60s 兜底刷一次（覆盖整库恢复这类进程外改动） |
+| `web_server.py` | `notifier.set_device_name_resolver(device_pool.name_of)` 把快照接给通知 |
+| `core/notifier.py` | `fill_device_names()` 在 `notify()` 与 `build_message()` 里把 `serial` 补成 `device_name`、把 `serials`/`devices` 列表逐项换成名字 |
+
+为什么绕这一圈：`notify()` 的红线是**零 DB**，不能为了取个名字去查库（那等于在业务
+线程里加一次阻塞查询）。所以名字由 `device_pool` 预先算好放内存，`notifier` 只读。
+
+降级规则（**绝不把内容弄丢**）：调用点自己传了 `device_name` 就用它的；查不到名字
+（设备没命名 / 已不在池里）就保留原来的地址。解析器缺失或抛异常都只是降级，不影响发送。
+
 ---
 
 ## 8. 排障

static/admin/editor.js

@@ -592,10 +592,7 @@ var _stepEditor={
       if(!list)return;
       if(!r||!r.ok){list.innerHTML='<div class="se-empty">'+esc((r&&r.error)||'获取设备失败')+'</div>';return;}
       list.innerHTML=(r.devices||[]).map(function(d){
-        return '<div class="el-device-card" onclick="_stepEditor._runTestStep(\''+esc(d.serial)+'\')">'+
-          '<div class="edc-icon">📱</div>'+
-          '<div class="edc-info"><div class="edc-serial">'+esc(d.serial)+'</div>'+
-          '<div class="edc-model">'+esc(d.model||d.product||'')+'</div></div></div>';
+        return self._devCard(d, "_stepEditor._runTestStep('"+esc(d.serial)+"')");
       }).join('')||'<div class="se-empty">无可用设备</div>';
     });
   },
@@ -918,8 +915,20 @@ var _stepEditor={
     // 直接弹设备选择页（独立模态框，不影响任务编辑窗口）
     this._showDevicePicker();
   },
+  // 设备选择卡片（「抓取元素」与「测试此步骤」两处共用）：
+  // **设备名优先**，型号与地址降为副标题——同型号好几台时只有平台起的名字
+  // （A08）能认出"是哪一台"，光看 IP 选错设备是常事。
+  _devCard:function(d,onclick){
+    var sub=[d.model||d.product||'', d.serial||''].filter(Boolean).join(' · ');
+    return '<div class="el-device-card" onclick="'+onclick+'">'+
+      '<div class="edc-icon">📱</div>'+
+      '<div class="edc-info"><div class="edc-name">'+esc(d.name||d.serial)+'</div>'+
+      '<div class="edc-serial">'+esc(sub)+'</div></div>'+
+      (d.status?'<span class="edc-status">'+esc(d.status)+'</span>':'')+'</div>';
+  },
   // 步骤1：设备选择页
   _showDevicePicker:function(){
+    var self=this;
     document.getElementById('el-picker-title').textContent='抓取元素 - 选择设备';
     document.getElementById('el-picker-body').innerHTML='<div class="el-device-grid"><div class="egd-title">选择要抓取元素的设备</div><div id="el-device-list">加载中...</div></div>';
     document.getElementById('el-picker-footer').innerHTML='<button class="btn" onclick="closeElPicker()">取消</button>';
@@ -930,11 +939,7 @@ var _stepEditor={
       var devices=res.devices||[];
       if(!devices.length){list.innerHTML='<div class="se-empty">uiauto2 未发现已连接设备</div>';return;}
       list.innerHTML=devices.map(function(d){
-        return '<div class="el-device-card" onclick="_stepEditor._showElPicker(\''+esc(d.serial)+'\')">'+
-          '<div class="edc-icon">📱</div>'+
-          '<div class="edc-info"><div class="edc-serial">'+esc(d.serial)+'</div>'+
-          '<div class="edc-model">'+esc(d.model||d.product||'')+'</div></div>'+
-          '<span class="edc-status">'+esc(d.status||'device')+'</span></div>';
+        return self._devCard(d, "_stepEditor._showElPicker('"+esc(d.serial)+"')");
       }).join('');
     }).catch(function(e){
       document.getElementById('el-device-list').innerHTML='<div class="se-empty">请求失败: '+esc(e)+'<br><button class="btn btn-sm" style="margin-top:10px" onclick="_stepEditor._showDevicePicker()">重试</button></div>';

templates/admin/monitor.html

@@ -309,7 +309,8 @@ body{background:var(--bg);font-family:var(--body);color:var(--text);font-size:14
 .el-device-card:hover{border-color:var(--primary);box-shadow:var(--shadow-md);transform:translateY(-1px)}
 .el-device-card .edc-icon{width:36px;height:36px;background:#f1efe8;border-radius:8px;display:flex;align-items:center;justify-content:center;font-size:18px;flex-shrink:0}
 .el-device-card .edc-info{flex:1}
-.el-device-card .edc-serial{font-size:13px;font-weight:600;color:var(--text);font-family:var(--mono)}
+.el-device-card .edc-name{font-size:13.5px;font-weight:700;color:var(--text)}
+.el-device-card .edc-serial{font-size:12px;color:var(--text-light);margin-top:2px;font-family:var(--mono)}
 .el-device-card .edc-model{font-size:12px;color:var(--text-light);margin-top:2px}
 .el-device-card .edc-status{font-size:11px;padding:2px 10px;border-radius:99px;background:var(--success-soft);color:#15803d;flex-shrink:0;font-weight:600}
 .el-picker-main{display:flex;flex:1;overflow:hidden}

web/monitor.py

@@ -6,8 +6,13 @@ import subprocess
 import shlex
 from concurrent.futures import ThreadPoolExecutor, as_completed
 
-from flask import (Blueprint, jsonify, request, Response, render_template)
+from flask import (Blueprint, jsonify, request, Response, render_template,
+                   render_template_string)
 from flask_login import login_required
+# /locate 定位页要把 serial 拼进 HTML，而 render_template_string 的模板名是
+# "<template>"、**不会自动转义**（serial 来自 query，不转义就是一个反射 XSS），
+# 所以这里显式转义。blueprint 拆分时漏掉了这两个 import，/locate 一直 500。
+from markupsafe import escape as _esc
 
 from core import device_pool
 from core.adb_helper import (screenshot, list_installed_apps, adb_connect,

web/tasks_api.py

@@ -459,6 +459,16 @@ def api_uiauto_devices():
         })
         seen.add(serial)
         added += 1
+    # 设备名用**平台起的名字**（A08 / cs1）：uiautodev 那份 name 是设备自己的
+    # codename（实测一柜子机器全叫 "earth"），同型号好几台时等于没有——
+    # 而抓取元素/试执行必须选对设备，所以池外设备宁可退回地址（地址至少唯一）。
+    try:
+        names = {d["serial"]: (d.get("name") or "") for d in device_pool.list_devices()}
+    except Exception:
+        names = {}
+    for d in data:
+        s = d.get("serial") or ""
+        d["name"] = names.get(s) or s
     if added:
         _log.info(f"抓取元素设备列表补全 {added} 台在线设备: {list(seen)}")
     return jsonify({"ok": True, "devices": data})

web_server.py

@@ -102,6 +102,9 @@ mgr = TaskManager(app=app)
 # 设备换地址（认领/迁址）后同步分组与任务的引用：它们的"内存副本"在 TaskManager 里
 # （调度用内存对象），device_pool 只改库不改内存不生效，所以在此注册回调打通
 device_pool.set_move_hook(mgr.sync_device_serial)
+# 通知里要显示设备名（A08）而不是地址（IP）：notifier 只读 device_pool 的**内存**名称
+# 快照，不查库（notify 的红线是零 DB）。快照在 device_pool.init_app 里已刷过一次。
+_notifier.set_device_name_resolver(device_pool.name_of)
 apk_mgr = ApkManager(app=app)
 
 # Web 层按模块拆分（web/ 蓝图包）：认证/监控/任务/管理/工具/设备池/APK/Tailscale