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

doc/API.md

@@ -595,9 +595,11 @@
 
 ---
 
-## 13. 维护（仅管理员）
+## 13. 维护 / 工具（仅管理员）
 
-维护页两个接口都**仅管理员可用**（普通用户即使有业务权限也访问不了，返回 403）。
+以下接口都**仅管理员可用**（普通用户即使有业务权限也访问不了，返回 403）。
+维护页现仅含 STF 服务管理；adb 终端、Tailscale 管理、应用管理、STF 设备管理等
+已集中到"工具"页（页内子分栏），API 不变。
 
 ### POST /api/stf/restart
 
@@ -672,7 +674,7 @@ adb 远程终端：用平台 adb 二进制执行任意 adb 命令（20s 超时
 
 ## 15. Tailscale 管理（仅管理员）
 
-维护页"Tailscale 管理"分区，调用 Tailscale 官方 API v2。所有接口仅管理员可用。
+工具页"Tailscale 管理"子分栏，调用 Tailscale 官方 API v2。所有接口仅管理员可用。
 前置：`.env` 配置 `TAILSCALE_API_KEY`（Settings → API Access Tokens）与
 `TAILSCALE_TAILNET`（tailnet 名，个人账号一般为邮箱前缀）；未配置返回 502 并附提示。
 设备 IP 由 tailnet 分配，API 不可修改，列表只读展示。
@@ -739,3 +741,73 @@ adb 远程终端：用平台 adb 二进制执行任意 adb 命令（20s 超时
 ```json
 {"ok": true, "key": "tskey-auth-...", "id": "k1", "expires": "2026-08-11T01:00:00Z"}
 ```
+
+---
+
+## 16. 工具（仅管理员）
+
+工具页（剪贴板注入 / 应用版本管理 / STF 设备管理）接口，均仅管理员可用。
+
+### POST /api/tools/clipboard/set
+
+剪贴板注入：把指定文字写入一台或多台设备的剪贴板。
+
+**请求**（JSON）：
+```json
+{"serials": ["100.100.10.11:5555", "0123456789ABCDEF"], "text": "要注入的文字"}
+```
+设备来源与维护终端一致（本地 adb 含 USB + STF 池）。
+实现：u2 `jsonrpc.setClipboard`（实测 `cmd clipboard` 在 MIUI 上不存在），支持中文/引号/换行；
+IP 设备先 adb connect（已连接跳过，绝不 disconnect），USB 设备首次自动推送 atx-agent。
+
+**响应**：
+```json
+{"ok": true, "results": {"100.100.10.11:5555": {"ok": true, "msg": "已注入"}},
+ "ok_count": 1, "fail_count": 0, "error": null}
+```
+
+### POST /api/tools/appver
+
+应用版本管理：查询所有设备上指定包名的安装情况与版本号（并发 10 台）。
+
+**请求**（JSON）：
+```json
+{"pkg": "com.ss.android.ugc.aweme"}
+```
+
+**响应**：
+```json
+{"ok": true, "total": 8, "fail": 0,
+ "results": {"100.100.10.11:5555": {"installed": true, "version_name": "28.5.0", "version_code": "280500"}}}
+```
+未安装返回 `installed: false`；查询失败的设备带 `error` 字段。
+
+### GET /api/stf/devmgmt/status
+
+STF 设备管理状态：connect_devices.sh 脚本配置的 IP 列表 + 220 上 adb 实际连接状态。
+
+**响应**：
+```json
+{"ok": true,
+ "configured": ["100.100.10.10", "100.100.10.11"],
+ "connected": [{"serial": "100.100.10.10:5555", "state": "device"}]}
+```
+
+### POST /api/stf/devmgmt/add
+
+添加设备：写入 220 上 `connect_devices.sh` 的 DEVICES 列表 + 立即 `docker exec adb adb connect`。
+设备不可达时 connect 会 15 秒超时兜底（220 侧 `timeout`），但仍保留在脚本中，cron 每 5 分钟自动重试。
+
+**请求**（JSON）：`{"ip": "100.100.10.20"}`（可带 `:5555`，自动归一化）
+
+**响应**：
+```json
+{"ok": true, "msgs": ["已写入脚本 /mnt/data/openstf/connect_devices.sh", "连接超时（设备当前不可达），已保留在脚本中，cron 会每 5 分钟自动重试"]}
+```
+
+### POST /api/stf/devmgmt/remove
+
+移除设备：从脚本 DEVICES 删除 + `adb disconnect`（设备从 STF 池下线，任务不再分配）。
+注意：断开的是 220（STF provider 侧）的 adb 连接，与本机任务直连的 adb 相互独立。
+
+**请求**（JSON）：`{"ip": "100.100.10.20"}`