docs: 全面更新——README/API/DEVELOPMENT 摘除 STF 章节（设备池/型号/看屏/新端点文档，技术红线改为共享 transport 表述）

doc/DEVELOPMENT.md

@@ -13,7 +13,7 @@
 | `dev` | **开发分支**，所有新功能/修复都在这里开发 |
 | `main` | **生产分支**（主分支），只放已确认的稳定版本 |
 
-生产环境 = STF 主机 `192.168.20.220` 的 `/mnt/data/openstf/auto_control`（python-app 容器运行 `web_server.py`）。
+生产环境 = 部署机 `192.168.20.220` 的 `/mnt/data/openstf/auto_control`（python-app 容器运行 `web_server.py`）。
 
 ### 1.2 git 操作铁律（重要）
 
@@ -42,47 +42,49 @@
 | 环境 | 位置 | 说明 |
 |------|------|------|
 | 开发机 | 本机（192.168.20.57） | `.venv` + 本地运行 `web_server.py` |
-| 生产机 | STF 主机 220 的 `auto_control` | python-app 容器，`network_mode: host` |
-| STF 服务 | `192.168.20.220:7100` | 设备农场（REST API） |
-| 设备 | Tailscale `100.100.10.x:5555` | 5 台 Xiaomi，本机 `100.100.10.2` 在 tailnet 内 |
+| 生产机 | 部署机 220 的 `auto_control` | python-app 容器，`network_mode: host` |
+| STF 服务 | ~~`192.168.20.220:7100`~~ | 已停用（2026-08-18 `docker stop stf`，代码已摘除依赖） |
+| adb 容器 | 220 上 `adb`（host 网络 5037） | USB 设备远程 adb server；网络设备补连用 |
+| 设备 | Tailscale `100.100.10.x:5555` | Xiaomi 舰队，本机 `100.100.10.2` 在 tailnet 内 |
 | uiautodev | 本机 `20242` | 元素抓取服务（web_server 自动拉起） |
 
 ### 2.1 adb key（关键）
 
-- 本机 `~/.android/adbkey` 已换成 **STF adb 容器的 key**（5 台设备都信任）
+- 本机 `~/.android/adbkey` 沿用历史 key（原取自 STF adb 容器，全部设备都信任）
 - **不要随意更换 key**——设备会变 unauthorized 连不上
 - 旧 key 备份在 `~/.android/adbkey.local.bak`
 - 生产环境的容器也需要用这把 key（部署时处理）
 
 ### 2.2 设备连接方式
 
-- 设备 serial 是 `IP:5555`（Tailscale 地址），**直连**优先
-- STF 桥接（remoteConnect）在此环境**不可用**（隧道 adb key 认证失败，显示 unauthorized）
+- 设备 serial 是 `IP:5555`（Tailscale 地址），**直连**优先（只 connect、绝不 disconnect）
+- USB 设备（serial 无冒号）：插本机走本地 adb；插 220 走远程 adb server（`USB_ADB_HOST:5037`）
 - 本机已在 tailnet 内，直连可靠且快（<1s）
+- 设备加入/退出平台：工具 → 设备池管理（SQLite 清单，自动连接 + 型号采集）
 
 ---
 
-## 3. 技术红线（开发限制）—— 违反会打断 STF，需人工恢复
+## 3. 技术红线（开发限制）—— 违反会打断共享 adb transport，需人工恢复
 
-这些是踩过坑后总结的，**任何修改都不能引入**。违反任何一条都会导致设备被 STF 误判离线、需人工处理：
+这些是踩过坑后总结的，**任何修改都不能引入**。违反任何一条都会导致设备连接被全部重建（历史原因：STF provider 共享同一 adb transport，摘除 STF 后仍保留此约束）：
 
 1. **绝不 `adb kill-server`**
-   - 会断开所有设备的 adb transport，STF 对全网设备误判离线并触发重连
+   - 会断开所有设备的 adb transport，全部设备连接被重建，运行中任务中断
    - 见 `core/adb_helper.py`
 
 2. **绝不对 `IP:5555` 设备 `adb disconnect`**
-   - STF provider 共享该地址的 adb transport，disconnect 会断 STF
+   - 该地址的 adb transport 是共享的（历史与 STF provider 共用），disconnect 会断掉全部相关连接
    - 直连模式下 `release()` 不 disconnect
    - 见 `core/device_worker.py` `STFDevice.release()`
 
 3. **空闲设备扫描不主动 connect/disconnect**
-   - STF provider 内部通过 IP:5555 维持连接，外部 connect/disconnect 会让 STF 误判离线
+   - IP:5555 的 transport 由多方共享（历史与 STF provider 共用），外部 connect/disconnect 会扰动共享连接
    - `_ForegroundScanner._scan_free` 对空闲设备直接返回"空闲"，不碰 adb
    - 见 `core/task_manager.py`
 
-4. **adb key 保持为 STF 容器的 key**（见 2.1）
+4. **adb key 保持历史 key 不变**（见 2.1，设备信任该 key）
 
-5. **直连优先，不引入 STF 桥接**（见 2.2）
+5. **直连优先，不引入第三方桥接**（见 2.2）
 
 ### 3.1 其他开发限制
 
@@ -92,7 +94,7 @@
 - **数据库是 SQLite**（`data/users.db`，WAL 模式）：运行时数据不提交 git
 - **前端 JS 在 `static/admin/monitor.js`**（已从 HTML 拆分），HTML 里用 `<script src>` 引用
 - **监控页/大列表已加分页**：100 台设备也只渲染 10 行/页，不要移除分页逻辑
-- **任务批量触发已错峰**（`_START_STAGGER_SEC`）：避免大量设备同时启动造成 adb/STF 风暴，不要移除
+- **任务批量触发已错峰**（`_START_STAGGER_SEC`）：避免大量设备同时启动造成 adb 连接风暴，不要移除
 
 ---