feat: 工具Tab新增应用版本管理（按包名并发查询所有设备安装版本）+ 文档同步更新（README/API/ARCHITECTURE/DEPLOY：工具Tab各工具、条件判断if_el+OCR、STF设备管理、.env密钥配置）

doc/ARCHITECTURE.md

@@ -233,6 +233,32 @@ APK 上传/解析/批量安装。
 
 元素树解析：递归提取每个节点的 `resource-id/text/content-desc/class/bounds` 等属性，并推荐最佳选择器（优先 xpath）。
 
+### 3.9 屏幕 OCR（`core/ocr.py`）
+
+条件判断的 `ocr` 选择器实现：截屏 → RapidOCR（ONNX 推理，中英文模型随包内置）→ 关键词匹配 → 返回文字中心像素坐标（与 u2 `d.click` 一致）。
+
+- **跨平台**（Windows/Linux/macOS），依赖 `rapidocr_onnxruntime`；服务器无显示器环境建议将 opencv-python 换成 opencv-python-headless
+- 引擎懒加载单例 + 并发加锁（识别约 0.2-0.5s/次）
+- 返回坐标约定：像素、原点左上
+
+### 3.10 STF 设备管理（`core/stf_device_mgmt.py`）
+
+工具页"STF 设备管理"：维护 220 上 OpenSTF 设备池。
+
+背景：220 的 adb 跑在 Docker 容器（`STF_ADB_CONTAINER`，默认 `adb`）里，设备池由
+`/mnt/data/openstf/connect_devices.sh`（`STF_SCRIPT_PATH`）的 `DEVICES` 数组维护，cron 每 5 分钟补连。
+
+| 函数 | 说明 |
+|------|------|
+| `status()` | 脚本配置 IP + 220 adb 实际连接状态 |
+| `add_device(ip)` | 用 220 的 python3 精确改脚本 DEVICES 块 + `docker exec adb adb connect` |
+| `remove_device(ip)` | 脚本删条目 + `adb disconnect` |
+
+关键点：
+- 脚本编辑用 python3 行级增删（sed 处理多行数组易误伤）
+- `adb connect` 到不可达 IP 会挂 40s+，220 侧用 `timeout 15` 兜底，超时保留在脚本由 cron 重试
+- 断开的是 220（STF provider 侧）的 adb 连接，与本机任务直连的 adb 相互独立
+
 ---
 
 ## 4. 任务系统设计
@@ -289,13 +315,22 @@ tasks/douyin/actions/like.py — @register_action(ACTIONS) LikeAction
 
 ### 5.2 步骤编辑器
 
-`generic_steps` 任务的步骤编辑器：
-- 左侧操作库（拖拽源）
-- 中间画布（步骤卡片列表，HTML5 Drag API 排序）
+`generic_steps` 任务的步骤编辑器（任务弹窗已加宽到 1000px）：
+- 左侧操作库（拖拽源，按 交互操作/屏幕与App/流程控制 分组）
+- 中间画布（步骤卡片列表，HTML5 Drag API 排序 + 跨层级嵌套：循环套循环、动作组）
 - 每个步骤卡片可展开参数表单
 - 选择器字段旁有"抓取元素"按钮（独立模态框）
+- **容器步骤**（loop/group/if_el）：卡片内嵌子步骤容器接收拖入；if_el 有"✅找到时/❌未找到时"两个独立分支容器，分支可嵌套任意步骤
+- **条件判断**（if_el）：选择器支持 xpath 等 UI 树选择器或 OCR识别（`core/ocr.py`，截屏匹配图片/画布文字，命中可自动点击）
+- 所有递归操作（选择打包、存自定义动作、校验、防循环自套）统一遍历 children/then/else 三个子数组
 
-### 5.3 元素抓取模态框
+### 5.3 页内子分栏
+
+任务/工具 Tab 用通用 `showSubTab(tabId, name)` 实现页内子分栏：每个子分栏一个 `.sub-panel`，
+`_activeSubs` 记住各 Tab 上次选中的子分栏。工具 Tab 集中了全部管理工具（剪贴板注入/adb 终端/
+Tailscale/应用管理/应用版本/已装应用/STF 设备管理），维护 Tab 仅保留 STF 服务。
+
+### 5.4 元素抓取模态框
 
 独立的第二层模态框（`el-picker-overlay`，z-index 1100），不影响任务编辑窗口：
 1. 选择设备 → 2. 加载截图 + 元素树 → 3. 点击元素/边界框 → 4. 回填选择器