auto_control

236 Commits 2 Branches 6 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
butubb	876224f876	feat(去重): 跨设备「已做过」账本 —— 同一个号不会做两次 + 「谁做过了」看得见用户场景（他原话）：一台手机登录 5 个抖音号、一共 5 台手机，每个任务只让其中一个目标号评论；每天跑一次但不知道什么时候跑完，于是"一直重复跑" → 结果 "一个手机还没评论到，一个手机都评论两次了"。根因不是"单设备重复"，是跨设备没有共享的判断 + 进度不可见。所以做两件事： ① 幂等；② 把"谁做过了、还差谁"摆到台面上（不然只能靠重跑确认，而重跑又在制造重复）。 - `core/models.py`：新表 `done_mark`（迁移账本补 v7）。判据只有 `scope_key` 的唯一索引——多台设备会同时判断"没做过"，"先查后插"有竞态（两台都插），唯一索引 + `INSERT ... ON DUPLICATE KEY`/`INSERT OR IGNORE` 的受影响行数才原子。 - `core/dedup.py`（新）：`build_key`（`任务\|身份\|时间桶`）/ `check` / `mark` / `list_marks`（带"今天做了几台/几个号"统计）/ `delete_mark` / `clear_job` / `purge_old`。自建 app context（照 device_pool 的 `_ctx()`），任务线程/Web/清理都不用关心。 - 任务侧两个部件（检查在前、记账在后）： · `if_el` 新增条件类型 `selector_type="dedup"`：命中=这个身份做过了 → 走 then 分支。身份元素在 `ident_type`/`ident_value`（留空 = 用设备 serial，一号一机场景）。 · 新步骤 `mark_done`「记为已做」（22 种步骤）：放动作成功之后。拆两步的用意：动作失败就不记账，下次重跑还会重试该设备 —— 失败不丢。 - 有效期（`dedup_reset` = day/all/hours）放任务级：检查与记账两处各填一份的话，填不一致就算出两个 key、去重会静默失效，所以强制只配一处（编辑器顶部下拉）。 - 三条防误伤规则（都有测试兜着）： · 身份读不到 / 身份值过长 → 不去重、当没做过照常执行。绝不能把"读不到" 当成空身份——那会让所有设备共用一个 key、第一台记账后其余全被误判成"做过"。 · `kind='all'`（只做一次）的记录永不清理（清了等于语义失效）；清理只删 day/hours。 · 去重的两个易错点在保存时直接告警：身份元素两边不一致、有检查没记账/有记账没检查。 - 「任务 → 去重记录」新子分栏（`static/admin/dedup.js`）：统计行 + 明细表 + 删单条（那个号重跑）/ 清空任务（整批重跑）。接口 3 个（GET/delete/clear，PERM_TASKS）。 - 每日 04:23 清理（挂现有 APScheduler），`TABLE_LABELS` 补中文名（备份覆盖自动派生）。 - AI 建任务草稿校验同步：`dedup` 走自己的规则（要 ident_value、xpath 前缀校验），没填身份元素只警告不拦（用设备当身份是合法用法）；普通条件空选择器仍然拦。 - 文档：TASK_DEV §4.6（去重专章 + App 内检测的兜底配方与它的三个局限）、 DATA_MODEL §2.9、API 三个接口、ARCHITECTURE（分层/装配/子分栏/JS 分工/清理）、 DEPLOY §5.2（15 张表）、步骤数 21→22 全库同步。自测：单元 + 集成 33 项（含 8 线程抢同一个身份、恰好一个成功的原子性断言，以及"all 记录不被清理""身份读不到不去重""清了能重跑"）、真机端到端（cs1 上"检查→动作→记账"跑两遍：第二遍被拦、换 serial 的"另一台设备" 同样被拦、删记录后能重跑）、草稿校验 5 项、GET 冒烟 56 路由 0 个 500。（注：本分支基于 feat/if-el-multi-value，因为它俩都要改 task.py 的 STEP_TYPES 与 editor.js 的 STEP_LIB 同一区域，分开从 dev 拉必然冲突——这份是超集，合一次两份都进。）	2026-09-24 10:55:29 +08:00
butubb	34a03db1b9	feat(条件判断): 支持「选中元素 → 拿它的文本和设定的值比」（等于/不等于/包含/不包含）需求原话：条件判断需要能选择元素，比如我设置了一个抖音号，让它采集这个元素的文本和我设的值做条件判断。原来的条件判断只会判「元素在不在」（找到走 then、没找到走 else），没法判"内容对不对"。现在加两个可选参数： - `cmp_op`：等于 / 不等于 / 包含 / 不包含（`==`/`!=`/`contains` 这类别名也认）；留空 = 老行为，完全向后兼容（现有任务不用改）。 - `cmp_value`：要比对的值。填了就变成：先按选择器取到元素文本 → 和 cmp_value 比 → 比对结果才是命中与否。用户那个例子就是：元素 `com.ss.android.ugc.aweme:id/506` 的文本是 `抖音号：35377983067`，选「包含」、值填 `35377983067` 即可；要抓"登录的不是这个号"就用「不等于」。 - 读取只走 `get_text()`（只读，2 秒超时），不点击、不改状态。 - 两条防误判规则（都写进文档了）： · 元素没找到时一律算未命中（走 else）——"没读到"绝不能被当成"和我设的不一样"，否则界面还没加载出来就会误判成"账号被换了"； · 元素在但文本为空时按空文本参与比对（用于抓"栏位是空的"），日志会打出实际读到的值。 - 比对不污染「选择器健康」统计：统计用的仍是"元素在不在"——"找到了但值不对" 是条件按预期走了 else，不是选择器失效，不该攒出「连续未命中」告警。 - 支持比对的类型：所有元素类选择器 + `foreground`（比前台包名）+ `ocr`（比 OCR 命中的那段字）。 `screen`（亮/熄）没有文本可比，设了会忽略并告警。 - 前端：条件判断面板多一块「文本比对」（运算符下拉 + 比对的值），只在元素/OCR/前台App 条件下出现；保存前校验"选了运算符却没填值"和"screen 上设了比对"。 - AI 建任务草稿校验（`core/task_draft.py`）同步拦"运算符拼错""有运算符没值"—— 执行器对认不出的运算符是"一律不命中"，不拦就会变成悄悄走 else。自测：比对函数 16 项（含别名、空值、None、拼错运算符）、`_exec_if_el` 全分支 20 项（含"没找到+不等于"这个关键边界、健康统计用存在性、screen 忽略比对、u2 抛异常不炸）、真机验证（cs1 上真读一个 TextView 的文本再比对：包含/等于/不等于全对，元素不存在时不误判）、草稿校验 5 项、GET 路由冒烟 55 个 0 个 500。（测试里踩到一个坑记一笔：u2 的 `XPathSelector.exists` 是纯 bool 属性，而 `UiObject.exists` 是"可调用的 Exists 对象"（`bool()` 即时判断、`exists(timeout=)` 带等待），两套语义不能想当然统一——单测的假设备一开始没模拟对，是测试写错了不是代码写错了。）	2026-09-24 09:22:32 +08:00
butubb	46e6ea1f37	feat(AI 建任务): AI 自己在真机探索 → 写出可调度任务 → 人工确认入库 AI 控制台下新增子分栏「🧭 AI 建任务」：描述要做什么（例：建一个跑 2 小时的任务、自动刷某 App、随机点赞），AI 用 de_* 工具自己在设备上探索（看屏/读元素树/点按验证），把走通的路径写成一条任务草稿，经服务端校验后交人在步骤编辑器里核对/手改/试跑，保存才入库。链路：POST /api/agent/run{mode:"designer", settings} → Agent 自探 → 本地工具 submit_task(draft) → core/task_draft 校验（失败把 errors 回灌模型让它改） → 只暂存（运行态 + app_meta.agent_task_draft，不落库） → SSE done{mode,draft,warnings} → 页面草稿预览 → openTaskModal(null, prefill) 预填关键实现 - core/task_draft.py（新）：把执行器的"静默跳过点"（未知 type/空 selector/空 children/ 嵌套>5/节点>60/cron 非法/必填缺失）前移成显式 error——POST /api/jobs 对 params 是盲存的，执行器又静默跳过错误步骤，没有这道闸门就是"任务建好了、跑起来什么都没做"。归一化兜底任务名/target/schedule/retry/时长；页面填的设置以 overrides 优先于模型。故意不比执行器更严：loop_mode 近义值归一（count→rounds）、缺 max_iterations 补默认 10 （执行器本来就默认）——实测卡太死会把一轮探索耗在改字段上。有副作用的步骤（评论/发送/购买/删除…）只警告并把触发概率压到 30%（编辑器可改回）。 - mcp_agent/agent.py：双系统提示词（CHAT/DESIGNER）+ 平台级本地工具（LOCAL_TOOL_SPECS，不进 MCP）+ 每工具调用上限 40 + designer 输出上限 8192 + json.loads 容错（草稿被截断时给模型可读错误，而不是整轮失败）。 - web/agent_api.py：mode/settings 透传、submit_task 处理器（app_context 内校验+暂存）、 done 带 draft、GET /api/agent/task_draft{,+POST,/clear}（草稿走 app_meta，不新建表）。 - 前端：static/admin/taskgen.js + #agent-sub-taskgen 子面板（showSubTab 机制）； tasks.js 的 openTaskModal(jobId, prefill) + 信封归一化 + 唯一 draftKey； agent.js 按 mode 门控（一个 run 只有一个事件队列，两个 EventSource 会互相瓜分事件）。顺带修掉一个 chat 也踩的协议 bug：一轮里同时调 de_screenshot 与别的工具时，截图图像会被插在两条 tool 消息之间 → 模型侧判"工具回应不足"直接 400。改为本轮 tool 消息发完再附图像， _repair_tool_messages 也改成只数连续的 tool 消息。真机实测（Redmi 22120RN86C，设置页）：8 步探索（含 tap_text 验证）→ submit_task 一次通过 → 草稿 8 个顶层步骤（screen_on/open_app/wait_el/click/wait/key_event…）、max_duration 1800、无 click_xy、3 条 evidence；页面恢复草稿 + 预填编辑器 + 提示块渲染均正常，无 JS 报错。自测数据已清理（草稿已丢弃、未创建任何任务）。文档：AI_TASK_GEN.md 状态改「P0 已实现」+ §10 实现记录（差异/护栏/未做项）、AI_CONSOLE.md （子分栏、designer 分支、SSE done 负载、app_meta 键）、API.md、DATA_MODEL.md、ARCHITECTURE.md、 DEVELOPMENT.md（自测入口）、README.md 索引、backlog 勾掉 P0。	2026-09-13 23:08:59 +08:00

