From c111cb9a5e1a927a7f4b1189c51409ad781a05fe Mon Sep 17 00:00:00 2001
From: butubb <1422726308@qq.com>
Date: Mon, 17 Aug 2026 11:02:43 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20STF=E6=9C=AA=E5=B0=B1=E7=BB=AA=E8=AE=BE?=
 =?UTF-8?q?=E5=A4=87=E7=BA=B3=E5=85=A5=E7=BB=B4=E6=8A=A4=E7=BB=88=E7=AB=AF?=
 =?UTF-8?q?=E5=88=97=E8=A1=A8=EF=BC=88adb=E5=8F=AF=E8=BE=BE=E4=BD=86agent?=
 =?UTF-8?q?=E5=90=AF=E5=8A=A8=E5=A4=B1=E8=B4=A5=EF=BC=8C=E6=A0=87=E8=AE=B0?=
 =?UTF-8?q?stf=5Fnot=5Fready=EF=BC=89+=20=E5=8D=B8=E8=BD=BD/=E6=A3=80?=
 =?UTF-8?q?=E6=9F=A5agent=E8=87=AA=E5=8A=A8=E5=85=88connect?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 static/admin/tools.js        | 17 +++++++++++++----
 templates/admin/monitor.html |  4 ++--
 web_server.py                | 13 +++++++++++--
 3 files changed, 26 insertions(+), 8 deletions(-)

