feat(任务): 滑动拟人化 + 每台设备有自己的手感（core/humanize.py）
用户反馈"滑动太像机器人""批量执行时每台设备都一样"。 core/humanize.py（新）分两个层次： - **每次不同**：起止点/幅度/时长抖动、弧线方向随机——最容易被识别的不是"慢"， 是"每次都一模一样"； - **每台设备不同**：由 crc32(serial) 派生稳定的"性格"（手速 0.82~1.32、 幅度 0.86~1.16、弧度、常用横坐标 ±9% 屏宽、停顿 0.80~1.35）。同设备多次运行 风格一致，不同设备明显不同——13 台批量跑看着像 13 个人各刷各的。 用独立 Random 实例播种，不碰全局 random（多线程 worker 会打乱取值顺序）。 轨迹用二次贝塞尔走 d.swipe_points（曲线），异常时自动退回直线 d.swipe。 **点数固定 4 个**：swipe_points 在慢设备上每多一个点约多 1 秒（实测 2 点 1.4s / 6 点 6.0s / 10 点 10.6s），设备自己会插值几十步，4 点已足够弯。 顺带修一个真机上的老毛病：滑动原本每次都要读 d.info，而它在部分设备上要 **14 秒**。改用 humanize.screen_size()（走 window_size，同设备 0.6s，缓存 120s）——所以哪怕多了弧线，真机单次滑动反而从 ~15s 降到 ~5s。 - tasks/generic/task.py：swipe / swipe_until 走拟人（新增 distance_ratio、 jitter、humanize 参数，默认开）；swipe_until 每轮停顿也抖动；wait 步骤新增 可选 vary_pace（默认关，按设备节奏缩放 0.8~1.35 倍）； - static/admin/editor.js：滑动类步骤参数面板加"幅度/抖动/拟人轨迹"+ 说明； - 文档：TASK_DEV.md §8.4（含"点数别调大""别用 d.info"两个坑）、步骤表、 README 能力表与结构。 自测：假设备单测（曲线/抖动/设备间差异/退化路径/不越界/尺寸缓存）+ 真机联调 （4 次滑动全部 ok，标注"弧线"、坐标每次不同、对照的 humanize=false 仍是直线）。
This commit is contained in:
+37
-3
@@ -120,15 +120,15 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
| 4 | `screen_off` | 息屏 | — | — | — | `d.screen_off()` |
|
||||
| 5 | `keep_screen` | 保持亮屏 | `mode`("on") | — | — | `mode="off"` → 恢复自动息屏；否则**把系统息屏超时顶到最大**（`screen_off_timeout=2147483647`）+ `svc power stayon true` + 唤醒一次。⚠️ 只发 `svc power stayon true` 对**没插充电器**的设备（走 WiFi 的那些）**完全无效**——它管的是"充电时屏幕常亮"，2026-09-14 就是因此被反馈"保持亮屏没用" |
|
||||
| 6 | `key_event` | 按键 | `key`("back") | — | — | `d.press(key)`；**值直传，无白名单校验** |
|
||||
| 7 | `swipe` | 滑动 | `direction`("up") | `duration_min`(0.25)、`duration_max`(0.50) | — | 时长取随机值；up = 中轴从 0.8h → 0.2h（down 反向，left/right 同理）；**非法 direction 静默不滑** |
|
||||
| 8 | `swipe_until` | 滑动直到元素 | `selector_type`、`selector_value` | `direction`("up")、`max_swipes`(8)、`click_when_found`(True) | — | 每轮滑动后 sleep 0.5s；命中即（可选）点击并返回 True；**只有 `direction="down"` 才是向下滑**，其余按上滑 |
|
||||
| 7 | `swipe` | 滑动 | `direction`("up") | `duration_min`(0.25)、`duration_max`(0.50)、`distance_ratio`(0.6)、`jitter`(0.15)、`humanize`(True) | — | **默认拟人**：弧线轨迹 + 起止点/幅度/时长抖动 + 本设备手速偏好（见 §8.4）；`humanize:false` 还原老的「正中直线」；`jitter:0` 时位置/幅度不抖（时长仍随机）；**非法 direction 静默不滑** |
|
||||
| 8 | `swipe_until` | 滑动直到元素 | `selector_type`、`selector_value` | `direction`("up")、`max_swipes`(8)、`click_when_found`(True)、`duration_min`(0.25)、`duration_max`(0.50)、`distance_ratio`(0.6)、`jitter`(0.15)、`humanize`(True) | — | 每次滑动都重新生成轨迹（同 §8.4）；每轮滑动后随机停 0.35~0.75s；命中即（可选）点击并返回 True；**只有 `direction="down"` 才是向下滑**，其余按上滑 |
|
||||
| 9 | `click` | 点击元素 | `selector_type`、`selector_value` | `wait_timeout`(2) | — | xpath 用 `wait(timeout)`，其它选择器用 `exists(timeout)`；`wait_timeout=0` 为立即判断。**空选择器只告警** |
|
||||
| 10 | `click_xy` | 点击坐标 | — | `x`(50)、`y`(50) | — | **屏幕百分比**（0-100，会夹取），50/50 = 屏幕中心。无选择器时的兜底，**最脆的方式** |
|
||||
| 11 | `long_click` | 长按元素 | `selector_type`、`selector_value` | `duration`(1.0)、`wait_timeout`(2) | — | 先等元素出现再 `long_click` |
|
||||
| 12 | `wait_el` | 等待元素 | `selector_type`、`selector_value` | `timeout`(10) | — | 等元素出现（条件等待，优于固定 `wait`） |
|
||||
| 13 | `input_text` | 输入文字 | — | `mode`("random")、`texts`("你好\n有趣\n支持")、`fixed_text`("")、`clear_first`(True) | — | `mode="fixed"` 用 `fixed_text`，否则从 `texts` 按行随机选一条；**只负责输入，不负责定位输入框**（要先 click 输入框） |
|
||||
| 14 | `clipboard` | 剪贴板注入 | `text` | `paste`(True) | — | 走 ClipInject 通道（绕开 Android 10+ 后台写剪贴板限制）；`paste=true` 时再触发一次粘贴 |
|
||||
| 15 | `wait` | 等待 | — | `min`(1.0)、`max`(3.0) | — | 随机时长；**分片 sleep**（每 ≤0.5s 检查停止/超时），可被抢占打断 |
|
||||
| 15 | `wait` | 等待 | — | `min`(1.0)、`max`(3.0)、`vary_pace`(False) | — | 随机时长；**分片 sleep**（每 ≤0.5s 检查停止/超时），可被抢占打断；勾了 `vary_pace` 再按**本设备节奏**缩放 0.8~1.35 倍（批量跑时设备之间会逐渐错开） |
|
||||
| 16 | `loop` | 循环块 | — | `loop_mode`("rounds")、`max_iterations`(10)、`loop_duration`(600) | `children` | 见 §4.1 |
|
||||
| 17 | `group` | 动作组 | — | — | `children` | 子步骤**按序执行一次**（不循环）；自定义动作拖入画布就是展开成 group |
|
||||
| 18 | `if_el` | 条件判断 | `selector_type`、`selector_value`、`timeout`(3) | `ocr_click`(False) | `then` / `else` | 见 §4.2 |
|
||||
@@ -375,6 +375,40 @@ from .myapp import task # ← 新增
|
||||
`TaskManager._run_with_retry` 传入；**只用于结构化记录**（如步骤明细
|
||||
`core/step_log.py`），不参与业务逻辑。不关心就原样透传给 `BaseWorker` 即可。
|
||||
|
||||
### 8.4 拟人化：滑动与设备节奏（`core/humanize.py`）
|
||||
|
||||
自动化最容易被识别的地方不是"慢"，是**每次都一模一样**：同一坐标、同一时长、
|
||||
13 台设备整齐划一地做同一个动作。`core/humanize.py` 从两个层次解决：
|
||||
|
||||
| 层次 | 机制 | 谁决定 |
|
||||
|---|---|---|
|
||||
| **每次不同** | 起点/终点/幅度/时长抖动，弧线方向随机 | 每次调用现算（`jitter` 控制幅度，0~0.4） |
|
||||
| **每台设备不同** | 手速(0.82~1.32)、幅度(0.86~1.16)、弧度、常用横坐标(±9%屏宽)、停顿(0.80~1.35) | `crc32(serial)` 播种，**同设备恒定** |
|
||||
|
||||
用法（同步步骤里用）：
|
||||
|
||||
```python
|
||||
from core import humanize
|
||||
humanize.swipe(d, "up", serial=self.serial, duration_min=0.25, duration_max=0.4,
|
||||
distance_ratio=0.6, jitter=0.15, humanize=True)
|
||||
humanize.pace(self.serial, 5.0, enabled=True) # wait 步骤的"按设备节奏微调"
|
||||
```
|
||||
|
||||
要点与坑：
|
||||
|
||||
- **性格稳定、抖动随机**：稳定才像"不同的人"，随机才不像"机器"。性格按 **serial**
|
||||
而不是设备名播种——改名不改风格，换地址会换风格（地址代表"这一台"）。
|
||||
- 内部用**独立的 `random.Random` 实例**，不碰全局 `random`：worker 是多线程的，
|
||||
全局 RNG 的取值顺序会被别的线程打乱，性格就串味了。
|
||||
- **屏幕尺寸别用 `d.info`**：部分设备上一次要 **14 秒**（实测），改用
|
||||
`humanize.screen_size(d, serial)`——它走 `d.window_size()`（同设备 0.6s）并缓存
|
||||
120 秒。这让"加了弧线反而更快"成为可能。
|
||||
- **曲线点数固定为 4**（5 个点）：`d.swipe_points` 在慢设备上**每多一个点约多 1 秒**
|
||||
（实测 2 点 1.4s / 6 点 6.0s / 10 点 10.6s），而设备自己会在点之间插值几十步，
|
||||
4 个点的贝塞尔已经足够弯。**不要为了"更平滑"把点数调大。**
|
||||
- `swipe_points` 抛异常时自动退回直线 `d.swipe`（老 agent 兜底），日志会留一行 warning。
|
||||
- 想关掉：步骤参数 `humanize: false`（完全还原老行为）；想调轻：`jitter: 0.05`。
|
||||
|
||||
---
|
||||
|
||||
## 9. Action 框架（App 专属操作）
|
||||
|
||||
Reference in New Issue
Block a user