Author

SHA1

Message

Date

butubb

876224f876

feat(去重): 跨设备「已做过」账本 —— 同一个号不会做两次 + 「谁做过了」看得见

用户场景（他原话）：一台手机登录 5 个抖音号、一共 5 台手机，每个任务只让其中一个
目标号评论；每天跑一次但不知道什么时候跑完，于是"一直重复跑" → 结果
"一个手机还没评论到，一个手机都评论两次了"。

**根因不是"单设备重复"，是跨设备没有共享的判断 + 进度不可见。** 所以做两件事：
① 幂等；② 把"谁做过了、还差谁"摆到台面上（不然只能靠重跑确认，而重跑又在制造重复）。

- `core/models.py`：新表 `done_mark`（迁移账本补 v7）。**判据只有 `scope_key` 的
  唯一索引**——多台设备会同时判断"没做过"，"先查后插"有竞态（两台都插），
  唯一索引 + `INSERT ... ON DUPLICATE KEY`/`INSERT OR IGNORE` 的**受影响行数**才原子。
- `core/dedup.py`（新）：`build_key`（`任务|身份|时间桶`）/ `check` / `mark` /
  `list_marks`（带"今天做了几台/几个号"统计）/ `delete_mark` / `clear_job` / `purge_old`。
  自建 app context（照 device_pool 的 `_ctx()`），任务线程/Web/清理都不用关心。