diff --git a/static/admin/tools.js b/static/admin/tools.js
index 679efe5..2c59ec0 100644
--- a/static/admin/tools.js
+++ b/static/admin/tools.js
@@ -29,7 +29,7 @@ async function loadToolsDevices(force){
     return;
   }
   wrap.innerHTML = _clipDevices.map(d=>{
-    const st = d.state==='stf' ? 'STF池' : (d.state==='device' ? '已连接' : d.state);
+    const st = d.state==='stf' ? 'STF池' : (d.state==='device' ? '已连接' : (d.state==='stf_not_ready' ? 'STF未就绪' : d.state));
     const stCls = (d.state==='device'||d.state==='stf') ? 'label-success' : 'label-warning';
     return '<label data-serial="'+esc(d.serial)+'">'
       +'<input type="checkbox" value="'+esc(d.serial)+'"'+( _clipSelected.has(d.serial)?' checked':'')+' onchange="toggleClipDevice(this)">'
@@ -222,7 +222,7 @@ async function loadAdbDevices(force){
   const list=await _fetchAdbDevices(force);
   if(list===null)return;
   const cur=sel.value;
-  const stateTxt={device:'在线',offline:'离线',stf:'STF池(未连接)'};
+  const stateTxt={device:'在线',offline:'离线',stf:'STF池(未连接)',stf_not_ready:'STF未就绪'};
   const opts=['<option value="">（不指定设备）</option>'].concat(
     list.map(d=>
       '<option value="'+esc(d.serial)+'">'+esc(d.serial)+' ('+(stateTxt[d.state]||d.state)+')</option>'
@@ -251,11 +251,20 @@ async function runAdbCmd(){
   cmd=_attachDevice(cmd);
   await _runAdbFull('adb '+cmd);
 }
+// 修复类命令：目标为 IP:port 时先 adb connect（已连接自动跳过），
+// 否则设备不在本机 adb server 里会报 "device not found"（STF 未就绪的设备尤其如此）。
+async function _runAdbRepair(full){
+  const serial=_selectedSerial();
+  if(serial && serial.indexOf(':')>=0){
+    await _runAdbFull('adb connect '+serial);
+  }
+  await _runAdbFull(full);
+}
 function uninstallStfAgent(){
   const serial=_selectedSerial();
   if(!serial){showToast('请先选择目标设备','error');return;}
   if(!confirm('确定卸载 '+serial+' 上的 STF agent（jp.co.cyberagent.stf）？\n\n卸载后 STF 会在设备重连时自动重新推送安装。'))return;
-  _runAdbFull('adb -s '+serial+' uninstall jp.co.cyberagent.stf');
+  _runAdbRepair('adb -s '+serial+' uninstall jp.co.cyberagent.stf');
 }
 function reconnectAdbDevice(){
   const serial=_selectedSerial();
@@ -265,7 +274,7 @@ function reconnectAdbDevice(){
 function checkStfAgent(){
   const serial=_selectedSerial();
   if(!serial){showToast('请先选择目标设备','error');return;}
-  _runAdbFull('adb -s '+serial+' shell pm list packages | grep cyberagent');
+  _runAdbRepair('adb -s '+serial+' shell pm list packages | grep cyberagent');
 }
 async function restartStf(){
   if(!confirm('确定重启 STF 容器？\n\n影响：STF 约 30 秒不可用，期间所有设备占用状态重置，正在执行的任务会受影响。\n\n确认继续吗？'))return;
diff --git a/templates/admin/monitor.html b/templates/admin/monitor.html
index ac312ff..6342078 100644
--- a/templates/admin/monitor.html
+++ b/templates/admin/monitor.html
@@ -546,9 +546,9 @@ select.form-control{cursor:pointer}
       <button class="btn btn-xs" onclick="fillAdbCmd('tcpip 5555')" title="USB 设备开启网络调试（重启设备后失效，需重新执行）">tcpip 5555 转网络调试</button>
     </div>
     <div style="display:flex;gap:6px;margin-bottom:8px;flex-wrap:wrap">
-      <button class="btn btn-xs btn-danger" onclick="uninstallStfAgent()" title="卸载 jp.co.cyberagent.stf，STF 会在设备重连时重新推送">卸载 STF agent（卡死时用）</button>
+      <button class="btn btn-xs btn-danger" onclick="uninstallStfAgent()" title="自动先 adb connect 再卸载 jp.co.cyberagent.stf，STF 会在设备重连时重新推送">卸载 STF agent（卡死时用）</button>
       <button class="btn btn-xs" onclick="reconnectAdbDevice()" title="重新 adb connect 该设备">重连设备</button>
-      <button class="btn btn-xs" onclick="checkStfAgent()" title="查看 jp.co.cyberagent.stf 是否已安装">检查 agent</button>
+      <button class="btn btn-xs" onclick="checkStfAgent()" title="自动先 adb connect 再查看 jp.co.cyberagent.stf 是否已安装">检查 agent</button>
     </div>
     <pre id="adb-output" class="adb-console">（执行命令后输出显示在这里）</pre>
   </div>
diff --git a/web_server.py b/web_server.py
index 1abedd6..08cca3c 100644
--- a/web_server.py
+++ b/web_server.py
@@ -1065,6 +1065,9 @@ def _merged_device_list():
     """本地 adb（含 USB）+ STF 在线设备池的合并列表（[{serial, state}]）。
 
     供维护终端/剪贴板注入/应用版本管理等设备选择场景共用。
+    STF 里 adb 可达但 agent 未就绪的设备（手机端 agent 启动失败）也列入，
+    标记 stf_not_ready——这种设备恰恰需要用维护终端卸载/重装 agent 修复，
+    不列出来就永远无法修复（死循环）。
     """
     states = {}
     out = _adb("devices")
@@ -1075,8 +1078,13 @@ def _merged_device_list():
     try:
         for d in stf.list_all_devices():
             serial = d.get("serial", "")
-            if serial and d.get("present") and d.get("ready") and serial not in states:
+            if not serial or serial in states:
+                continue
+            if d.get("present") and d.get("ready"):
                 states[serial] = "stf"
+            elif d.get("present") and not d.get("ready"):
+                # adb 可达但 STF agent 未就绪（启动失败/未安装）：列入供修复
+                states[serial] = "stf_not_ready"
     except Exception:
         pass
     return [{"serial": s, "state": st} for s, st in sorted(states.items())]
@@ -1085,7 +1093,8 @@ def _merged_device_list():
 @app.route("/api/adb/devices")
 @admin_required
 def api_adb_devices():
-    """维护终端设备列表（仅管理员）：本地 adb 已连接 + STF 在线设备池。
+    """维护终端设备列表（仅管理员）：本地 adb 已连接 + STF 在线设备池
+    （含 agent 未就绪的待修复设备，state=stf_not_ready）。
 
     供终端设备选择器使用——选中后自动附加 `-s <serial>`，
     离线/未连接的设备也可选，配合"重连设备"按钮恢复。