feat(发布计划): 新增「校验页面」步骤（expect_el）—— 每一步先确认上一步真的完成了
用户要求："进行每一步的时候先校验上一步有没有完成，比如相册界面肯定有特征，如果没有到相册界面
就出现执行，你看看怎么处理" → 方案 A：新增只做校验、不带副作用的步骤。
· tasks/generic/task.py：新步骤 expect_el
- 参数：特征元素选择器 / timeout(10) / what("在等什么") / on_missing
- on_missing：skip_rest(默认，**跳过本轮剩余步骤** —— 这一条不发、换下一个号) / notify / stop
- 为此加了 worker 级的 `_skip_rest`：_exec_steps 每步前检查，foreach_account 每轮复位
· 骨架：关键点击前各插一个 —— 相册页(//*[@text='所有照片']) → 素材已选中(desc 选择/预览)
→ 剪辑页(desc 文字/话题) → 发布页(含'添加标题'/'添加作品描述') → 发布按钮
· 通知：新增 task.page.mismatch（页面不对，本轮剩余步骤已跳过）
· 昵称选择器改**两版通吃**（实测 A06=40.7.0）：xpath 联合
`//*[@resource-id="…:id/tkv"] | //*[@resource-id="…:id/tk+"]`
—— 40.7 是 tkv、40.6 是 tk+，联合在 40.7 上实测能读到名字；.env（dev）已改，切号入口两版同为 desc=切换账号
· 前端：编辑器面板 + 参数表单 + 发布页就地编辑字段表都认 expect_el
· 文档：TASK_DEV §3（27→28 种）+ §4.7（"每步先校验上一步"）、NOTIFY、research §七·补（40.7.0 对照表
+ 联合 xpath + 各页特征 + "别按坐标点页签"的坑）、.env.example
· 测试：新增 scripts/tests/test_expect_el.py（特征在/不在、三种 on_missing、选择器为空），全套 7 个用例通过
This commit is contained in:
+1
-1
@@ -53,7 +53,7 @@ daemon 线程。所以：
|
||||
| 任务·单设备 | `task.device.success` · `.failed` · `.offline` · `.error` · `.retry` · `.stopped` · `.preempted` · `.preempt_timeout` · `.released` |
|
||||
| 业务 | `task.selector.invalid`（选择器连续 10 次未命中——"任务成功但什么都没做"的隐蔽故障） |
|
||||
| 业务 | `task.video.published`（视频发布成功，带作品分享链接）/ `task.video.failed`（发布失败**或结果未知**——结果未知意味着可能已经发出去了，要到计划页人工确认，平台不会自动重发） |
|
||||
| 业务 | `task.account.switch_failed`（切号失败：账号列表里没这个名字，或切完回读还是别人 —— **本轮不会发这个号的内容**，要人工到设备上确认号还在不在）/ `task.account.need_login`（抖音停在登录/验证码页，**需要人工登录**，平台绝不代替登录/过滑块；本设备已停止本轮任务）—— 都由「切换账号」步骤发出 |
|
||||
| 业务 | `task.page.mismatch`（「校验页面」没等到该出现的特征元素 —— **上一步没生效**，默认跳过本轮剩余步骤，避免在错的页面上继续盲点；见 TASK_DEV §4.7）/ `task.account.switch_failed`（切号失败：账号列表里没这个名字，或切完回读还是别人 —— **本轮不会发这个号的内容**，要人工到设备上确认号还在不在）/ `task.account.need_login`（抖音停在登录/验证码页，**需要人工登录**，平台绝不代替登录/过滑块；本设备已停止本轮任务）—— 都由「切换账号」步骤发出 |
|
||||
| 业务·任务自己发 | `task.notify.custom`（步骤「发通知」）/ `task.patrol.hit`（任务「公共巡检」命中）——**标题正文由任务自己写**，见下 |
|
||||
| Worker | `worker.connected` · `.attempt.done` · `.attempt.error`（单次尝试级，噪音大，默认没人勾） |
|
||||
| 设备 | `device.online` · `.offline` · `.discovered` · `.claimed` · `device.heartbeat_timeout` · `device.battery.low` · `.battery.recovered` |
|
||||
|
||||
+5
-1
@@ -109,7 +109,7 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
|
||||
---
|
||||
|
||||
## 3. 27 种步骤全表
|
||||
## 3. 28 种步骤全表
|
||||
|
||||
> 参数与默认值以 `tasks/generic/task.py` 为准；前端 `STEP_LIB`（`static/admin/editor.js`）负责在编辑器里呈现这些字段。
|
||||
|
||||
@@ -142,6 +142,7 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
| 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 |
|
||||
| 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 |
|
||||
|
||||
### 3.2 录制手势：**纯录制、纯回放**（`core/gesture.py`）
|
||||
@@ -516,6 +517,9 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
**跳过正在跑任务的设备**（不抢屏），单台失败只报那台；结果顺手缓存进 `device.cur_account_name`
|
||||
（**纯缓存**，自动任务永远现场读屏幕）。
|
||||
|
||||
**每一步之前先校验上一步完成了没（`expect_el`）**：发布流程是一串"点 A → 点 B → 点 C"，中间任何一步没生效，后面就会**盲点**（点到别的控件上），最后"任务跑完了、什么都没发出去"还不报错。
|
||||
所以骨架在每个关键点击前面放了一个「校验页面」：相册页（`//*[@text='所有照片']`）、素材已选中（`desc=选择/预览`）、剪辑页（`desc=文字/话题`）、发布页（`desc=发布`…）。等不到就**跳过本轮剩余步骤**（这一条不发、换下一个号），并通知 `task.page.mismatch`。
|
||||
|
||||
**「推送发布视频」做六件事**（`tasks/generic/publish_flow.py` 的 `push_one()`）：
|
||||
|
||||
```
|
||||
|
||||
@@ -231,3 +231,32 @@
|
||||
.venv/Scripts/python -c "import uiautomator2 as u2; d=u2.connect('<serial>'); open('me.xml','w',encoding='utf-8').write(d.dump_hierarchy())"
|
||||
# 在 me.xml 里找 text 是昵称、或 content-desc 是「切换账号」的节点，看它的 resource-id
|
||||
```
|
||||
|
||||
### 七·补：40.7.0 的「我」页与发布流程各页（2026-10-12，A06 = 192.168.20.75 实测）
|
||||
|
||||
生产是 40.6 与 40.7 **混装**（9 台 40.7 / 3 台 40.6），两版的混淆 id **不一样**。实测对照：
|
||||
|
||||
| 元素 | 40.6.0（A01） | 40.7.0（A06） |
|
||||
|---|---|---|
|
||||
| **「我」页昵称** | `id/tk+` | **`id/tkv`** |
|
||||
| 切换账号入口 | `desc=切换账号`（id/oxp） | `desc=切换账号`（id/ow_）**同一个 desc ✓** |
|
||||
| 抖音号 | `id/504` | `id/5zk` |
|
||||
| 底部「我」页签 | `desc=我，按钮` | 同样能用 `desc 含我` 命中 ✓ |
|
||||
| 拍摄面板「相册」 | `id/cnv` | `id/cnv` **同 id ✓** |
|
||||
| 相册页 | —— | 标题 `id/tv_title` = **`所有照片`**；页签 全部/视频/图片/动图/人像 |
|
||||
| 选中素材后 | —— | 顶部出现 `desc=选择` / `预览` |
|
||||
| 剪辑页 | —— | `desc=文字`/`话题`/`贴纸`/`特效`/`标记`/`滤镜`（都挂在 `id/iv_icon` 上） |
|
||||
| 发布页 | —— | 标题框 `id/ipv`（hint `添加标题`）、描述框 `id/ia-`（hint `添加作品描述...`） |
|
||||
|
||||
**昵称的"两版通吃"写法（已实测）**：xpath 联合 ——
|
||||
`//*[@resource-id="com.ss.android.ugc.aweme:id/tkv"] | //*[@resource-id="com.ss.android.ugc.aweme:id/tk+"]`
|
||||
在 40.7.0 上 `exists=True` 且 `get_text()` 读到昵称 ✓。**比按版本配两套省事**，写进 `.env` 的
|
||||
`DOUYIN_NAME_SELECTOR_VALUE` 即可（`read_account_name` 与「校验账号」共用它）。
|
||||
|
||||
**为什么 `desc=选择` 这类"页面特征"能当校验**：选素材/进剪辑页这些**没有独立 id 的页面**，
|
||||
靠"这一页特有的文字/描述"判断"我在哪一页"，比按坐标/序号稳 —— 这正是「校验页面」(expect_el)
|
||||
要的东西（见 `doc/TASK_DEV.md` §3 第 28 行、§4.7）。
|
||||
|
||||
> ⚠ 走查时踩的坑：**别用坐标点底部页签** —— 我按 (0.876,0.899) 点 A06 的「我」，
|
||||
> 结果进了「抖音音乐榜」（`MusicDetailActivity`）。同一台机器上 `desc 含我` 是好的，
|
||||
> 按 desc 点才是对的（40.6 上坐标碰巧能用，不代表 40.7 也行）。
|
||||
|
||||
Reference in New Issue
Block a user