- 任务侧两个部件（**检查在前、记账在后**）：
  · `if_el` 新增条件类型 `selector_type="dedup"`：命中=这个身份做过了 → 走 then 分支。
    身份元素在 `ident_type`/`ident_value`（留空 = 用设备 serial，一号一机场景）。
  · 新步骤 `mark_done`「记为已做」（22 种步骤）：放动作**成功之后**。
  拆两步的用意：动作失败就不记账，下次重跑还会重试该设备 —— 失败不丢。
- 有效期（`dedup_reset` = day/all/hours）放**任务级**：检查与记账两处各填一份的话，
  填不一致就算出两个 key、去重会**静默失效**，所以强制只配一处（编辑器顶部下拉）。
- 三条防误伤规则（都有测试兜着）：
  · 身份读不到 / 身份值过长 → **不去重、当没做过照常执行**。绝不能把"读不到"
    当成空身份——那会让所有设备共用一个 key、第一台记账后其余全被误判成"做过"。
  · `kind='all'`（只做一次）的记录**永不清理**（清了等于语义失效）；清理只删 day/hours。
  · 去重的两个易错点在保存时直接告警：身份元素两边不一致、有检查没记账/有记账没检查。
- 「任务 → 去重记录」新子分栏（`static/admin/dedup.js`）：统计行 + 明细表 +
  删单条（那个号重跑）/ 清空任务（整批重跑）。接口 3 个（GET/delete/clear，PERM_TASKS）。
