feat(步骤): 选择器支持 {变量} + 新增「读取文字」+ 条件判断可选「变量」；fix(发布): 剪辑页校验等 45 秒、切号前先回主界面
用户要求："把你每一步操作都放出来让我自己写，你都封在一起我也不知道切号/认号的流程"
→ 把两个打包步骤的内部动作，拆成**画布上拖得出来的普通步骤**（能拆是因为补了下面两个零件）。
① 选择器值里的**变量**（tasks/generic/task.py `_vars_sub`）
`{本次要发的名字}`（循环块设的）/ `{本机账号名字}`（读名字读到的），中文别名与变量名都认。
用在 click / long_click / wait_el / swipe_until / expect_el / read_text / read_account_name /
switch_account 的选择器值，以及 if_el 的选择器与手填候选值。
· 没写花括号的步骤一个字不改（老任务零影响）
· 变量为空 → **换成空串 + 记警告**：宁可"选择器变空、找不到元素"明着报，
也不留 `{…}` 字面量去点到歪的地方
· 不做通用表达式（只认表里那几个名字）
② 「点击元素」的选择器类型下拉补上 **textContains**（文本包含）——
以前只能用打包步骤做到的"按名字点列表那一行"，现在自己就能拼：
`textContains` + 值 `{本次要发的名字}`
③ 新步骤 **read_text「读取文字」**：把元素文字读出来存进指定变量
（`var`=account_name 时顺手把昵称控件记给切号/推送核对复用；`clean`=按账号名清洗/只去空白；
`on_missing`=skip 默认只记一句 / fail 算失败）。之前**没有**"读取元素文字"这种步骤。
④ 「条件判断」的候选值来源加 **「变量」**（`cmp_source=var` + `cmp_var`）——
不然 read_text 读出来的东西没处用。空变量 = 候选为空 = 不命中（同"读不到名字"的规矩）。
⑤ fix(发布) 实测踩出来的两处（A06，截图/日志为证）：
· **剪辑页校验 12 → 45 秒**：点完「下一步」抖音在「正在导入」（一条 25 秒的视频要导 25 秒+），
导入期间工具栏不渲染，10~12 秒必然判"没到剪辑页"→ 这一条白发
· **切号前先回主界面**（`_goto_me`）：点不到「我」页签 = 不在主界面（剪辑页/发布页），
那种页面没有底部页签 → **强杀 + 冷启动**抖音再来。实测卡在剪辑页时，本轮剩下的号全部报废
· **切号后回读为空时点一次「我」再读**：换号会整体重启抖音、起来常落在首页（首页没有昵称控件），
读多少次都是空 —— 等完 wait_after、读两遍仍空才补这一下导航，不打扰它的重启过程
前端：编辑器调色板/字段面板认 read_text（含变量说明）、选择器类型加 textContains、
placeholder 提示 `{本次要发的名字}`、候选值来源加「变量」+ 变量名输入、
「发布计划」页就地编辑字段表同步（release.js）。
文档：TASK_DEV §3 步骤表 28→29 种 + §3.3「选择器里的变量」+ §3.4「自己拼切号+认号」；
API.md 骨架步数修正（18 → 4 步 / 含嵌套 23 步）。
测试：新增 scripts/tests/test_read_text.py（变量代入、空变量不许瞎点、读取文字存变量/清洗、
条件判断取变量、草稿校验），全套 8 个用例通过。
This commit is contained in:
+1
-1
@@ -521,7 +521,7 @@
|
||||
| `POST /api/video_plan/<id>/resolve` | `{published, note}` | **`unknown` 的人工裁决**：确认真发出去了 → `done`；确认没发 → `failed`（可重试） |
|
||||
| `GET /api/video_plan/links` | `?from=&to=&name=&format=csv` | 已发布作品的分享链接；CSV 带 BOM（Excel 打开中文不乱码）。列：发布日期/**名字**/编号/标题/**正文**/分享链接/发布时间 |
|
||||
| `GET /api/video_plan/tasks` | — | `{ok, tasks:[{id,name,enabled,mode,cron,next_run,target,steps,step_count,schedule,retry,is_release,has_push}], release_count, other_count}`：**全部通用步骤任务**（不止发布任务 —— 只列发布任务的话，手写的抖音发布流程会一条都不显示，人会以为"这页没有能改的地方"），界面按 `is_release`（有 `push_release` **或** `mark_release`，含嵌套）分两组。带完整 `steps` 是为**就地编辑**（抓选择器）；`step_count` 数的是**含嵌套**的总步数。权限 `T` |
|
||||
| `POST /api/video_plan/tasks` | `{"name","target":{"mode":"all\|group\|serial","group_name","serial"},"time":"10:00","enabled"}` | 一键新建：骨架 **18 步**（亮屏 → 打开抖音(等首页) → 点「我」→ `read_account_name` 读本机账号名字（昵称控件的选择器填在 .env）→ `if_el(cmp_source=account_target)` 校验登的是不是要发的名字 → then: `push_release(account=name)` → 「+」(预填 `descriptionContains=拍摄`) → 相册/第一个视频/下一步/标题框/正文框/发布（**空选择器占位**）→ `input_text(text_source=release_title)` → `input_text(text_source=release_body)` → `mark_release`；else: `notify` 跳过）；**走 TaskManager 建**（内存+库一起更新，直接写库调度器不认）。⚠ `target` 分组键名是 **`group_name`**（写成 `group` 会静默解析出 0 台设备）；分组/单设备没给具体目标 → 400。权限 `T` |
|
||||
| `POST /api/video_plan/tasks` | `{"name","target":{"mode":"all\|group\|serial","group_name","serial"},"time":"10:00","enabled"}` | 一键新建：骨架 **4 步 / 含循环体内共 23 步**（亮屏 → 打开抖音(等首页) → 点「我」→ `read_account_name` 读本机账号名字（昵称控件的选择器填在 .env）→ `if_el(cmp_source=account_target)` 校验登的是不是要发的名字 → then: `push_release(account=name)` → 「+」(预填 `descriptionContains=拍摄`) → 相册/第一个视频/下一步/标题框/正文框/发布（**空选择器占位**）→ `input_text(text_source=release_title)` → `input_text(text_source=release_body)` → `mark_release`；else: `notify` 跳过）；**走 TaskManager 建**（内存+库一起更新，直接写库调度器不认）。⚠ `target` 分组键名是 **`group_name`**（写成 `group` 会静默解析出 0 台设备）；分组/单设备没给具体目标 → 400。权限 `T` |
|
||||
| `GET/PUT /api/video_plan/tasks/<job_id>` | `PUT {name?, time?, target?, steps?, enabled?}` | **发布任务的就地编辑**（「发布计划」页里改，不用跳任务页）。只放开这几个字段，**没传的字段原样保留**；`steps` 整块替换但 `params` 里的通用参数（去重有效期、抢占…）**深合并保留**。校验：空名字/坏时间/`steps` 不是数组/什么都不传 → 400，未知任务 → 404。权限 `T`。底层仍是 `TaskManager.update_job()`（内存+库一起改） |
|
||||
| `POST /api/video_plan/tasks/<job_id>/adopt` | — | 给**已有任务**插上平台那两步：`push_release` 放最前、`mark_release` 放最后（**中间你自己的步骤一步不动**；位置理由见 `core.video_plan.insert_release_steps`）。只对「通用步骤」任务；没有步骤 → 400，已经有这两步 → 409，未知任务 → 404。权限 `T` |
|
||||
|
||||
|
||||
+44
-3
@@ -109,7 +109,7 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
|
||||
---
|
||||
|
||||
## 3. 28 种步骤全表
|
||||
## 3. 29 种步骤全表
|
||||
|
||||
> 参数与默认值以 `tasks/generic/task.py` 为准；前端 `STEP_LIB`（`static/admin/editor.js`）负责在编辑器里呈现这些字段。
|
||||
|
||||
@@ -123,7 +123,7 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
| 6 | `key_event` | 按键 | `key`("back") | — | — | `d.press(key)`；**值直传，无白名单校验** |
|
||||
| 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` 为立即判断。**空选择器只告警** |
|
||||
| 9 | `click` | 点击元素 | `selector_type`、`selector_value` | `wait_timeout`(2) | — | xpath 用 `wait(timeout)`，其它选择器用 `exists(timeout)`；`wait_timeout=0` 为立即判断。**空选择器只告警**。选择器值里可以写 `{本次要发的名字}` / `{本机账号名字}`（见 §3.3）；按**文本包含**找用 `textContains`（例：账号列表里点 `textContains={本次要发的名字}`） |
|
||||
| 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`） |
|
||||
@@ -133,7 +133,7 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
| 16 | `loop` | 循环块 | — | `loop_mode`("rounds")、`max_iterations`(10)、`loop_duration`(600) | `children` | 见 §4.1 |
|
||||
| 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)、`cmp_op`("")、`cmp_value`("")、`cmp_source`("")、`ident_type`/`ident_value`（去重身份） | `then` / `else` | 见 §4.2；条件类型除元素/OCR 外还支持 **屏幕状态**、**前台App**、**去重**（见 §4.6）；填 `cmp_op` 则改成**比元素的文本**（等于/不等于/包含/不包含，多值任一命中），候选值还可以由平台给：**本次要发的名字**（`cmp_source=account_target`）或**本机要发的那条发布计划**的名字（`cmp_source=release`） |
|
||||
| 18 | `if_el` | 条件判断 | `selector_type`、`selector_value`、`timeout`(3) | `ocr_click`(False)、`cmp_op`("")、`cmp_value`("")、`cmp_source`("")、`ident_type`/`ident_value`（去重身份） | `then` / `else` | 见 §4.2；条件类型除元素/OCR 外还支持 **屏幕状态**、**前台App**、**去重**（见 §4.6）；填 `cmp_op` 则改成**比元素的文本**（等于/不等于/包含/不包含，多值任一命中），候选值还可以由平台给：**本次要发的名字**（`cmp_source=account_target`）、**本机要发的那条发布计划**的名字（`cmp_source=release`）或**某个运行期变量**（`cmp_source=var` + `cmp_var=<变量名>`，变量由 `read_text` 写入）。**候选为空（名字读不到/变量是空的）→ 一律不命中**，这是设计如此（不知道登的是谁就不发） |
|
||||
| 19 | `notify` | 发通知 | — | `title`("")、`message`("")、`level`("info") | — | 推一条**自定义**通知（事件 `task.notify.custom`）：标题正文自己写，支持 `{device} {serial} {job} {time} {app} {screen}`；谁收到取决于 webhook 的事件订阅。两者都空则跳过 |
|
||||
| 20 | `stop_self` | 停止本设备 | — | `reason`("") | — | 只停**本设备**的任务（其它设备照跑）：置 worker 停止位，后续步骤不再执行，任务记成**被停止而不是失败**（不触发重试） |
|
||||
| 21 | `gesture` | 录制手势 | `points`（录出来的） | `speed`(1.0) | — | **纯录制回放**：把录下的轨迹点列 `[[x,y,t_ms],…]` 按原路径与时长交给设备插值，不做弧线/抖动/手速加工。与「滑动」是两套东西，见 §3.2 |
|
||||
@@ -141,6 +141,7 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
| 23 | `push_release` | 推送发布视频 | `date_source`(today/fixed)、`fixed_date` | `account`(name/phone)、`account_phone`、`album_dir`(/sdcard/DCIM/Camera)、`to_clipboard`(True)、`retry_failed`(True)、`max_same_run`(1) | — | 取**本次要发的那个名字**名下的「发布计划」→ **只把素材推到手机**（+ 触发相册刷新 + 标题写进剪贴板）。**不发布** —— 抖音流程你自己在后面画。`account=name`（默认）时**推送前会重读昵称核对**，对不上就不推。幂等靠原子占位（多设备/重跑不会重复推）。见 §4.7 |
|
||||
| 24 | `mark_release` | 标记发布结果 | `result`(published/failed/unknown)、`why` | `capture_link`(True)、`delete_phone`(True)、`album_dir` | — | 放在**你自己发布流程的末尾**：把"发出去了没有"回写到计划行（成功时顺手抓作品分享链接、删手机上的素材）。拿不准就填 `unknown` —— 平台不会自动重发它。见 §4.7 |
|
||||
| 25 | `read_account_name` | 读取本机账号名字 | `selector_value`（昵称控件；值填在 `.env` 的 `DOUYIN_NAME_SELECTOR_VALUE`，40.6.0 实测值见 [research/U2_ELEMENT_SELECTORS.md](research/U2_ELEMENT_SELECTORS.md) §七） | `selector_type`(xpath)、`timeout`(8)、`on_missing`(fail) | — | 读抖音「我」页面上的**昵称** → 清洗后存进运行期变量（`account_name`），并记下用的选择器供 `push_release`/`switch_account` 核对。**读不到 = 本机没有号**：条件判断走 `else`、推送跳过（都不发）。`on_missing=fail`(默认) 让这一步直接失败、`skip` 只记一句继续。见 §4.7 |
|
||||
| 29 | `read_text` | 读取文字 | `selector_value`（要读的元素，值里可用 `{变量}`） | `selector_type`(xpath)、`timeout`(8)、`var`(account_name)、`clean`(account)、`on_missing`(skip) | — | 把某个元素的文字**读出来存进变量**（通用版；发布专用的那个是 #25 `read_account_name`）。`clean=account` 按账号名清洗（取第一行非标签）/ `strip` 只去首尾空白。变量名叫 `account_name` 时顺手把该控件记给 `push_release`/`switch_account` 复用。存下后：选择器值里写 `{变量名}`、或让「条件判断」的 `cmp_source=var` 取它。读不到默认只记一句（`skip`），`fail` 才算这一步失败 |
|
||||
| 26 | `switch_account` | 切换账号 | `switch_selector_value`（进「账号切换」列表那一下；填 `.env` 的 `DOUYIN_SWITCH_SELECTOR_VALUE`，实测值同上） | `target`(`var:target_name`)、`target_value`、`name_selector_*`、`me_selector_*`(descriptionContains=我)、`timeout`(8)、**`wait_after`(15)**、`verify`(True)、`max_attempts`(2)、`on_login_page`(stop) | — | **只在本机已登录过的号之间切**：当前已是目标→直接成功；否则点「我」→ 点切换入口 → **在列表里按名字找控件点击**（**禁 `[N]` 序号**：序号型会随界面变形错位）→ 等重载 → **回读校验**。列表里没这个名字 = 本机没登这个号 → 立刻 False（不重试、不算故障）。**切完先等 `wait_after` 秒（默认 15）再回读** —— 换号会触发抖音整体重启，中途去点任何东西（包括点「我」页签那一下『刷新』）都可能打断它加载。停在登录/验证码页 → 通知 + 默认停本设备（平台不做登录/滑块）。见 §4.7 |
|
||||
| 28 | `expect_el` | 校验页面 | `selector_value`（**这一页的特征元素**） | `selector_type`(xpath)、`timeout`(10)、`on_missing`(skip_rest)、`what`("在等什么"，写日志/通知) | — | **只校验、不带副作用**：确认"上一步真的完成了"。等不到时：`skip_rest`(默认，**跳过本轮剩余步骤** —— 这一条不发) / `notify`(只通知继续) / `stop`(停本设备)。紧挨着关键点击**前面**放一个，避免在错的页面上盲点后面一串按钮。见 §4.7 |
|
||||
| 27 | `foreach_account` | 循环本机待发的号 | — | `date_source`(today/fixed)、`fixed_date`、`retry_failed`(True)、`max_accounts`(0=不限) | `children` | **一轮把本机待发的号跑完**：数据源 = 计划表里还有待发内容的名字（`pending_names`，**不需要账号台账**），逐个写进运行期变量 `target_name` 后跑 children；试过的名字不回头（防死循环）；内层"这个名字还有待发就一直发"，跑一轮没进展（切号失败/守卫没过）就换下一个。三个干净出口：停止 / 任务时长上限 / `max_accounts`。见 §4.7 |
|
||||
@@ -221,6 +222,46 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
|
||||
---
|
||||
|
||||
### 3.3 选择器值 / 文案里的变量 `{…}`
|
||||
|
||||
多个账号轮着跑时，"要点的那一行""要比对的名字"每轮都不一样。**选择器值里可以直接写变量**，
|
||||
执行时按本轮真值替换：
|
||||
|
||||
| 写法 | 取什么 |
|
||||
|---|---|
|
||||
| `{本次要发的名字}` / `{target_name}` | 循环块（`foreach_account`）本轮设的目标名字 |
|
||||
| `{本机账号名字}` / `{account_name}` | `read_account_name` / `read_text`（变量名 `account_name`）读到的本机名字 |
|
||||
|
||||
例：账号列表里点自己要发的那个号 —— 选择器类型 `textContains`、值 `{本次要发的名字}`。
|
||||
|
||||
**规矩（都是刻意的）**：
|
||||
|
||||
- **没写花括号的步骤一个字不改**，老任务零影响。
|
||||
- 变量还是空的（还没轮到 / 没读到）→ **换成空串 + 记一条警告**：宁可"选择器变空、找不到元素"
|
||||
明着报，也别留个 `{…}` 字面量去点到歪的地方。
|
||||
- 支持变量的地方：`click` / `long_click` / `wait_el` / `swipe_until` / `expect_el` /
|
||||
`read_text` / `read_account_name` / `switch_account` 的选择器值、`if_el` 的选择器与手填候选值。
|
||||
- **不做通用表达式**：只认表里那几个名字（中文别名与变量名都行），拼错就等于空值。
|
||||
|
||||
### 3.4 自己拼"切号 + 认号"（不想用打包步骤时）
|
||||
|
||||
`switch_account`（#26）和 `read_account_name`（#25）是**打包步骤**，内部动作不展开在画布上。
|
||||
想每一步都看得见、自己改，可以这样拼：
|
||||
|
||||
1. `点击元素`：描述包含 `我` —— 进「我」页
|
||||
2. `读取文字`：选择器 = 昵称控件、变量名 `account_name` —— 读本机名字（顺带把控件记给后续步骤）
|
||||
3. `条件判断`：选择器 = 同一个昵称控件、比较 `等于`/`包含`、候选值来源 = **本次要发的名字**（或**变量**）
|
||||
- `then` = 发布流程；`else` = 发通知"不是要发的号"
|
||||
4. `点击元素`：描述包含 `切换账号` —— 进账号列表
|
||||
5. `点击元素`：**文本包含** `{本次要发的名字}` —— 点自己那一行（这一步以前只能用打包步骤做）
|
||||
6. `等待` 15 秒 —— 换号会重启抖音，这期间别点任何东西
|
||||
7. `条件判断` 再核一遍名字（第 3 步那样），确认真切过去了
|
||||
|
||||
> ⚠ 两条与安全有关的老规矩不变：**名字之间不要互为子串**（`textContains` 会先匹配到长的那个 →
|
||||
> 点到别人号上）；**列表定位禁用 `[N]` 序号**（界面一变就错位）。
|
||||
|
||||
---
|
||||
|
||||
## 4. 容器步骤与公共参数
|
||||
|
||||
### 4.1 `loop` 三种模式
|
||||
|
||||
Reference in New Issue
Block a user