- 每日 04:23 清理（挂现有 APScheduler），`TABLE_LABELS` 补中文名（备份覆盖自动派生）。
- AI 建任务草稿校验同步：`dedup` 走自己的规则（要 ident_value、xpath 前缀校验），
  没填身份元素只警告不拦（用设备当身份是合法用法）；普通条件空选择器仍然拦。
- 文档：TASK_DEV §4.6（去重专章 + App 内检测的兜底配方与它的三个局限）、
  DATA_MODEL §2.9、API 三个接口、ARCHITECTURE（分层/装配/子分栏/JS 分工/清理）、
  DEPLOY §5.2（15 张表）、步骤数 21→22 全库同步。

自测：单元 + 集成 33 项（**含 8 线程抢同一个身份、恰好一个成功**的原子性断言，
以及"all 记录不被清理""身份读不到不去重""清了能重跑"）、
**真机端到端**（cs1 上"检查→动作→记账"跑两遍：第二遍被拦、换 serial 的"另一台设备"
同样被拦、删记录后能重跑）、草稿校验 5 项、GET 冒烟 56 路由 0 个 500。

（注：本分支基于 feat/if-el-multi-value，因为它俩都要改 task.py 的 STEP_TYPES 与
editor.js 的 STEP_LIB 同一区域，分开从 dev 拉必然冲突——这份是超集，合一次两份都进。）

2026-09-24 10:55:29 +08:00

butubb

34a03db1b9

feat(条件判断): 支持「选中元素 → 拿它的文本和设定的值比」（等于/不等于/包含/不包含）

需求原话：条件判断需要能选择元素，比如我设置了一个抖音号，让它采集这个元素的
文本和我设的值做条件判断。

原来的条件判断只会判「元素在不在」（找到走 then、没找到走 else），没法判"内容对不对"。
现在加两个可选参数：

- `cmp_op`：等于 / 不等于 / 包含 / 不包含（`==`/`!=`/`contains` 这类别名也认）；
  留空 = 老行为，**完全向后兼容**（现有任务不用改）。
- `cmp_value`：要比对的值。

填了就变成：先按选择器取到元素文本 → 和 cmp_value 比 → 比对结果才是命中与否。
用户那个例子就是：元素 `com.ss.android.ugc.aweme:id/506` 的文本是
`抖音号：35377983067`，选「包含」、值填 `35377983067` 即可；
要抓"登录的不是这个号"就用「不等于」。

- 读取只走 `get_text()`（只读，2 秒超时），不点击、不改状态。
- **两条防误判规则**（都写进文档了）：
  · 元素**没找到**时一律算未命中（走 else）——"没读到"绝不能被当成"和我设的不一样"，
    否则界面还没加载出来就会误判成"账号被换了"；
  · 元素在但文本为空时按空文本参与比对（用于抓"栏位是空的"），日志会打出实际读到的值。
- 比对**不污染「选择器健康」统计**：统计用的仍是"元素在不在"——"找到了但值不对"
  是条件按预期走了 else，不是选择器失效，不该攒出「连续未命中」告警。
- 支持比对的类型：所有元素类选择器 + `foreground`（比前台包名）+ `ocr`（比 OCR 命中的那段字）。
  `screen`（亮/熄）没有文本可比，设了会忽略并告警。
- 前端：条件判断面板多一块「文本比对」（运算符下拉 + 比对的值），
  只在元素/OCR/前台App 条件下出现；保存前校验"选了运算符却没填值"和"screen 上设了比对"。
- AI 建任务草稿校验（`core/task_draft.py`）同步拦"运算符拼错""有运算符没值"——
  执行器对认不出的运算符是"一律不命中"，不拦就会变成悄悄走 else。

自测：比对函数 16 项（含别名、空值、None、拼错运算符）、`_exec_if_el` 全分支 20 项
（含"没找到+不等于"这个关键边界、健康统计用存在性、screen 忽略比对、u2 抛异常不炸）、
**真机验证**（cs1 上真读一个 TextView 的文本再比对：包含/等于/不等于 全对，
元素不存在时不误判）、草稿校验 5 项、GET 路由冒烟 55 个 0 个 500。

（测试里踩到一个坑记一笔：u2 的 `XPathSelector.exists` 是纯 bool 属性，而
`UiObject.exists` 是"可调用的 Exists 对象"（`bool()` 即时判断、`exists(timeout=)` 带等待），
两套语义不能想当然统一——单测的假设备一开始没模拟对，是测试写错了不是代码写错了。）

2026-09-24 09:22:32 +08:00

butubb

46e6ea1f37

feat(AI 建任务): AI 自己在真机探索 → 写出可调度任务 → 人工确认入库

AI 控制台下新增子分栏「🧭 AI 建任务」：描述要做什么（例：建一个跑 2 小时的任务、自动刷
某 App、随机点赞），AI 用 de_* 工具自己在设备上探索（看屏/读元素树/点按验证），把走通的
路径写成一条任务草稿，经服务端校验后交人在步骤编辑器里核对/手改/试跑，保存才入库。

链路：POST /api/agent/run{mode:"designer", settings}
  → Agent 自探 → 本地工具 submit_task(draft)
  → core/task_draft 校验（失败把 errors 回灌模型让它改）
  → 只暂存（运行态 + app_meta.agent_task_draft，**不落库**）
  → SSE done{mode,draft,warnings} → 页面草稿预览 → openTaskModal(null, prefill) 预填

关键实现
- core/task_draft.py（新）：把执行器的"静默跳过点"（未知 type/空 selector/空 children/
  嵌套>5/节点>60/cron 非法/必填缺失）前移成显式 error——POST /api/jobs 对 params 是盲存的，
  执行器又静默跳过错误步骤，没有这道闸门就是"任务建好了、跑起来什么都没做"。
  归一化兜底任务名/target/schedule/retry/时长；页面填的设置以 overrides 优先于模型。
  故意**不比执行器更严**：loop_mode 近义值归一（count→rounds）、缺 max_iterations 补默认 10
  （执行器本来就默认）——实测卡太死会把一轮探索耗在改字段上。
  有副作用的步骤（评论/发送/购买/删除…）只警告并把触发概率压到 30%（编辑器可改回）。
- mcp_agent/agent.py：双系统提示词（CHAT/DESIGNER）+ 平台级本地工具
  （LOCAL_TOOL_SPECS，不进 MCP）+ 每工具调用上限 40 + designer 输出上限 8192 +
  **json.loads 容错**（草稿被截断时给模型可读错误，而不是整轮失败）。
- web/agent_api.py：mode/settings 透传、submit_task 处理器（app_context 内校验+暂存）、
  done 带 draft、GET /api/agent/task_draft{,+POST,/clear}（草稿走 app_meta，不新建表）。
- 前端：static/admin/taskgen.js + #agent-sub-taskgen 子面板（showSubTab 机制）；
  tasks.js 的 openTaskModal(jobId, prefill) + 信封归一化 + 唯一 draftKey；
  agent.js 按 mode 门控（一个 run 只有一个事件队列，两个 EventSource 会互相瓜分事件）。

顺带修掉一个 chat 也踩的协议 bug：一轮里同时调 de_screenshot 与别的工具时，截图图像会被
插在两条 tool 消息之间 → 模型侧判"工具回应不足"直接 400。改为本轮 tool 消息发完再附图像，
_repair_tool_messages 也改成只数**连续**的 tool 消息。

真机实测（Redmi 22120RN86C，设置页）：8 步探索（含 tap_text 验证）→ submit_task 一次通过 →
草稿 8 个顶层步骤（screen_on/open_app/wait_el/click/wait/key_event…）、max_duration 1800、
无 click_xy、3 条 evidence；页面恢复草稿 + 预填编辑器 + 提示块渲染均正常，无 JS 报错。
自测数据已清理（草稿已丢弃、未创建任何任务）。

文档：AI_TASK_GEN.md 状态改「P0 已实现」+ §10 实现记录（差异/护栏/未做项）、AI_CONSOLE.md
（子分栏、designer 分支、SSE done 负载、app_meta 键）、API.md、DATA_MODEL.md、ARCHITECTURE.md、
DEVELOPMENT.md（自测入口）、README.md 索引、backlog 勾掉 P0。

2026-09-13 23:08:59 +08:00