feat(账号): 账号台账（web 页 + 任务取号 + 设备端身份页）；fix(剪贴板): 注入通道改走设备端 Agent
一、账号台账（新表 device_account，schema v8） - core/ledger.py：CRUD、Excel 粘贴解析（Tab 分隔 / 表头乱序缺列 / 是·否布尔 / 逐行留痕）、 按范围取号（本机台账 / 全部 / 按设备分组）、设备端账号块、dry_run 预览 - 新「账号」顶级 Tab（权限 devices）：列表 + 搜索 + 设备筛选 + 增删改 + 粘贴导入（默认先预览再写，逐行显示 新增/覆盖/跳过/失败 + 留痕） - 设备池加「账号 N」列（0 个显示"未登记"），点开看该设备账号明细 - 任务「条件判断」新增 cmp_source / cmp_group：候选值可直接来自台账， 与手填值**合并（OR）**；取不到号时回落手填值，并把原因写进步骤明细与日志 （否则"永远走 else 分支"而任务照样显示成功，最难查） - 设备端契约：身份页多推 accounts_b64（base64 JSON；默认不含手机号； 超预算按整条丢且绝不算字节切），见 doc/DEVICE_AGENT.md §5.2.1 - 备份/文档红线：TABLE_LABELS 加「账号台账」；DATA_MODEL/API/ARCHITECTURE/DEPLOY/ TASK_DEV/DEVICE_AGENT/DEVELOPMENT/README 同步；顺手补上 DATA_MODEL 漏列的 done_mark ⚠ 台账里的抖音号是**纯号**，只当"比对用的候选值"：绝不能拿去填「去重」的身份元素 （身份是元素原文逐字算 key，格式不同会让去重静默失效）。代码与文档都写明了。 二、剪贴板注入通道（修：平台还在调早期的独立 APK） - 改为按顺序尝试：设备端 Agent（com.example.deviceagent/.ClipActivity）→ 旧版独立 ClipInject 兜底；两个都没有时报"需要设备端 Agent"（不再只说 ClipInject） - 读回验证改成**轮询到 3 秒**：透明 Activity 要等窗口拿到焦点才写， 原来只睡 0.5s 会读到上一次的内容 → 误报"写入可能被拒"（实测内容已写入却回失败）
This commit is contained in:
@@ -53,6 +53,7 @@
|
||||
| **动作配置 / 录制** | 「任务 → 动作配置」：① 配**步骤默认值**（新建步骤预填：滑动时长/幅度/抖动/拟人、点击超时、等待区间…）② **录制动作**——在设备画面上点/划/按键，自动翻译成步骤（点元素记选择器、划一下记方向/幅度/时长），可存成可复用动作，也可只取一个手势回填滑动步骤 |
|
||||
| **公共巡检** | 任务级的守护条件（**独立于步骤画布**）：每 N 秒检查屏幕亮/熄、元素在不在、前台是不是某 App，命中就点亮/息屏/停本设备/推通知——通知标题正文自己写（见 [TASK_DEV.md](doc/TASK_DEV.md) §4.5） |
|
||||
| **去重账本** | 解决"**同一个号被做两次、有的号还没做**"：任务里用「条件判断→去重」+「记为已做」，把"这个身份做过了"记进一张**所有设备共享**的账本——多台手机、反复重跑都不会重复做同一个号。「任务 → 去重记录」页能看"谁做过了、还差谁"，也能删记录让它重跑（见 [TASK_DEV.md](doc/TASK_DEV.md) §4.6） |
|
||||
| **账号台账** | 「账号」页维护"**哪台设备上登着哪些号**"（设备号/手机号/账号名/抖音号/注册时间/卡在机内/可发视频/简介/备注）：支持**从 Excel 粘贴批量导入**（表头识别、逐行结果、先预览后写入）。三个用处：① 任务的「条件判断」**直接从这里取号**，不用把几十个号手写进比对值；② 手机端 Agent 的**身份大字页**显示本机账号；③ 设备池里一眼看到每台登记了几个号（见 [DATA_MODEL.md](doc/DATA_MODEL.md) §2.10、[TASK_DEV.md](doc/TASK_DEV.md) §4.2） |
|
||||
| **元素抓取** | 拉取设备 UI 元素树 → 点选回填选择器；支持"点一下"与"测选择器"真机验证 |
|
||||
| **实时看屏** | MJPEG 实时流 + 点击/滑动/按键/文字输入；全屏监控大屏（`/wall`） |
|
||||
| **应用管理** | APK 上传/解析/批量安装；设备已装应用与版本查询；剪贴板注入 |
|
||||
@@ -139,6 +140,7 @@ auto_control/
|
||||
│ ├── adb_helper.py # adb 命令封装（全局锁，红线：绝不 kill-server）
|
||||
│ ├── device_discovery.py # 网段扫描发现设备 → 待连接池
|
||||
│ ├── device_battery.py # 设备电量采集（dumpsys 只读）+ 低电量告警
|
||||
│ ├── ledger.py # 账号台账（CRUD / 表格粘贴解析 / 给任务取号 / 设备端账号块）
|
||||
│ ├── u2_helper.py # uiautomator2 通用辅助（等首页/安全点击等）
|
||||
│ ├── uiauto_helper.py # uiautodev 客户端（元素树 + XPath 建议）
|
||||
│ ├── ocr.py # 屏幕 OCR（RapidOCR，条件判断用）
|
||||
|
||||
+73
-30
@@ -1,10 +1,13 @@
|
||||
"""剪贴板注入公共模块（ClipInject APK 通道）。
|
||||
"""剪贴板注入公共模块（设备端 Agent 通道）。
|
||||
|
||||
背景：Android 10+ 禁止后台（atx-agent/shell）写剪贴板——u2.set_clipboard
|
||||
调用"成功"但内容被系统静默丢弃（Android 12/13 实测）。ClipInject
|
||||
（com.example.clipinject，用户自研 APK）通过 am start 启动透明 Activity，
|
||||
窗口聚焦后 setPrimaryClip；shell 身份启动 Activity 不受后台启动限制
|
||||
（广播方式在 MIUI 会被 Background activity start 拦截，必须用 am start）。
|
||||
调用"成功"但内容被系统静默丢弃（Android 12/13 实测）。设备端 APK 通过 am start
|
||||
启动**透明 Activity**，窗口聚焦后 setPrimaryClip；shell 身份启动 Activity 不受
|
||||
后台启动限制（广播方式在 MIUI 会被 Background activity start 拦截，必须用 am start）。
|
||||
|
||||
**注入目标按顺序尝试**：先设备端聚合 Agent（`com.example.deviceagent`，现在的标准通道），
|
||||
再兜底老设备上可能残留的独立 ClipInject（`com.example.clipinject`）。
|
||||
两者只有一个 `--es text_b64` 的契约差异为零，所以是"换个包名再试一次"。
|
||||
|
||||
工具页（web/tools_api.py）与任务执行器（tasks/generic/task.py）共用本模块。
|
||||
"""
|
||||
@@ -19,17 +22,43 @@ from core.logger import get_logger
|
||||
|
||||
_log = get_logger("core.clip")
|
||||
|
||||
_CLIP_PACKAGE = "com.example.clipinject"
|
||||
_CLIP_ACTIVITY = "com.example.clipinject/.ClipActivity"
|
||||
# (包名, am start 目标, 给用户看的名字)；顺序 = 尝试顺序
|
||||
_CLIP_TARGETS = (
|
||||
("com.example.deviceagent", "com.example.deviceagent/.ClipActivity", "设备端 Agent"),
|
||||
("com.example.clipinject", "com.example.clipinject/.ClipActivity", "旧版 ClipInject"),
|
||||
)
|
||||
|
||||
|
||||
def _am_start(serial, activity, b64):
|
||||
"""拉起透明 Activity 写剪贴板。返回 (输出文本, 是否执行成功)。"""
|
||||
try:
|
||||
r = subprocess.run(
|
||||
[ADB_PATH, "-s", serial, "shell", "am", "start",
|
||||
"-n", activity, "--es", "text_b64", b64],
|
||||
capture_output=True, timeout=30)
|
||||
except subprocess.TimeoutExpired:
|
||||
return "am start 超时（adb 无响应）", False
|
||||
except Exception as e:
|
||||
return f"{type(e).__name__}: {str(e)[:120]}", False
|
||||
out = ((r.stdout or b"") + (r.stderr or b"")).decode(errors="replace")
|
||||
# "Starting: Intent {…}" 后面跟 "Error type 3 / Error: Activity class … does not exist."
|
||||
# 时也是失败——所以不能只看有没有 Starting
|
||||
if "does not exist" in out or "unable to resolve Intent" in out or "Error type 3" in out:
|
||||
return out, False
|
||||
if "Error" in out or ("Starting" not in out and r.returncode != 0):
|
||||
return out, False
|
||||
return out, True
|
||||
|
||||
|
||||
def inject_clipboard(serial, text, d=None):
|
||||
"""向设备剪贴板注入文字，返回 (ok, msg)。
|
||||
|
||||
- 依次尝试 `_CLIP_TARGETS`（设备端 Agent → 旧版 ClipInject）：设备上装哪个用哪个，
|
||||
两个都没有时明确报"需要装设备端 Agent"（不再只说 ClipInject，用户会以为要装老 APK）
|
||||
- d：可选，任务执行器已持有 u2 Device 时传入复用（跳过重复连接），
|
||||
读回验证直接用它；不传则临时 u2.connect（工具页场景，带超时保护）
|
||||
- IP:port 设备先 adb connect（已连接自动跳过；绝不 disconnect，红线）
|
||||
- 未装 ClipInject / 读回不一致都会明确报错（不再静默失败）
|
||||
- 通道缺失 / 读回不一致都会明确报错（不再静默失败）
|
||||
"""
|
||||
import uiautomator2 as u2
|
||||
if ":" in serial:
|
||||
@@ -39,31 +68,45 @@ def inject_clipboard(serial, text, d=None):
|
||||
return False, f"adb 连接失败: {e}"
|
||||
b64 = base64.b64encode(text.encode("utf-8")).decode()
|
||||
# 1. am start 透明 Activity 写剪贴板（shell 身份，不受后台启动限制）
|
||||
try:
|
||||
r = subprocess.run(
|
||||
[ADB_PATH, "-s", serial, "shell", "am", "start",
|
||||
"-n", _CLIP_ACTIVITY, "--es", "text_b64", b64],
|
||||
capture_output=True, timeout=30)
|
||||
out = ((r.stdout or b"") + (r.stderr or b"")).decode(errors="replace")
|
||||
if "does not exist" in out or "unable to resolve Intent" in out:
|
||||
return False, f"设备未安装 ClipInject（{_CLIP_PACKAGE}），请先安装"
|
||||
if "Error" in out or ("Starting" not in out and r.returncode != 0):
|
||||
return False, f"am start 失败: {out.strip()[:120]}"
|
||||
except subprocess.TimeoutExpired:
|
||||
return False, "am start 超时（adb 无响应）"
|
||||
except Exception as e:
|
||||
return False, f"{type(e).__name__}: {str(e)[:120]}"
|
||||
# 2. 读回验证（等透明 Activity 完成写入；u2 读剪贴板在 Android 12 实测可用）
|
||||
time.sleep(0.5)
|
||||
tried = []
|
||||
for pkg, activity, label in _CLIP_TARGETS:
|
||||
out, started = _am_start(serial, activity, b64)
|
||||
if started:
|
||||
if tried:
|
||||
# 走到兜底通道：记一条，好提醒"这台设备该装 Agent 了"
|
||||
_log.info(f"[{serial}] 剪贴板注入：{'、'.join(tried)} 都没有，"
|
||||
f"改用{label}（{pkg}）成功 —— 建议给这台设备装设备端 Agent")
|
||||
break
|
||||
if "does not exist" in out or "unable to resolve Intent" in out or "Error type 3" in out:
|
||||
tried.append(label)
|
||||
continue
|
||||
# 装了但启动失败：直接报错，不再往下试（下一个包大概率也没装）
|
||||
return False, f"am start 失败（{label}）: {out.strip()[:120]}"
|
||||
else:
|
||||
return False, ("设备未安装剪贴板注入通道：需要设备端 Agent"
|
||||
"（com.example.deviceagent）——从「应用管理 → 设备端应用商店」安装；"
|
||||
"旧版独立 ClipInject（com.example.clipinject）也可以，但已不再随平台分发")
|
||||
# 2. 读回验证：**必须轮询**。透明 Activity 要等窗口拿到焦点才写（还有 800ms 兜底），
|
||||
# 只睡一次 0.5s 会读到**上一次的剪贴板内容** → 误报"写入可能被拒"（实测踩过：
|
||||
# 内容明明写进去了，接口却回 1 台失败）。轮询到 ~3 秒：一致即成功；
|
||||
# 一直不一致才算真的被拒。
|
||||
try:
|
||||
if d is None:
|
||||
with ThreadPoolExecutor(max_workers=1) as pool:
|
||||
d = pool.submit(u2.connect, serial).result(timeout=30)
|
||||
with ThreadPoolExecutor(max_workers=1) as pool:
|
||||
got = pool.submit(lambda: d.clipboard).result(timeout=15)
|
||||
except Exception as e:
|
||||
return True, f"已注入（读回验证不可用: {type(e).__name__}: {str(e)[:80]}）"
|
||||
deadline = time.time() + 3.0
|
||||
got = None
|
||||
while True:
|
||||
time.sleep(0.4)
|
||||
try:
|
||||
with ThreadPoolExecutor(max_workers=1) as pool:
|
||||
got = pool.submit(lambda: d.clipboard).result(timeout=15)
|
||||
except Exception as e:
|
||||
# 读回不可用（旧版 u2/连接失败）时按写入成功处理，避免误报，但带上具体原因
|
||||
return True, f"已注入（读回验证不可用: {type(e).__name__}: {str(e)[:80]}）"
|
||||
if got == text:
|
||||
return True, "已注入"
|
||||
return False, f"剪贴板读回不一致（写入可能被拒）: {str(got)[:60]!r}"
|
||||
except Exception as e:
|
||||
# 读回不可用（旧版 u2/连接失败）时按写入成功处理，避免误报，但带上具体原因
|
||||
return True, f"已注入（读回验证不可用: {type(e).__name__}: {str(e)[:80]}）"
|
||||
if time.time() >= deadline:
|
||||
return False, f"剪贴板读回不一致（写入可能被拒）: {str(got)[:60]!r}"
|
||||
|
||||
+526
@@ -0,0 +1,526 @@
|
||||
"""账号台账：一台设备上登录着哪些账号。
|
||||
|
||||
**它解决什么**（用户场景）：一台手机登好几个抖音号、十几台手机四五十个号，
|
||||
账号信息散在一张电子表格里 —— 换 IP、加号、想查"这台登的是哪几个号"都得翻表。
|
||||
台账落进平台后有三个月牙：
|
||||
|
||||
1. web「账号」页 —— 列表 / 增删改 / **从表格粘贴导入**（`web/devices_api.py` 的 `/api/ledger*`）
|
||||
2. 任务的「条件判断」取号 —— `if_el` 的 `cmp_source=device|all|group`
|
||||
（比对运算符用「包含」时，纯号 `35377983067` 能匹配元素原文 `抖音号：35377983067`）
|
||||
3. 手机端 Agent 的「身份大字页」 —— 平台推 `accounts_b64`（`doc/DEVICE_AGENT.md` §5.2）
|
||||
|
||||
⚠ **台账里的抖音号是纯号，绝不能拿去当去重身份**：
|
||||
`done_mark.identity` 存的是**元素原文**、逐字算 key，格式不一致（`35377983067`
|
||||
vs `抖音号：35377983067`）会让去重**静默失效**。取号只用于条件判断的比对值。
|
||||
|
||||
DB 访问自建 app context（照 `core/dedup.py`），调用方（任务线程 / Web 线程）不用关心。
|
||||
"""
|
||||
import re
|
||||
import time
|
||||
import uuid
|
||||
|
||||
from core.logger import get_logger
|
||||
from core.models import db, Device, DeviceAccount, DeviceGroup
|
||||
|
||||
_log = get_logger("core.ledger")
|
||||
|
||||
# 可编辑字段（接口 / 导入 / 前端共用一份清单，避免某处漏字段）
|
||||
FIELDS = ("device_name", "phone", "nickname", "douyin_id", "registered_at",
|
||||
"sim_in_device", "can_post_video", "bio", "note")
|
||||
# 这两列是布尔（"空=否"）
|
||||
BOOL_FIELDS = ("sim_in_device", "can_post_video")
|
||||
|
||||
# 粘贴导入：表头列名 → 字段（允许乱序/缺列/多列；认不出的列忽略）
|
||||
HEADER_ALIASES = {
|
||||
"device_name": ("设备号", "设备", "设备名", "机器", "机型"),
|
||||
"phone": ("手机号", "手机", "号码", "手机号码"),
|
||||
"nickname": ("账号名称", "账号名", "昵称", "账号", "名称"),
|
||||
"douyin_id": ("抖音号", "抖音", "抖音id", "douyin"),
|
||||
"registered_at": ("注册时间", "注册日期", "注册"),
|
||||
"sim_in_device": ("卡在机内", "卡在机", "卡在", "机内"),
|
||||
"can_post_video": ("可发视频", "可发", "发视频"),
|
||||
"bio": ("简介", "签名", "个人简介"),
|
||||
"note": ("备注", "说明"),
|
||||
}
|
||||
# 没有表头时按这个顺序解析（= 用户表格的列顺序，界面上要写明）
|
||||
DEFAULT_ORDER = FIELDS
|
||||
|
||||
_TRUE_WORDS = ("是", "有", "对", "在", "✔", "√", "✓", "1", "true", "y", "yes", "t")
|
||||
_FALSE_WORDS = ("否", "无", "没有", "不在", "不", "0", "false", "n", "no", "f", "")
|
||||
# 抖音号形态：纯数字。不拦（少数号可能带字母），只在导入结果里留痕 ——
|
||||
# 候选值一旦是错的，任务会"正常跑完但永远不命中"，最难查
|
||||
_DOUYIN_RE = re.compile(r"^\d{6,20}$")
|
||||
|
||||
_app = None
|
||||
|
||||
|
||||
def init_app(app):
|
||||
"""web_server 启动时调用：绑 app（后台线程/任务线程访问 db 要自推 context）。"""
|
||||
global _app
|
||||
_app = app
|
||||
|
||||
|
||||
def _ctx():
|
||||
if _app is None:
|
||||
raise RuntimeError("ledger 未关联 Flask app（web_server 启动时调用 init_app）")
|
||||
return _app.app_context()
|
||||
|
||||
|
||||
def _now():
|
||||
return time.strftime("%Y-%m-%d %H:%M:%S")
|
||||
|
||||
|
||||
def _norm_bool(v):
|
||||
"""是/否 → (True/False, 是否认得)。认不出的按"否"处理，但**留痕**。"""
|
||||
if isinstance(v, bool):
|
||||
return v, True
|
||||
s = str(v or "").strip().lower()
|
||||
if s in _TRUE_WORDS:
|
||||
return True, True
|
||||
if s in _FALSE_WORDS:
|
||||
return False, True
|
||||
return False, False
|
||||
|
||||
|
||||
def _clean(fields):
|
||||
"""把接口来的字段清洗成可落库的值。只处理传进来的键。返回 (values, error)。"""
|
||||
out = {}
|
||||
for k in FIELDS:
|
||||
if k not in (fields or {}):
|
||||
continue
|
||||
v = fields.get(k)
|
||||
out[k] = _norm_bool(v)[0] if k in BOOL_FIELDS else str(v or "").strip()
|
||||
if "device_name" in out and not out["device_name"]:
|
||||
return {}, "设备号不能为空"
|
||||
if "douyin_id" in out and not out["douyin_id"]:
|
||||
return {}, "抖音号不能为空"
|
||||
return out, ""
|
||||
|
||||
|
||||
# ================== 查 ==================
|
||||
def get_by_id(acc_id):
|
||||
"""取一条（dict）或 None。
|
||||
|
||||
**跨边界一律返回 dict**：commit 之后 ORM 行的属性会过期，出了 app context
|
||||
再读属性会抛 DetachedInstanceError（接口层 `row.to_dict()` 必炸）。
|
||||
"""
|
||||
with _ctx():
|
||||
row = DeviceAccount.query.get(acc_id)
|
||||
return row.to_dict() if row else None
|
||||
|
||||
|
||||
def find_by_douyin(douyin_id, exclude_id=""):
|
||||
"""按抖音号找已存在的那条（唯一性判据；空号不参与）。返回 (id, 设备号) 或 None。
|
||||
|
||||
只返回两个纯值，同样是为了不让 ORM 行溜出 context。
|
||||
"""
|
||||
d = str(douyin_id or "").strip()
|
||||
if not d:
|
||||
return None
|
||||
with _ctx():
|
||||
q = DeviceAccount.query.filter(DeviceAccount.douyin_id == d)
|
||||
if exclude_id:
|
||||
q = q.filter(DeviceAccount.id != exclude_id)
|
||||
row = q.first()
|
||||
return (row.id, row.device_name or "") if row else None
|
||||
|
||||
|
||||
def list_accounts(device_name="", q="", limit=500):
|
||||
"""列表 + 统计（「账号」页用）。返回 (rows, stats)。"""
|
||||
with _ctx():
|
||||
query = DeviceAccount.query
|
||||
if device_name:
|
||||
query = query.filter(DeviceAccount.device_name == device_name)
|
||||
if q:
|
||||
like = f"%{q.strip()}%"
|
||||
query = query.filter(db.or_(DeviceAccount.douyin_id.like(like),
|
||||
DeviceAccount.phone.like(like),
|
||||
DeviceAccount.nickname.like(like)))
|
||||
rows = (query.order_by(DeviceAccount.device_name, DeviceAccount.id)
|
||||
.limit(max(1, min(int(limit or 500), 2000))).all())
|
||||
all_rows = DeviceAccount.query.all()
|
||||
stats = {
|
||||
"total": len(all_rows),
|
||||
"devices": len({r.device_name for r in all_rows if r.device_name}),
|
||||
"can_post_video": len([r for r in all_rows if r.can_post_video]),
|
||||
"shown": len(rows),
|
||||
}
|
||||
return [r.to_dict() for r in rows], stats
|
||||
|
||||
|
||||
def device_names():
|
||||
"""台账里出现过的设备号（筛选下拉用）。"""
|
||||
try:
|
||||
with _ctx():
|
||||
return sorted({r.device_name for r in DeviceAccount.query.all() if r.device_name})
|
||||
except Exception:
|
||||
return []
|
||||
|
||||
|
||||
def for_device(serial="", device_name=""):
|
||||
"""这台设备的账号。serial 优先，再按设备名（换 IP / 改名都找得到）。
|
||||
|
||||
`serial` 是**录入时的快照**：设备换 IP 后台账里那条还是旧地址，
|
||||
所以两边都查一遍并按抖音号去重。
|
||||
"""
|
||||
with _ctx():
|
||||
rows, seen = [], set()
|
||||
if serial:
|
||||
for r in DeviceAccount.query.filter(DeviceAccount.serial == serial).all():
|
||||
rows.append(r)
|
||||
seen.add(r.douyin_id)
|
||||
name = device_name
|
||||
if not name and serial:
|
||||
dev = Device.query.get(serial)
|
||||
name = (dev.name if dev else "") or ""
|
||||
if name:
|
||||
for r in DeviceAccount.query.filter(DeviceAccount.device_name == name).all():
|
||||
if r.douyin_id not in seen:
|
||||
rows.append(r)
|
||||
seen.add(r.douyin_id)
|
||||
return [r.to_dict() for r in rows]
|
||||
|
||||
|
||||
def resolve_device(serial="", device_name=""):
|
||||
"""serial/设备名 → (设备号, 账号行, 说明)。
|
||||
|
||||
"本机是哪台设备"这条链只在这一个地方定义，任务侧和设备端都走它 ——
|
||||
两套规则必然分叉（那会变成"任务取到 3 个号、页面显示 0 个号"这种鬼故事）。
|
||||
"""
|
||||
name = (device_name or "").strip()
|
||||
if not name and serial:
|
||||
with _ctx():
|
||||
dev = Device.query.get(serial)
|
||||
name = (dev.name if dev else "") or ""
|
||||
rows = for_device(serial=serial, device_name=name)
|
||||
# 兜底：台账里有人把"设备号"直接填成地址（手填习惯），按 serial 再认一次
|
||||
if not rows and serial:
|
||||
with _ctx():
|
||||
hit = DeviceAccount.query.filter(DeviceAccount.device_name == serial).all()
|
||||
if hit:
|
||||
name = serial
|
||||
rows = [r.to_dict() for r in hit]
|
||||
if not rows:
|
||||
note = (f"设备名『{name}』在台账里没有账号" if name
|
||||
else f"设备 {serial or '（无地址）'} 认不出设备名（设备池里没登记或还没刷新）")
|
||||
if serial and name:
|
||||
note += f"，地址 {serial} 也没对上台账"
|
||||
return name, [], note
|
||||
return name, rows, f"设备『{name}』登记 {len(rows)} 个号"
|
||||
|
||||
|
||||
def douyin_ids(scope, serial="", device_name="", group=""):
|
||||
"""按范围取抖音号（任务「条件判断」取号用）。返回 (去重后的纯号列表, 说明)。
|
||||
|
||||
说明是给日志/步骤明细看的**人话解释** —— 取不到号时它是唯一线索
|
||||
（取不到候选值的后果是"这一步永远不命中"，但任务本身会正常跑完）。
|
||||
scope: `device`=本机台账 / `all`=全部 / `group`=某设备分组 / 其他=不取
|
||||
"""
|
||||
scope = (scope or "").strip()
|
||||
if scope in ("", "manual", "none"):
|
||||
return [], ""
|
||||
try:
|
||||
with _ctx():
|
||||
if scope == "device":
|
||||
_, rows, note = resolve_device(serial=serial, device_name=device_name)
|
||||
return _uniq([r.get("douyin_id") for r in rows]), note
|
||||
if scope == "all":
|
||||
ids = _uniq([r.douyin_id for r in DeviceAccount.query.all()])
|
||||
return ids, f"全部台账共 {len(ids)} 个号"
|
||||
if scope == "group":
|
||||
names = _device_names_of_group(group)
|
||||
if not names:
|
||||
return [], f"设备分组『{group}』没有设备（或分组不存在）"
|
||||
rows = DeviceAccount.query.filter(
|
||||
DeviceAccount.device_name.in_(list(names))).all()
|
||||
ids = _uniq([r.douyin_id for r in rows])
|
||||
return ids, f"设备分组『{group}』（{len(names)} 台设备）共 {len(ids)} 个号"
|
||||
return [], f"未知的取号范围 {scope!r}"
|
||||
except Exception as e:
|
||||
# 取号失败绝不拦住任务：返回空，由调用方回落到手填值
|
||||
_log.warning(f"台账取号失败（回落手填值）: {e}")
|
||||
return [], f"台账取号失败: {e}"
|
||||
|
||||
|
||||
def _uniq(ids):
|
||||
out, seen = [], set()
|
||||
for i in ids or []:
|
||||
s = str(i or "").strip()
|
||||
if s and s not in seen:
|
||||
seen.add(s)
|
||||
out.append(s)
|
||||
return out
|
||||
|
||||
|
||||
def _device_names_of_group(group_name):
|
||||
"""设备分组 → 设备名集合（分组里存的是 serial，这里换成台账里的设备号）。"""
|
||||
g = DeviceGroup.query.filter(DeviceGroup.name == (group_name or "").strip()).first()
|
||||
if not g:
|
||||
return set()
|
||||
serials = g.get_serials() or []
|
||||
if not serials:
|
||||
return set()
|
||||
devs = Device.query.filter(Device.serial.in_(list(serials))).all()
|
||||
return {d.name for d in devs if d.name}
|
||||
|
||||
|
||||
def counts_by_device():
|
||||
"""{设备名: 号数}（设备池显示"这台几个号"用，一次拿全避免 N 次请求）。"""
|
||||
try:
|
||||
with _ctx():
|
||||
out = {}
|
||||
for r in DeviceAccount.query.all():
|
||||
if r.device_name:
|
||||
out[r.device_name] = out.get(r.device_name, 0) + 1
|
||||
return out
|
||||
except Exception as e:
|
||||
_log.warning(f"台账统计失败: {e}")
|
||||
return {}
|
||||
|
||||
|
||||
def by_device():
|
||||
"""{设备名: {count, accounts[]}}（设备维度查看弹窗用）。"""
|
||||
groups = {}
|
||||
try:
|
||||
with _ctx():
|
||||
for r in DeviceAccount.query.order_by(DeviceAccount.douyin_id).all():
|
||||
g = groups.setdefault(r.device_name or "", {"count": 0, "accounts": []})
|
||||
g["count"] += 1
|
||||
g["accounts"].append(r.to_dict())
|
||||
except Exception as e:
|
||||
_log.warning(f"台账按设备分组失败: {e}")
|
||||
return groups
|
||||
|
||||
|
||||
def agent_accounts(serial="", device_name="", limit=50, include_phone=False):
|
||||
"""设备端 Agent 的账号块（身份大字页用）。
|
||||
|
||||
· **默认不带手机号**：大字页是放在机器旁的公开屏幕，手机号不该默认上屏
|
||||
· 超量**按整条丢**（`truncated=True`），绝不按字节切 —— 切了就是坏 JSON，
|
||||
设备端只能整块丢掉
|
||||
· 任何异常都返回空块（不是抛）：台账坏了不能把"显示身份"这个动作弄坏
|
||||
"""
|
||||
try:
|
||||
name, rows, note = resolve_device(serial=serial, device_name=device_name)
|
||||
out = []
|
||||
for r in rows[:max(1, int(limit or 50))]:
|
||||
item = {"name": r.get("nickname") or "", "douyin_id": r.get("douyin_id") or "",
|
||||
"device_name": r.get("device_name") or "", "device_no": name,
|
||||
"sim_in_device": bool(r.get("sim_in_device")),
|
||||
"can_post_video": bool(r.get("can_post_video"))}
|
||||
if include_phone:
|
||||
item["phone"] = r.get("phone") or ""
|
||||
out.append(item)
|
||||
return {"v": 1, "total": len(rows), "shown": len(out),
|
||||
"truncated": len(out) < len(rows), "accounts": out, "note": note}
|
||||
except Exception as e:
|
||||
_log.warning(f"设备端账号块生成失败: {e}")
|
||||
return {"v": 1, "total": 0, "shown": 0, "truncated": False, "accounts": [],
|
||||
"note": f"读取失败: {e}"}
|
||||
|
||||
|
||||
# ================== 增 / 改 / 删 ==================
|
||||
def add(fields):
|
||||
"""新增一条。返回 (dict, error)。"""
|
||||
values, err = _clean(fields)
|
||||
if err:
|
||||
return None, err
|
||||
if not values.get("device_name"):
|
||||
return None, "设备号不能为空"
|
||||
if not values.get("douyin_id"):
|
||||
return None, "抖音号不能为空"
|
||||
# try 必须在 `with _ctx()` 里面：否则 rollback 自己会在 context 外抛
|
||||
# RuntimeError，把真正的错误盖掉（这条踩过一次，别挪出去）
|
||||
with _ctx():
|
||||
try:
|
||||
if find_by_douyin(values["douyin_id"]):
|
||||
return None, f"抖音号 {values['douyin_id']} 已在台账里（一个号只能有一条）"
|
||||
row = DeviceAccount(id=uuid.uuid4().hex[:8], created_at=_now(), updated_at=_now())
|
||||
for k in FIELDS:
|
||||
# 没传的布尔列必须是 False，不能是 ""（Boolean 列收到空串会直接报
|
||||
# TypeError: Not a boolean value，整条插不进去）
|
||||
setattr(row, k, values.get(k, False if k in BOOL_FIELDS else ""))
|
||||
_fill_serial(row)
|
||||
db.session.add(row)
|
||||
db.session.commit()
|
||||
_log.info(f"账号台账新增：{row.device_name} / {row.nickname} / {row.douyin_id}")
|
||||
return row.to_dict(), "" # 出 context 前转成纯值
|
||||
except Exception as e:
|
||||
db.session.rollback()
|
||||
return None, f"保存失败: {e}"
|
||||
|
||||
|
||||
def update(acc_id, fields):
|
||||
"""改一条（只改传进来的键）。返回 (dict, error)。"""
|
||||
with _ctx():
|
||||
try:
|
||||
row = DeviceAccount.query.get(acc_id)
|
||||
if not row:
|
||||
return None, "记录不存在"
|
||||
values, err = _clean(fields)
|
||||
if err:
|
||||
return None, err
|
||||
new_id = values.get("douyin_id", row.douyin_id)
|
||||
dup = find_by_douyin(new_id, exclude_id=acc_id)
|
||||
if dup:
|
||||
return None, f"抖音号 {new_id} 已被 {dup[1]} 占用（一个号只能有一条）"
|
||||
for k, v in values.items():
|
||||
setattr(row, k, v)
|
||||
row.updated_at = _now()
|
||||
_fill_serial(row)
|
||||
db.session.commit()
|
||||
return row.to_dict(), ""
|
||||
except Exception as e:
|
||||
db.session.rollback()
|
||||
return None, f"保存失败: {e}"
|
||||
|
||||
|
||||
def delete(acc_id):
|
||||
"""删一条（删掉之后任务就取不到这个号了）。"""
|
||||
with _ctx():
|
||||
try:
|
||||
row = DeviceAccount.query.get(acc_id)
|
||||
if not row:
|
||||
return False
|
||||
db.session.delete(row)
|
||||
db.session.commit()
|
||||
_log.info(f"账号台账删除：{row.device_name} / {row.nickname} / {row.douyin_id}")
|
||||
return True
|
||||
except Exception as e:
|
||||
db.session.rollback()
|
||||
_log.warning(f"账号台账删除失败: {e}")
|
||||
return False
|
||||
|
||||
|
||||
def _fill_serial(row):
|
||||
"""按设备名补 serial 快照（台账只填设备号时，自动关联设备池那条）。"""
|
||||
if row.serial:
|
||||
return
|
||||
if not row.device_name:
|
||||
return
|
||||
dev = Device.query.filter(Device.name == row.device_name).first()
|
||||
if dev:
|
||||
row.serial = dev.serial
|
||||
|
||||
|
||||
# ================== 粘贴导入 ==================
|
||||
def parse_paste(text, delimiter="\t"):
|
||||
"""把粘贴的表格文本解析成台账行。返回 (rows, errors)。
|
||||
|
||||
rows 里每行是 `{"_line": 3, "device_name": "...", ..., "_warns": [...]}`
|
||||
（`_line` = 粘贴文本里的行号，界面把错误指回原行；`_warns` 是"能导但要注意"的提示）。
|
||||
errors 是 `[{"line": 3, "reason": "..."}]`（这些行会被跳过）。
|
||||
|
||||
分隔符默认 Tab（Excel 直接粘贴就是 Tab）。**不做"多个空格当分隔"**——
|
||||
账号名里本来就有双空格（实测 `有牛奶面包 你吃吗？`），按空格切会切坏。
|
||||
带表头时按列名映射（顺序随意、缺列留空）；不带表头则按 DEFAULT_ORDER 的固定顺序。
|
||||
"""
|
||||
if delimiter not in ("\t", "|", ","):
|
||||
delimiter = "\t"
|
||||
text = (text or "").replace("\r\n", "\n").replace("\r", "\n")
|
||||
lines = [(i + 1, ln) for i, ln in enumerate(text.split("\n")) if ln.strip()]
|
||||
if not lines:
|
||||
return [], [{"line": 0, "reason": "没有可解析的内容"}]
|
||||
|
||||
first_cells = [c.strip() for c in lines[0][1].split(delimiter)]
|
||||
mapped = _map_header(first_cells)
|
||||
if mapped:
|
||||
body = lines[1:]
|
||||
else:
|
||||
mapped = {name: i for i, name in enumerate(DEFAULT_ORDER)}
|
||||
body = lines
|
||||
if not body:
|
||||
return [], [{"line": lines[0][0], "reason": "只有表头，没有数据行"}]
|
||||
|
||||
rows, errors = [], []
|
||||
for lineno, line in body:
|
||||
cells = line.split(delimiter)
|
||||
row = {"_line": lineno, "_warns": []}
|
||||
for f in FIELDS: # 先把所有字段填上，缺列留空
|
||||
row[f] = ""
|
||||
for field, idx in mapped.items():
|
||||
if field in FIELDS:
|
||||
row[field] = cells[idx].strip() if idx < len(cells) else ""
|
||||
if not row["device_name"] and not row["douyin_id"]:
|
||||
errors.append({"line": lineno, "reason": "设备号与抖音号都是空的，已跳过"})
|
||||
continue
|
||||
if not row["device_name"]:
|
||||
errors.append({"line": lineno, "reason": "缺设备号，已跳过"})
|
||||
continue
|
||||
if not row["douyin_id"]:
|
||||
errors.append({"line": lineno, "reason": "缺抖音号，已跳过"})
|
||||
continue
|
||||
for f in BOOL_FIELDS:
|
||||
raw = row[f]
|
||||
val, known = _norm_bool(raw)
|
||||
row[f] = val
|
||||
if not known:
|
||||
row["_warns"].append(f"『{raw}』认不出，按「否」处理")
|
||||
if not _DOUYIN_RE.match(row["douyin_id"]):
|
||||
row["_warns"].append(f"抖音号『{row['douyin_id']}』不是纯数字 —— "
|
||||
f"任务比对时可能匹配不上")
|
||||
rows.append(row)
|
||||
return rows, errors
|
||||
|
||||
|
||||
def _map_header(cells):
|
||||
"""列名 → 列下标（认不出"设备号+抖音号"时返回 {}，按固定顺序解析）。"""
|
||||
mapping = {}
|
||||
for idx, cell in enumerate(cells):
|
||||
c = re.sub(r"\s+", "", cell or "")
|
||||
if not c:
|
||||
continue
|
||||
for field, aliases in HEADER_ALIASES.items():
|
||||
if field in mapping:
|
||||
continue
|
||||
if any(c == a or c.startswith(a) for a in aliases):
|
||||
mapping[field] = idx
|
||||
break
|
||||
if "device_name" in mapping and "douyin_id" in mapping:
|
||||
return mapping
|
||||
return {}
|
||||
|
||||
|
||||
def import_rows(rows, mode="skip", dry_run=False):
|
||||
"""把解析好的行落库（或只预览）。返回逐行结果 + 汇总。
|
||||
|
||||
mode=`skip`（默认）：抖音号已在台账里 → 跳过（不动现有那条）
|
||||
mode=`overwrite`：抖音号已在台账里 → 用粘贴的这行**整行覆盖**它
|
||||
dry_run=True：只判重、不写库（界面上"先预览后导入"）
|
||||
"""
|
||||
mode = mode if mode in ("skip", "overwrite") else "skip"
|
||||
counts = {"total": 0, "added": 0, "updated": 0, "skipped": 0, "failed": 0}
|
||||
out_rows = []
|
||||
for row in rows or []:
|
||||
line = row.get("_line", 0)
|
||||
fields = {k: v for k, v in row.items() if k not in ("_line", "_warns")}
|
||||
counts["total"] += 1
|
||||
existing = find_by_douyin(fields.get("douyin_id"))
|
||||
item = {"line": line, "device_name": fields.get("device_name", ""),
|
||||
"douyin_id": fields.get("douyin_id", ""),
|
||||
"nickname": fields.get("nickname", ""),
|
||||
"warns": list(row.get("_warns") or []), "error": ""}
|
||||
if existing:
|
||||
if mode == "overwrite":
|
||||
item["action"] = "update"
|
||||
if not dry_run:
|
||||
_, err = update(existing[0], fields)
|
||||
if err:
|
||||
item["action"], item["error"] = "fail", err
|
||||
counts["updated" if item["action"] == "update" else "failed"] += 1
|
||||
else:
|
||||
item["action"] = "skip"
|
||||
item["error"] = f"已存在（{existing[1]}），跳过"
|
||||
counts["skipped"] += 1
|
||||
else:
|
||||
item["action"] = "add"
|
||||
if not dry_run:
|
||||
_, err = add(fields)
|
||||
if err:
|
||||
item["action"], item["error"] = "fail", err
|
||||
counts["added" if item["action"] == "add" else "failed"] += 1
|
||||
out_rows.append(item)
|
||||
if not dry_run:
|
||||
_log.info(f"账号台账导入：新增 {counts['added']}、覆盖 {counts['updated']}、"
|
||||
f"跳过 {counts['skipped']}、失败 {counts['failed']}")
|
||||
return {"counts": counts, "rows": out_rows, "mode": mode, "dry_run": bool(dry_run)}
|
||||
@@ -436,6 +436,54 @@ class DoneMark(db.Model):
|
||||
)
|
||||
|
||||
|
||||
class DeviceAccount(db.Model):
|
||||
"""账号台账：一台设备上登录着哪些账号（「账号」页）。
|
||||
|
||||
要解决的问题（用户场景）：一台手机登好几个抖音号、十几台手机四五十个号，
|
||||
账号信息散在一张电子表格里 —— 换 IP、加号、想查"这台登的是哪几个号"都要翻表。
|
||||
这里把台账落进平台：web 能查能改（支持从表格粘贴导入），
|
||||
手机端 Agent 的「身份大字页」顺带显示本机账号，任务的「条件判断」
|
||||
也可以直接从台账取号（不用再把号一个个手写进 cmp_value）。
|
||||
|
||||
⚠ **`douyin_id` 是纯号（`35377983067`），而元素原文是 `抖音号：35377983067`。**
|
||||
- 当条件判断的**比对值**可以 ✓（运算符用「包含」，纯号是子串）
|
||||
- **绝不能当去重身份** ✗ —— `done_mark.identity` 存的是元素原文、逐字算 key，
|
||||
格式不一致会让去重**静默失效**（见 `core/dedup.py`）。
|
||||
|
||||
`device_name` 是设备号（平台设备名，如 A01）；`serial` 是**录入时的地址快照**，
|
||||
设备换 IP 或改名后，台账靠任一侧都能找回来（见 `core/ledger.for_device`）。
|
||||
同一抖音号不允许两条 —— 唯一性由服务层保证（号可能为空，DB 层要做
|
||||
"部分唯一索引"三处方言适配，人工维护的几十条不值当）。
|
||||
"""
|
||||
__tablename__ = "device_account"
|
||||
id = db.Column(db.String(32), primary_key=True) # uuid 前 8 位
|
||||
device_name = db.Column(db.String(80), default="", index=True) # 设备号（平台设备名）
|
||||
serial = db.Column(db.String(120), default="") # 录入时的地址快照
|
||||
phone = db.Column(db.String(32), default="", index=True) # 手机号
|
||||
nickname = db.Column(db.String(80), default="") # 账号名称
|
||||
douyin_id = db.Column(db.String(64), default="", index=True) # 抖音号（纯号，不带前缀）
|
||||
registered_at = db.Column(db.String(20), default="") # 注册时间（原样存文本）
|
||||
sim_in_device = db.Column(db.Boolean, default=False) # 卡在机内（空=否）
|
||||
can_post_video = db.Column(db.Boolean, default=False) # 可发视频（空=否）
|
||||
bio = db.Column(db.Text, default="") # 简介
|
||||
note = db.Column(db.Text, default="") # 备注
|
||||
created_at = db.Column(db.String(20), default="")
|
||||
updated_at = db.Column(db.String(20), default="")
|
||||
|
||||
def to_dict(self):
|
||||
return {"id": self.id, "device_name": self.device_name or "",
|
||||
"serial": self.serial or "", "phone": self.phone or "",
|
||||
"nickname": self.nickname or "", "douyin_id": self.douyin_id or "",
|
||||
"registered_at": self.registered_at or "",
|
||||
"sim_in_device": bool(self.sim_in_device),
|
||||
"can_post_video": bool(self.can_post_video),
|
||||
"bio": self.bio or "", "note": self.note or "",
|
||||
"created_at": self.created_at or "", "updated_at": self.updated_at or ""}
|
||||
|
||||
def __repr__(self):
|
||||
return f"<DeviceAccount {self.device_name} {self.nickname}>"
|
||||
|
||||
|
||||
class AgentConversation(db.Model):
|
||||
"""AI 控制台会话：整个消息序列以 JSON 存在一行里（单会话几十 KB，够用）。"""
|
||||
__tablename__ = "agent_conversation"
|
||||
@@ -461,6 +509,7 @@ SCHEMA_MIGRATIONS = [
|
||||
(5, "设备池：device 表新增 fingerprint 列（设备指纹 ro.serialno，换 IP 后认领回原记录）", None),
|
||||
(6, "自动发现：pending_device 表新增 fingerprint 列（扫描时读取，用于提示是已有设备换了 IP）", None),
|
||||
(7, "去重账本：done_mark 表（跨设备幂等的「已做过」标记，唯一索引 scope_key）", None),
|
||||
(8, "账号台账：device_account 表（设备号/手机号/账号名称/抖音号/注册时间/卡在机内/可发视频/简介/备注）", None),
|
||||
]
|
||||
|
||||
# 当前 schema 版本（备份/恢复用它判断新旧，也写进 app_meta.schema_version）
|
||||
|
||||
@@ -58,6 +58,7 @@ TABLE_LABELS = {
|
||||
"agent_action": "动作库", "device_install_log": "设备端安装记录",
|
||||
"task_step_log": "任务步骤明细",
|
||||
"done_mark": "去重记录（已做过）",
|
||||
"device_account": "账号台账",
|
||||
}
|
||||
_STAGE_TTL = 1800 # 导入暂存有效期（秒）
|
||||
|
||||
|
||||
+10
-1
@@ -225,12 +225,21 @@ def validate_steps(steps, depth=1, path="steps", errors=None, warnings=None,
|
||||
# 执行器对认不出的运算符是"一律不命中"，写错了会静默走 else，
|
||||
# 所以在这里拦住，别让 AI 草稿悄悄变成"永远不命中"
|
||||
cmp_op = (params.get("cmp_op") or "").strip()
|
||||
cmp_src = (params.get("cmp_source") or "").strip()
|
||||
if cmp_src not in ("", "manual", "device", "all", "group"):
|
||||
errors.append(f"{here}.params.cmp_source: 不支持的候选值来源 {cmp_src!r}"
|
||||
f"（可用：空/manual/device/all/group）")
|
||||
if cmp_src == "group" and not (params.get("cmp_group") or "").strip():
|
||||
warnings.append(f"{here}: 候选值来源是「按设备分组」，但没填分组名 —— 取不到号")
|
||||
if cmp_op:
|
||||
from tasks.generic.task import CMP_OPS
|
||||
if cmp_op not in CMP_OPS:
|
||||
errors.append(f"{here}.params.cmp_op: 不支持的比对运算符 {cmp_op!r}"
|
||||
f"（可用：{'、'.join(CMP_OPS)}）")
|
||||
elif not str(params.get("cmp_value") or "").strip():
|
||||
elif not str(params.get("cmp_value") or "").strip() \
|
||||
and cmp_src not in ("device", "all", "group"):
|
||||
# 候选值来自台账时允许手填留空（台账取号就够）；
|
||||
# 其余情况仍要求填值，否则永远不命中
|
||||
errors.append(f"{here}.params.cmp_value: 选了文本比对"
|
||||
f"（{cmp_op}）就必须填比对的值，否则永远不命中")
|
||||
elif (params.get("selector_type") or "xpath") == "screen":
|
||||
|
||||
+37
-1
@@ -137,6 +137,12 @@
|
||||
| GET | `/api/done_marks?job=&limit=` | L | 去重记录列表 + 统计（`{marks, stats{total,devices,identities,today_devices,today_identities}}`） |
|
||||
| POST | `/api/done_marks/delete` | T | 删一条去重记录（`{id}`）→ 该设备/身份下次会重新执行 |
|
||||
| POST | `/api/done_marks/clear` | T | 清空某任务的全部去重记录（`{job}`）→ 整批重跑 |
|
||||
| GET | `/api/ledger?device=&q=&limit=` | D | 账号台账列表 + 统计（`{accounts, stats{total,devices,can_post_video,shown}, device_names}`） |
|
||||
| GET | `/api/ledger/by_device` | D | 按设备分组（`{devices:{设备号:{count,accounts[]}}, counts:{设备号:N}}`） |
|
||||
| POST | `/api/ledger` | D | 新增账号（抖音号重复 → 400） |
|
||||
| PUT | `/api/ledger/<acc_id>` | D | 改一条账号 |
|
||||
| DELETE | `/api/ledger/<acc_id>` | D | 删一条账号 |
|
||||
| POST | `/api/ledger/import` | D | 从表格粘贴文本批量导入（`dry_run=true` 只预览不写库） |
|
||||
|
||||
### 2.4 admin（`web/admin_api.py`）
|
||||
|
||||
@@ -482,6 +488,36 @@
|
||||
账本表与语义见 [DATA_MODEL.md](DATA_MODEL.md) §2.9；任务侧怎么用见
|
||||
[TASK_DEV.md](TASK_DEV.md) §4.6。
|
||||
|
||||
### 账号台账（「账号」页）
|
||||
|
||||
数据在 `device_account` 表（[DATA_MODEL.md](DATA_MODEL.md) §2.10），服务层 `core/ledger.py`，
|
||||
权限 `devices`。
|
||||
|
||||
| 接口 | 请求 | 响应要点 |
|
||||
|------|------|---------|
|
||||
| `GET /api/ledger` | `?device=<设备号>&q=<搜索>&limit=500` | `{ok, accounts:[{id,device_name,serial,phone,nickname,douyin_id,registered_at,sim_in_device,can_post_video,bio,note,created_at,updated_at}], stats:{total,devices,can_post_video,shown}, device_names:["A01",…]}`。`q` 匹配抖音号/手机号/账号名 |
|
||||
| `GET /api/ledger/by_device` | — | `{ok, devices:{A01:{count,accounts:[…]}}, counts:{A01:4}}`（设备池"账号 N"列 + 点开看明细都用它，省一次请求） |
|
||||
| `POST /api/ledger` | 9 个字段（`device_name`/`douyin_id` 必填） | `{ok,msg,account}`；缺必填或抖音号重复 → **400** |
|
||||
| `PUT /api/ledger/<id>` | 局部字段 | `{ok,msg,account}`；不存在 → 404；抖音号撞车 → 400 |
|
||||
| `DELETE /api/ledger/<id>` | — | `{ok,msg}`；不存在 → 404 |
|
||||
| `POST /api/ledger/import` | `{"text":"…","delimiter":"\\t","mode":"skip\|overwrite","dry_run":true}` | `{ok, counts:{total,added,updated,skipped,failed}, rows:[{line,action,device_name,douyin_id,nickname,error,warns}], errors:[{line,reason}], mode, dry_run}` |
|
||||
|
||||
**导入语义**（解析规则见 `core/ledger.parse_paste`）：
|
||||
|
||||
- 分隔符默认 **Tab**（Excel 直接粘贴就是 Tab）；也支持 `|` 与 `,`。**不做"多个空格当分隔"**——
|
||||
账号名里本来就有双空格（实测 `有牛奶面包 你吃吗？`）。
|
||||
- **带表头**时按列名映射（顺序随意、缺列留空、认不出的列忽略）；**不带表头**则按
|
||||
设备号/手机号/账号名称/抖音号/注册时间/卡在机内/可发视频/简介/备注 的固定顺序。
|
||||
- 「卡在机内 / 可发视频」认 `是/有/1/true` → True，`否/空` → False；认不出的值按"否"处理
|
||||
并在该行 `warns` 里留痕。
|
||||
- 抖音号非纯数字也会 `warns` 留痕（不拦）——它会让任务比对匹配不上。
|
||||
- `mode=skip`：库里有同号 → 跳过；`mode=overwrite`：**整行替换**（空单元格会覆盖掉原值）。
|
||||
- `dry_run=true` 走同一条解析+判重路径但**一个字节都不写**（界面默认先预览再导入）。
|
||||
- 缺设备号或抖音号的行会被跳过，并在 `errors` 里带行号说明。
|
||||
|
||||
> ⚠ 台账里的抖音号是**纯号**，只当"比对用的候选值"；**不要**拿它填「去重」的身份元素
|
||||
> （身份是元素原文逐字算 key，格式不同会让去重**静默失效**）。
|
||||
|
||||
---
|
||||
|
||||
## 6. 设备池与自动发现
|
||||
@@ -719,7 +755,7 @@
|
||||
|
||||
| 接口 | 请求 | 说明 |
|
||||
|------|------|------|
|
||||
| `POST /api/tools/clipboard/set` | `{"serials":[…],"text":"…"}` | ClipInject 通道写入并读回校验；serials 空或非列表 → 400 |
|
||||
| `POST /api/tools/clipboard/set` | `{"serials":[…],"text":"…"}` | 设备端 Agent 通道写入并读回校验（旧版独立 ClipInject 自动兜底）；serials 空或非列表 → 400 |
|
||||
| `POST /api/tools/appver` | `{"package":"com.xxx"}` | 并发查所有在线设备（≤10 并发）；包名须匹配 `^[A-Za-z0-9_.]+$` |
|
||||
|
||||
### Tailscale（全部 Admin）
|
||||
|
||||
+3
-1
@@ -270,7 +270,7 @@ connecting ──获取设备──▶ u2 连接 ──▶ running ──▶ set
|
||||
|
||||
### 6.1 单页应用
|
||||
|
||||
- 主页面 `templates/admin/monitor.html`：一个内联 `<style>` + 7 个 Tab 面板 + 10 个模态框容器 + 16 个 `<script src>`
|
||||
- 主页面 `templates/admin/monitor.html`：一个内联 `<style>` + 8 个 Tab 面板 + 10 个模态框容器 + 17 个 `<script src>`
|
||||
- 独立页面：`login.html`（登录）、`wall.html`（监控大屏，**完全自包含**，自带 CSS/JS，不加载 `static/admin/*.js`）
|
||||
- 服务端内联页：`GET /locate`（设备端定位大字页，免登录）
|
||||
- 响应头强制 `no-store`，避免后台改版后浏览器拿旧页面
|
||||
@@ -280,6 +280,7 @@ connecting ──获取设备──▶ u2 连接 ──▶ running ──▶ set
|
||||
| 顶级 Tab | `data-tab` | 权限 | 子分栏 |
|
||||
|---------|-----------|------|--------|
|
||||
| 监控 | `monitor` | 登录即可 | — |
|
||||
| 账号 | `account` | `devices` | — （账号台账：列表 / 增删改 / 从表格粘贴导入，见 [DATA_MODEL.md](DATA_MODEL.md) §2.10） |
|
||||
| 任务 | `tasks` | 登录即可（写操作需 `tasks`） | `plan` 任务计划 / `actions` 自定义动作 / `actioncfg` 动作配置 / `dedup` 去重记录 |
|
||||
| 日志 | `logs` | `logs` | — |
|
||||
| 用户 | `users` | `admin` | — |
|
||||
@@ -296,6 +297,7 @@ connecting ──获取设备──▶ u2 连接 ──▶ running ──▶ set
|
||||
| `base.js` | esc / CSRF / 权限 / API 封装 / Toast / Tab 与子分栏切换 / 模态框 / 常量表 | 所有模块的公共底座 |
|
||||
| `markdown.js` | 轻量 Markdown 渲染（`renderMarkdown`） | 无 CDN 依赖；**先转义再套标记** |
|
||||
| `list.js` | 统一列表组件：搜索 + 分页 + 排序 | 状态注册表 `_LIST_PAGERS`；`setListPager` **不重置**页码/搜索/排序（避免轮询刷新打断用户） |
|
||||
| `ledger.js` | 账号台账页（列表 / 单条增删改 / 从表格粘贴导入 + 逐行结果 / 设备维度弹窗）+ `ledgerCell()` 供设备池那一列 | 服务层 `core/ledger.py`；导入默认**先预览再写**（`dry_run`） |
|
||||
| `monitor.js` | 监控页：设备表（含**电量列**，按 `battery.tier` 上色）、批量操作、异常汇总、任务概况卡片（含覆盖设备 chip） | 5s 轮询 + 脏检查（签名不变不重渲染） |
|
||||
| `editor.js` | 步骤编辑器（拖拽 / 参数表单 / 条件分支 / 元素抓取 / 测试此步骤）+ `saveTask` | 最大的前端文件；`_stepEditor` 单例；设备选择卡 `_devCard` 供「抓取元素」「测试此步骤」共用（**名字优先**，型号·地址作副标题） |
|
||||
| `tasks.js` | 任务 Tab：任务 CRUD / 调度解析 / 运行窗口 + 自定义动作 | |
|
||||
|
||||
+38
-1
@@ -27,7 +27,7 @@
|
||||
|
||||
启动时校验「`.env` 声明」与「库名」「库中登记的 `app_meta.deployment_env`」三方一致，不符**拒绝启动**。
|
||||
|
||||
**表清单（14 张，全部是 `core/models.py` 里的 ORM 模型）**
|
||||
**表清单（16 张，全部是 `core/models.py` 里的 ORM 模型）**
|
||||
|
||||
| # | 表 | 用途 |
|
||||
|---|---|------|
|
||||
@@ -45,6 +45,8 @@
|
||||
| 12 | `agent_action` | 动作库（命名动作） |
|
||||
| 13 | `device_install_log` | 设备端应用商店的下载/安装记录（设备上报，见 [DEVICE_AGENT.md](DEVICE_AGENT.md)） |
|
||||
| 14 | `task_step_log` | 任务步骤明细（每次步骤执行一条，见 §2.8；**唯一有无界增长风险的表**，靠保留期清理） |
|
||||
| 15 | `done_mark` | 去重账本：跨设备"已做过"标记（见 §2.9；本清单此前漏列，2026-09-24 补上） |
|
||||
| 16 | `device_account` | 账号台账：一台设备上登录着哪些账号（见 §2.10；任务「条件判断」的取号来源、设备端身份页显示用） |
|
||||
|
||||
> 2026-09-13 之前，`app_meta` 与 4 张 `agent_*` 表是各模块里的裸 `CREATE TABLE`
|
||||
> （不进模型层）。迁 MySQL 时那批 SQL 的 `AUTOINCREMENT`/`TEXT DEFAULT ''`/`TEXT PRIMARY KEY`
|
||||
@@ -197,6 +199,41 @@
|
||||
|
||||
⚠️ 这张表**自动进整库备份**（§6 派生规则）；接任务步骤见 [TASK_DEV.md](TASK_DEV.md) §4.6。
|
||||
|
||||
### 2.10 `device_account` — 账号台账（一台设备上登录着哪些账号）
|
||||
|
||||
「账号」页维护；服务层 `core/ledger.py`，接口 `/api/ledger*`（见 [API.md](API.md) §2.15）。
|
||||
|
||||
| 列 | 类型 | 说明 |
|
||||
|----|------|------|
|
||||
| `id` | String(32) PK | uuid 前 8 位 |
|
||||
| `device_name` | String(80) **index** | 设备号（= 设备池里的**设备名**，如 `A01`） |
|
||||
| `serial` | String(120) | 录入时的**地址快照**（设备换 IP / 改名后台账仍能靠任一侧找回） |
|
||||
| `phone` | String(32) index | 手机号 |
|
||||
| `nickname` | String(80) | 账号名称 |
|
||||
| `douyin_id` | String(64) index | **抖音号（纯号）**，如 `35377983067` |
|
||||
| `registered_at` | String(20) | 注册时间（**原样存文本**，如 `2026/9/24`） |
|
||||
| `sim_in_device` | Boolean | 卡在机内（**空 = 否**） |
|
||||
| `can_post_video` | Boolean | 可发视频（**空 = 否**） |
|
||||
| `bio` / `note` | Text | 简介 / 备注 |
|
||||
| `created_at` / `updated_at` | String(20) | 字符串时间（仓库惯例） |
|
||||
|
||||
**三个使用方**：
|
||||
|
||||
1. **web「账号」页** —— 列表 / 增删改 / 从 Excel 粘贴导入（解析规则见 `core/ledger.parse_paste`）
|
||||
2. **任务的「条件判断」取号** —— `if_el` 的 `cmp_source`（`device` 本机 / `all` 全部 / `group` 按设备分组），
|
||||
见 [TASK_DEV.md](TASK_DEV.md) §4.2
|
||||
3. **手机端 Agent 的身份大字页** —— 平台推 `accounts_b64`（见 [DEVICE_AGENT.md](DEVICE_AGENT.md) §5.2）
|
||||
|
||||
⚠️ **`douyin_id` 是纯号，绝不能当去重身份**：`done_mark.identity` 存的是**元素原文**
|
||||
（`抖音号：35377983067`）、逐字算 key，格式不一致会让去重**静默失效**。
|
||||
它只做"比对用的候选值"（运算符用「包含」时纯号是子串）。
|
||||
|
||||
**唯一性在应用层**（`core/ledger`）：同一抖音号不允许两条。没做成 DB 唯一索引的理由：
|
||||
抖音号可能为空，DB 级要写"部分唯一索引"（§4.2 那套 SQLite `WHERE` + MySQL 虚拟生成列），
|
||||
而台账是人工维护的几十条 —— 三处方言适配不划算。
|
||||
|
||||
这张表**自动进整库备份**（§6 派生规则）。
|
||||
|
||||
---
|
||||
|
||||
## 3. 非模型表
|
||||
|
||||
+7
-2
@@ -212,9 +212,10 @@ tail -20 logs/web.log # 无 ERROR/Traceback
|
||||
SUMMARY_TABLES = tuple(sorted(t.name for t in db.metadata.tables.values()))
|
||||
```
|
||||
|
||||
当前 15 张表：`app_meta` / `user` / `device_group` / `task_job` / `custom_action` /
|
||||
当前 16 张表：`app_meta` / `user` / `device_group` / `task_job` / `custom_action` /
|
||||
`apk_file` / `device` / `pending_device` / `agent_conversation` / `agent_experience` /
|
||||
`experience_audit` / `agent_action` / `device_install_log` / `task_step_log` / `done_mark`。
|
||||
`experience_audit` / `agent_action` / `device_install_log` / `task_step_log` / `done_mark` /
|
||||
`device_account`（账号台账）。
|
||||
完整说明见 [DATA_MODEL.md](DATA_MODEL.md) §6。
|
||||
|
||||
> ⚠️ `task_step_log`（任务步骤明细）是会持续增长的表：它按 `KEEP_DAYS`
|
||||
@@ -228,6 +229,10 @@ SUMMARY_TABLES = tuple(sorted(t.name for t in db.metadata.tables.values()))
|
||||
> 还需要手工做的只有：给新表补 `TABLE_LABELS` 的中文标签。
|
||||
> 导出侧有**覆盖自检**（登记表缺失 → `manifest.coverage_missing` + 日志告警）；
|
||||
> 导入侧有**反向自检**（备份含未登记表 → 预览告警）。
|
||||
>
|
||||
> **回滚注意事项**：把"含新表的备份"导回**旧版本代码**时，旧代码的 `SUMMARY_TABLES`
|
||||
> 里没有那张新表 → 导入预览会报 `extra_tables` 告警。**数据仍在快照里、不会丢**，
|
||||
> 属于预期行为（升级回新版即可正常识别）。
|
||||
|
||||
### 5.3 目录与手工备份
|
||||
|
||||
|
||||
+1
-1
@@ -198,7 +198,7 @@ MCP_ALLOW_WRITE=1 MCP_PLATFORM_USER=admin MCP_PLATFORM_PASS=<密码> \
|
||||
| 页面结构 / 样式 / 引入脚本 | `templates/admin/monitor.html` |
|
||||
| 公共工具（API/权限/Toast/Tab） | `static/admin/base.js` |
|
||||
| 列表分页排序 | `static/admin/list.js` |
|
||||
| 各功能域逻辑 | `static/admin/{monitor,editor,tasks,tools,apps,admin,agent,system,markdown}.js` |
|
||||
| 各功能域逻辑 | `static/admin/{monitor,editor,tasks,tools,apps,admin,agent,system,markdown,dedup,ledger}.js` |
|
||||
|
||||
新增 JS 模块：建文件 → 在 `monitor.html` 里按依赖顺序加 `<script src>` → 更新 [ARCHITECTURE.md](ARCHITECTURE.md) §6.3 与本文 §5.3。
|
||||
|
||||
|
||||
+60
-2
@@ -192,8 +192,18 @@ adb -s <serial> shell am start -n <pkg>/.ClipActivity --es text_b64 <base64(UTF-
|
||||
|
||||
- **必须 base64**：adb shell 直传中文/特殊字符会变形
|
||||
- 必须用**透明 Activity**（有焦点才能写剪贴板），写完**立即退出**
|
||||
- 平台判定失败的方式：`am start` 输出里有 `unable to resolve Intent` / `does not exist`
|
||||
→ 视为"设备未安装 Agent"
|
||||
- 平台判定失败的方式：`am start` 输出里有 `unable to resolve Intent` / `does not exist` /
|
||||
`Error type 3` → 视为"这台设备没有这个通道"
|
||||
|
||||
**平台按顺序试两个包**（`core/clipboard_helper.py` 的 `_CLIP_TARGETS`）：
|
||||
|
||||
| 顺序 | 包 | 说明 |
|
||||
|---|---|---|
|
||||
| 1 | `com.example.deviceagent`（**本 Agent**） | 现在的标准通道；装了就只调它 |
|
||||
| 2 | `com.example.clipinject`（早期独立 APK） | 老设备上可能还残留 → 兜底；走这条会在日志里提示"建议装设备端 Agent" |
|
||||
|
||||
两个都没有时报"设备未安装剪贴板注入通道：需要设备端 Agent"（不再只说 ClipInject，
|
||||
否则用户会去装那个已经不再分发的旧 APK）。**设备端无需为这条改动做任何事**。
|
||||
|
||||
### 5.2 设备身份显示（设备端已实现）
|
||||
|
||||
@@ -206,6 +216,51 @@ adb -s <serial> shell am start -n <pkg>/.InfoActivity \
|
||||
|
||||
要求：全屏大字、再次调用可覆盖内容、`close` 可关闭、不驻留前台。
|
||||
|
||||
#### 5.2.1 本机账号台账（`accounts_b64`，可选 extras — **需要设备端配合实现**）
|
||||
|
||||
平台在**打开**身份页时会顺带把这台设备在「账号」页登记的抖音账号推过去
|
||||
（`--es close 1` 时**不带**）。**中文必须 base64**（同 §5.1：adb shell 直传中文会变形）：
|
||||
|
||||
```bash
|
||||
adb -s <serial> shell am start -n <pkg>/.InfoActivity \
|
||||
--es name "A03" --es serial "192.168.20.63:5555" --es server "http://192.168.20.220:18050" \
|
||||
--es ip "192.168.20.63" \
|
||||
--es accounts_b64 "<base64(UTF-8 JSON)>"
|
||||
```
|
||||
|
||||
解码：**标准 base64**（不是 URL-safe）+ UTF-8。JSON 结构（字段名的设备端解析按名取，多余字段忽略）：
|
||||
|
||||
```json
|
||||
{"v":1,"total":4,"shown":4,"truncated":false,
|
||||
"note":"设备『A03』登记 4 个号",
|
||||
"accounts":[
|
||||
{"name":"AA建材王总","douyin_id":"66057500463","device_name":"A03","device_no":"A03",
|
||||
"sim_in_device":true,"can_post_video":true}]}
|
||||
```
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| `v` | 本块格式版本（当前 **1**）。解不出来时用它区分"格式变了"与"平台没给" |
|
||||
| `total` / `shown` / `truncated` | 该设备在台账里的总数 / 本次带了几条 / 是否被截断 |
|
||||
| `accounts[].name` | 账号名称（台账的「账号名称」列） |
|
||||
| `accounts[].douyin_id` | **抖音号（纯号）**，如 `35377983067` |
|
||||
| `accounts[].sim_in_device` / `can_post_video` | 卡在机内 / 可发视频（布尔） |
|
||||
| `accounts[].phone` | **默认不推**（大字页是机器旁的公开屏幕，手机号不宜默认上屏）。需要时平台请求体传 `{"include_phone":true}` |
|
||||
|
||||
**设备端要做的**（当前版本忽略该 extra，行为与旧版逐字一致）：
|
||||
|
||||
1. 读 `accounts_b64` → base64 解码 → `JSONObject`
|
||||
2. 在身份页上按 `name` / `douyin_id` 渲染一个列表（建议 1~3 行简短列表，最多显示 `shown` 条）
|
||||
3. `truncated=true` 时提示"还有更多，见平台账号页"
|
||||
|
||||
**约定与边界**（平台侧实现见 `web/device_agent_api.py` 的 `_encode_accounts`）：
|
||||
|
||||
- **没有这个 extra = 这台设备在台账里没有账号**（不是"平台忘了给"）——设备端保持原样显示即可，
|
||||
不要显示空列表
|
||||
- 超预算时平台**按整条丢**（`shown` 变小 + `truncated=true`），**绝不按字节切**（切了就是坏 JSON）；
|
||||
台账过大时可能**整个 extra 不发**（平台响应体里 `warn` 会说明原因）
|
||||
- 台账读取失败时同样**不发**这个 extra —— 台账故障不影响"显示身份"这个动作
|
||||
|
||||
### 5.3 扫码配置（设备端已实现）
|
||||
|
||||
平台「设备池」里点某台设备的「**二维码**」→ 生成一张二维码 → 手机上的 Agent 点
|
||||
@@ -239,6 +294,9 @@ adb -s <serial> shell am start -n <pkg>/.ConfigActivity \
|
||||
|
||||
## 6. 版本与兼容
|
||||
|
||||
- **§5.2.1 的 `accounts_b64` 是"加字段"= 小版本**：`agent_api_version` **仍是 1**，
|
||||
设备端忽略它时行为必须与旧版逐字一致（只是大字页少一块内容）。也**不**走
|
||||
`bootstrap`：身份页由平台用 adb 推，加进 bootstrap 没人用还会让契约多一处要同步。
|
||||
- `agent_api_version`（当前 **1**）在每次 `bootstrap` 响应里返回
|
||||
- **设备端**：启动时对比自己实现的版本，不一致要在日志里明确记下来（不要静默）
|
||||
- **平台端**：
|
||||
|
||||
+1
-1
@@ -108,7 +108,7 @@ MCP_ALLOW_WRITE=1 MCP_PLATFORM_USER=admin MCP_PLATFORM_PASS=<平台密码> \
|
||||
| 工具 | 参数 | 说明 |
|
||||
|------|------|------|
|
||||
| `de_type_text` | `serial`, `text` | 向当前输入框输入（支持中文，直设 EditText，不依赖剪贴板） |
|
||||
| `de_set_clipboard` | `serial`, `text` | 写入设备剪贴板（ClipInject 通道 + 读回验证） |
|
||||
| `de_set_clipboard` | `serial`, `text` | 写入设备剪贴板（设备端 Agent 通道 + 读回验证） |
|
||||
|
||||
### 4.5 App 管理（**写操作**，走 adb 直连不建 u2 会话）
|
||||
|
||||
|
||||
+8
-8
@@ -58,8 +58,8 @@
|
||||
| 点击 | `POST /api/screen/tap {serial,x,y}` | 封装 tool `tap` |
|
||||
| 滑动 | `POST /api/screen/swipe` | 封装 `swipe` |
|
||||
| 按键 | `POST /api/screen/key` | 封装 `press_key` |
|
||||
| 输入文字 | ClipInject 通道（core.clipboard_helper）+ u2 input | 封装 `type_text` |
|
||||
| 剪贴板 | `POST /api/tools/clipboard/set`（ClipInject 通道） | 封装 `set_clipboard` |
|
||||
| 输入文字 | 设备端 Agent 通道（core.clipboard_helper）+ u2 input | 封装 `type_text` |
|
||||
| 剪贴板 | `POST /api/tools/clipboard/set`（设备端 Agent 通道） | 封装 `set_clipboard` |
|
||||
| 元素树 | `GET /api/uiauto/...`（uiautodev） | 封装 `get_ui_tree` |
|
||||
| OCR | core.ocr（RapidOCR） | 封装 `ocr_screen` |
|
||||
| 打开 App | u2 `app_start`（经任务层/直连） | 封装 `open_app`（走 core device 直连） |
|
||||
@@ -150,11 +150,11 @@
|
||||
- key ∈ back/home/recent/menu/power/enter/delete…
|
||||
|
||||
#### `de_type_text(serial, text: str, clear_first: bool=True)`
|
||||
- 实现：优先 ClipInject 通道（`core.clipboard_helper.inject_clipboard` 语义：写入剪贴板 + paste 到焦点输入框），失败回退 u2 input
|
||||
- 中文/emoji 全支持（ClipInject 实测通过）
|
||||
- 实现：优先设备端 Agent 通道（`core/clipboard_helper.inject_clipboard` 语义：写入剪贴板 + paste 到焦点输入框），失败回退 u2 input
|
||||
- 中文/emoji 全支持（Agent 通道实测通过）
|
||||
|
||||
#### `de_set_clipboard(serial, text: str)`
|
||||
- 写入设备剪贴板（ClipInject am start 通道），读回验证
|
||||
- 写入设备剪贴板（设备端 Agent 的 am start 通道），读回验证
|
||||
|
||||
#### `de_open_app(serial, package: str)`
|
||||
- 打开指定 App（u2 app_start）；`package` 需在已知清单或完全限定名
|
||||
@@ -247,7 +247,7 @@
|
||||
3. **横竖屏/分辨率异构**：设备多样 → 坐标换算依赖截图 1:1；`de_find_and_tap`（语义层）不受分辨率影响
|
||||
4. **图像 content block 兼容性**：Claude 系原生支持；其他多模态客户端需验证（M0 用 Claude Code 验证）
|
||||
5. **是否接任务系统**：二期决策——`de_run_task` 语义与"单设备操作"不同（任务面向多设备调度），倾向二期用独立命名空间
|
||||
6. **clipboard/input 通道差异**：个别 MIUI 需授权 ClipInject——M0 阶段在受控设备集验证，必要时 fallback 链已在 core 层
|
||||
6. **clipboard/input 通道差异**：个别 MIUI 需授权写入剪贴板的透明 Activity——M0 阶段在受控设备集验证，必要时 fallback 链已在 core 层（设备端 Agent → 旧版 ClipInject）
|
||||
|
||||
## 12. 附录：平台 API 映射（MCP → 平台）
|
||||
|
||||
@@ -262,8 +262,8 @@
|
||||
| de_press_key | POST /api/screen/key |
|
||||
| de_tap_text | POST /api/screen/tap_text（UI 树子串匹配 → OCR 兜底） |
|
||||
| de_tap_element | u2 元素直连（uiautomator2 `d(by=value).click()`，无平台端点） |
|
||||
| de_type_text | u2 `EditText.set_text`（direct_ops.type_text，不走 ClipInject） |
|
||||
| de_set_clipboard | core.clipboard_helper ClipInject 通道（inject_clipboard，读回验证） |
|
||||
| de_type_text | u2 `EditText.set_text`（direct_ops.type_text，不走剪贴板通道） |
|
||||
| de_set_clipboard | core.clipboard_helper 设备端 Agent 通道（inject_clipboard，读回验证） |
|
||||
| de_read_clipboard | u2 `d.clipboard` |
|
||||
| de_open_app | adb monkey 直启（direct_ops.open_app） |
|
||||
| de_stop_app | adb `am force-stop`（direct_ops.stop_app） |
|
||||
|
||||
+28
-2
@@ -128,11 +128,11 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
| 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` 时再触发一次粘贴 |
|
||||
| 14 | `clipboard` | 剪贴板注入 | `text` | `paste`(True) | — | 走**设备端 Agent** 通道（透明 Activity，绕开 Android 10+ 后台写剪贴板限制）；老设备上只有独立 ClipInject 时自动兜底（见 `core/clipboard_helper.py`）；`paste=true` 时再触发一次粘贴 |
|
||||
| 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)、`cmp_op`("")、`cmp_value`("")、`ident_type`/`ident_value`（去重身份） | `then` / `else` | 见 §4.2；条件类型除元素/OCR 外还支持 **屏幕状态**、**前台App**、**去重**（见 §4.6）；填 `cmp_op` 则改成**比元素的文本**（等于/不等于/包含/不包含，多值任一命中） |
|
||||
| 18 | `if_el` | 条件判断 | `selector_type`、`selector_value`、`timeout`(3) | `ocr_click`(False)、`cmp_op`("")、`cmp_value`("")、`cmp_source`("")、`cmp_group`("")、`ident_type`/`ident_value`（去重身份） | `then` / `else` | 见 §4.2；条件类型除元素/OCR 外还支持 **屏幕状态**、**前台App**、**去重**（见 §4.6）；填 `cmp_op` 则改成**比元素的文本**（等于/不等于/包含/不包含，多值任一命中），候选值还可以从**「账号」台账**取（`cmp_source` = device/all/group） |
|
||||
| 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 |
|
||||
@@ -283,6 +283,32 @@ from .generic import task # 触发 @register_task（当前唯一任务类型）
|
||||
走了 `else`，不是选择器失效，不该攒出「连续未命中」告警。
|
||||
- 读元素文本是**只读**操作（`get_text`，2 秒超时），不会点击或改动任何状态。
|
||||
|
||||
#### 候选值从「账号」台账取号（`cmp_source` / `cmp_group`，可选）
|
||||
|
||||
几十个号时手写 `cmp_value` 很累、而且换号要回来改。`cmp_source` 让候选值直接来自
|
||||
「账号」页的台账：
|
||||
|
||||
| `cmp_source` | 取哪些号 |
|
||||
|---|---|
|
||||
| `""` / `manual`（默认） | 只用手填的 `cmp_value` —— **行为与以前完全一致** |
|
||||
| `device` | **本机台账**：这台设备在台账里登记的抖音号（靠 `serial`→设备名 匹配） |
|
||||
| `all` | 全部台账 |
|
||||
| `group` | 某个**设备分组**内所有设备的号（分组名填在 `cmp_group`） |
|
||||
|
||||
- **与手填值是合并（OR）**，不是二选一：台账里的号 + 你补的一个号，任一命中即可。
|
||||
更重要的是 —— **台账取不到号时手填值仍然生效**，台账没维护好不会把任务直接打哑。
|
||||
- 取到 0 个号时**日志会写明原因**（如"设备名对不上"）：
|
||||
候选为空会让这一步**永远走 `else` 分支**，而任务本身照样"跑完了"。
|
||||
编辑器保存时也会为此报警告，请到「账号」页核对设备号。
|
||||
- 比对运算符仍要选：台账里是**纯号**（`35377983067`），元素原文是
|
||||
`抖音号：35377983067` → 用 **`包含`**。（要整段一模一样才用 `等于`。）
|
||||
|
||||
> ⚠ **台账的纯号只能当"比对用的候选值"，绝不能拿去填「去重」的身份元素**（`ident_value`）：
|
||||
> 去重身份存的是**元素原文**、逐字算 key（`core/dedup.py` 的 `build_key`），
|
||||
> 格式不一致（`35377983067` vs `抖音号：35377983067`）会让**检查与记账算出两个不同的
|
||||
> key → 去重静默失效**（重复评论，而且日志看不出问题）。
|
||||
> 去重身份继续用「抓取元素」抓到的那个账号元素即可。
|
||||
|
||||
### 4.3 公共参数
|
||||
|
||||
| 参数 | 说明 |
|
||||
|
||||
@@ -116,6 +116,7 @@ function showTab(name){
|
||||
showSubTab('agent', _activeSubs.agent||'chat'); // 聊天 / AI 建任务
|
||||
if(typeof initAgentChat==='function') initAgentChat();
|
||||
}
|
||||
if(name==='account'&&typeof loadLedger==='function')loadLedger();
|
||||
if(name==='users')loadUsers();
|
||||
if(name==='system'){showSubTab('system',_activeSubs.system||'backup');}
|
||||
}
|
||||
|
||||
+39
-4
@@ -19,7 +19,7 @@ var STEP_LIB=[
|
||||
{type:'wait_el',label:'等待元素',icon:'⏳',cat:'flow',params:{selector_type:'xpath',selector_value:'',timeout:10}},
|
||||
{type:'loop',label:'循环块',icon:'↻',cat:'flow',params:{loop_mode:'rounds',max_iterations:10,loop_duration:600,children:[]}},
|
||||
{type:'group',label:'动作组',icon:'📦',cat:'flow',params:{children:[]}},
|
||||
{type:'if_el',label:'条件判断',icon:'❓',cat:'flow',params:{selector_type:'xpath',selector_value:'',timeout:3,ocr_click:false,cmp_op:'',cmp_value:'',ident_type:'text',ident_value:'',then:[],else:[]}},
|
||||
{type:'if_el',label:'条件判断',icon:'❓',cat:'flow',params:{selector_type:'xpath',selector_value:'',timeout:3,ocr_click:false,cmp_op:'',cmp_value:'',cmp_source:'',cmp_group:'',ident_type:'text',ident_value:'',then:[],else:[]}},
|
||||
{type:'mark_done',label:'记为已做',icon:'✅',cat:'flow',params:{selector_type:'text',selector_value:''}},
|
||||
{type:'notify',label:'发通知',icon:'🔔',cat:'flow',params:{title:'',message:'',level:'info'}},
|
||||
{type:'stop_self',label:'停止本设备',icon:'⛔',cat:'flow',params:{reason:''}},
|
||||
@@ -464,16 +464,36 @@ var _stepEditor={
|
||||
var isDedup=(p.selector_type==='dedup');
|
||||
var dyn=(p.selector_type==='screen'||p.selector_type==='foreground'||isDedup);
|
||||
// 文本比对：屏幕状态没有文本可比（亮/熄）、去重也不比文本，只有元素/OCR/前台 App 才给这块
|
||||
// 候选值来源：默认"手填"（行为与以前完全一致）；也可以直接吃「账号」页的台账
|
||||
var cmpSrc=p.cmp_source||'';
|
||||
var fromLedger=(cmpSrc==='device'||cmpSrc==='all'||cmpSrc==='group');
|
||||
var cmpRow=dyn?'':'<div class="form-row"><div class="form-group"><label>文本比对</label>'+
|
||||
'<select class="form-control" data-key="cmp_op">'+
|
||||
[['','不比对（只看元素在不在）'],['等于','等于'],['不等于','不等于'],['包含','包含'],['不包含','不包含']]
|
||||
.map(function(o){return '<option value="'+o[0]+'"'+((p.cmp_op||'')===o[0]?' selected':'')+'>'+o[1]+'</option>';}).join('')+
|
||||
'</select></div>'+
|
||||
'<div class="form-group" style="grid-column:span 2"><label>比对的值（可多行，任一命中即可）</label>'+
|
||||
'<div class="form-group"><label>候选值来源</label>'+
|
||||
'<select class="form-control" data-key="cmp_source" onchange="_stepEditor._cmpSourceChanged(this)">'+
|
||||
[['','手填（默认）'],['device','本机台账'],['all','全部台账'],['group','按设备分组']]
|
||||
.map(function(o){return '<option value="'+o[0]+'"'+((p.cmp_source||'')===o[0]?' selected':'')+'>'+o[1]+'</option>';}).join('')+
|
||||
'</select><div class="help">台账在「账号」页维护</div></div>'+
|
||||
(cmpSrc==='group'?
|
||||
'<div class="form-group"><label>设备分组名</label>'+
|
||||
'<input class="form-control" data-key="cmp_group" value="'+esc(p.cmp_group||'')+'" '+
|
||||
'placeholder="分组名（工具→设备分组）"></div>':'')+
|
||||
// 选台账时**只隐藏、不删**这个输入框：_syncParams 是按 DOM 存在与否收集的，
|
||||
// 删了就等于把用户手填的值悄悄抹掉（同类坑见本文件 927 行附近的注释）
|
||||
'<div class="form-group" style="grid-column:span 2'+(fromLedger?';display:none':'')+'">'+
|
||||
'<label>比对的值（可多行，任一命中即可）</label>'+
|
||||
'<textarea class="form-control" data-key="cmp_value" rows="2" style="font-family:var(--mono)" '+
|
||||
'placeholder="如 35377983067 35377983068">'+esc(p.cmp_value||'')+'</textarea>'+
|
||||
'<div class="help">一行一个（也认 <code>|</code> 分隔）：<b>任意一个命中就算命中</b>——多个号的场景把号都列上。'+
|
||||
'<b>逗号不当分隔符</b>，因为要比对的文本本身常带逗号</div></div></div>';
|
||||
'<b>逗号不当分隔符</b>，因为要比对的文本本身常带逗号'
|
||||
+(fromLedger?'<br><b>候选值来自台账</b>：这台设备在台账里登记的抖音号会作为候选，'
|
||||
+'手填的值<b>追加</b>在后面（台账取不到号时只用手填值，不会把任务打哑）。'
|
||||
+'<br>⚠ 台账只提供<b>比对用的号</b>；<b>不要</b>把台账号填到「去重」的身份元素里'
|
||||
+'（身份是元素原文、逐字比，格式不同会让去重静默失效）。':'')
|
||||
+'</div></div></div>';
|
||||
// 「去重」条件：身份元素用 ident_type/ident_value（主选择器那行只剩类型下拉）
|
||||
var identRow=isDedup?_selRowHtml(p,
|
||||
'<div class="help"><b>身份元素</b>：填"账号"那个元素（点「抓取元素」选，如抖音号那个 TextView）。'
|
||||
@@ -814,6 +834,13 @@ var _stepEditor={
|
||||
g.style.display=g.dataset.lmode===mode?'block':'none';
|
||||
});
|
||||
},
|
||||
// 条件判断：候选值来源切到台账时，把"比对的值"藏起来（按分组还要显示分组名输入框）
|
||||
_cmpSourceChanged:function(sel){
|
||||
// 同 _condTypeChanged：先把 DOM 的值同步回 _steps，否则重渲染会吞掉刚改的东西
|
||||
this._syncFromDom();
|
||||
var self=this;
|
||||
setTimeout(function(){self._renderCanvas();},0);
|
||||
},
|
||||
// 条件判断：选择器类型切到 OCR 时显示"命中后点击"开关
|
||||
_condTypeChanged:function(sel){
|
||||
// 条件类型一变，"值"控件也要跟着换（元素值输入框 / 屏幕亮熄下拉 / 包名输入），
|
||||
@@ -930,10 +957,18 @@ var _stepEditor={
|
||||
if(s.params.selector_type!=='dedup'&&!s.params.selector_value){
|
||||
warnings.push(name+' "'+label+'": 条件判断的选择器为空，会直接走"未找到"分支。');
|
||||
}
|
||||
if(cmpUsed&&s.params.cmp_op&&!String(s.params.cmp_value||'').trim()){
|
||||
var cmpSrcV=(s.params.cmp_source||'');
|
||||
var fromLedger=(cmpSrcV==='device'||cmpSrcV==='all'||cmpSrcV==='group');
|
||||
if(cmpUsed&&s.params.cmp_op&&!String(s.params.cmp_value||'').trim()&&!fromLedger){
|
||||
// 候选值来自台账时允许手填留空（台账取号就够）→ 不报这条
|
||||
warnings.push(name+' "'+label+'": 选了"文本比对('+s.params.cmp_op+')"但没填比对的值，'
|
||||
+'执行时永远不命中（相当于每次都走"未找到时"分支）。');
|
||||
}
|
||||
if(cmpUsed&&fromLedger&&s.params.cmp_op){
|
||||
warnings.push(name+' "'+label+'": 候选值来自台账 —— 台账里没有这台设备'
|
||||
+'（或设备池里的设备名与台账「设备号」对不上）时会取不到号，'
|
||||
+'这一步将永远走"未找到"分支。请到「账号」页核对设备号。');
|
||||
}
|
||||
if(s.params.selector_type==='dedup'){
|
||||
hasDedupCheck=true;
|
||||
// 空值也收进来：一边填了、另一边没填 = 两处身份不一致（去重会对不上），
|
||||
|
||||
@@ -0,0 +1,300 @@
|
||||
// 账号台账（「账号」顶级 Tab）
|
||||
// 数据在 device_account 表，服务层 core/ledger.py，接口 /api/ledger*（web/devices_api.py）。
|
||||
//
|
||||
// 这一页的三重价值：
|
||||
// ① 一台设备登好几个号、十几台设备几十个号 —— 换 IP / 加号时不用再翻电子表格；
|
||||
// ② 任务的「条件判断」可以直接从这里取号（cmp_source），不用手写一串抖音号；
|
||||
// ③ 手机端 Agent 的「身份大字页」会显示本机账号（平台推 accounts_b64）。
|
||||
//
|
||||
// ⚠ 台账里的抖音号是**纯号**，只当"比对用的候选值"；**别**拿它去填「去重」的身份元素
|
||||
// ——身份是元素原文、逐字算 key，格式不同会让去重静默失效（core/ledger.py 顶部有警告）。
|
||||
var _ledgerAll = []; // 全部账号（一次拉回，搜索/筛选在前端做：几十条量级）
|
||||
var _ledgerStats = {};
|
||||
var _ledgerDeviceNames = [];
|
||||
var _ledgerCounts = {}; // {设备号: 号数}（设备池那一列用）
|
||||
var _ledgerDevices = {}; // {设备号: {count, accounts[]}}（点开看明细用）
|
||||
|
||||
function loadLedger() {
|
||||
var sel = document.getElementById('ledger-device');
|
||||
var keep = sel ? sel.value : '';
|
||||
apiGet('/api/ledger?limit=2000').then(function (r) {
|
||||
var tb = document.getElementById('tb-ledger');
|
||||
if (!r || !r.ok) {
|
||||
if (tb) tb.innerHTML = '<tr><td colspan="10" class="empty">读取失败：' + esc((r && r.error) || '') + '</td></tr>';
|
||||
return;
|
||||
}
|
||||
_ledgerAll = r.accounts || [];
|
||||
_ledgerStats = r.stats || {};
|
||||
_ledgerDeviceNames = r.device_names || [];
|
||||
_renderLedgerDeviceFilter(keep);
|
||||
_renderLedgerStats();
|
||||
renderLedger();
|
||||
});
|
||||
}
|
||||
|
||||
function _renderLedgerDeviceFilter(keep) {
|
||||
var sel = document.getElementById('ledger-device');
|
||||
if (!sel) return;
|
||||
var html = '<option value="">全部设备</option>';
|
||||
_ledgerDeviceNames.forEach(function (n) {
|
||||
html += '<option value="' + esc(n) + '">' + esc(n) + '</option>';
|
||||
});
|
||||
sel.innerHTML = html;
|
||||
sel.value = keep || '';
|
||||
}
|
||||
|
||||
function _renderLedgerStats() {
|
||||
var el = document.getElementById('ledger-stats');
|
||||
if (!el) return;
|
||||
var s = _ledgerStats || {};
|
||||
el.textContent = '共 ' + (s.total || 0) + ' 个号 · ' + (s.devices || 0) + ' 台设备 · '
|
||||
+ (s.can_post_video || 0) + ' 个可发视频';
|
||||
}
|
||||
|
||||
function ledgerDeviceChanged() { renderLedger(); }
|
||||
|
||||
function renderLedger() {
|
||||
var sel = document.getElementById('ledger-device');
|
||||
var dev = sel ? sel.value : '';
|
||||
var rows = dev ? _ledgerAll.filter(function (a) { return a.device_name === dev; }) : _ledgerAll;
|
||||
setListPager('ledger', {
|
||||
data: function () { return rows; },
|
||||
filter: function (a, kw) {
|
||||
return ((a.douyin_id || '') + (a.phone || '') + (a.nickname || '')
|
||||
+ (a.device_name || '') + (a.note || '')).toLowerCase().indexOf(kw) >= 0;
|
||||
},
|
||||
sortValue: function (a, k) { return a[k]; },
|
||||
render: renderLedgerRow,
|
||||
tbody: 'tb-ledger', pager: 'pager-ledger', pageSize: 20,
|
||||
empty: '<tr><td colspan="10" class="empty">还没有账号 —— 点「粘贴导入」把你那张表贴进来</td></tr>'
|
||||
});
|
||||
applyListPager('ledger');
|
||||
initListSearch('ledger', 'search-ledger');
|
||||
}
|
||||
|
||||
function _yn(v) {
|
||||
return v ? '<span class="label label-success">是</span>'
|
||||
: '<span class="label label-default">否</span>';
|
||||
}
|
||||
|
||||
function _clip(s, n) {
|
||||
var t = String(s || '');
|
||||
if (!t) return '';
|
||||
return '<span title="' + esc(t) + '">' + esc(t.length > n ? t.slice(0, n) + '…' : t) + '</span>';
|
||||
}
|
||||
|
||||
function renderLedgerRow(a) {
|
||||
return '<tr>' +
|
||||
'<td><strong>' + esc(a.device_name || '-') + '</strong></td>' +
|
||||
'<td>' + esc(a.nickname || '-') + '</td>' +
|
||||
'<td style="font-family:var(--mono)">' + esc(a.douyin_id || '-') + '</td>' +
|
||||
'<td style="font-family:var(--mono)">' + esc(a.phone || '-') + '</td>' +
|
||||
'<td>' + esc(a.registered_at || '-') + '</td>' +
|
||||
'<td>' + _yn(a.sim_in_device) + '</td>' +
|
||||
'<td>' + _yn(a.can_post_video) + '</td>' +
|
||||
'<td>' + _clip(a.bio, 12) + '</td>' +
|
||||
'<td>' + _clip(a.note, 12) + '</td>' +
|
||||
'<td>' +
|
||||
'<button class="btn btn-xs" onclick="openLedgerModal(\'' + a.id + '\')" data-perm="devices">编辑</button> ' +
|
||||
'<button class="btn btn-xs btn-danger" data-id="' + a.id + '" ' +
|
||||
'onclick="deleteLedger(this.dataset.id)" data-perm="devices">删除</button>' +
|
||||
'</td></tr>';
|
||||
}
|
||||
|
||||
function _ledgerById(id) {
|
||||
for (var i = 0; i < _ledgerAll.length; i++) {
|
||||
if (_ledgerAll[i].id === id) return _ledgerAll[i];
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// ================== 单条新增 / 编辑 ==================
|
||||
function _ledgerField(label, key, val, ph) {
|
||||
return '<div class="form-group"><label>' + label + '</label>' +
|
||||
'<input class="form-control" data-lf="' + key + '" value="' + esc(val || '') + '" ' +
|
||||
'placeholder="' + (ph || '') + '"></div>';
|
||||
}
|
||||
|
||||
function openLedgerModal(id) {
|
||||
var a = id ? _ledgerById(id) : null;
|
||||
document.getElementById('modal-title').textContent = a ? ('编辑账号：' + (a.nickname || a.douyin_id)) : '新增账号';
|
||||
var h = '<div class="form-row">' +
|
||||
_ledgerField('设备号', 'device_name', a && a.device_name, '如 A01（要和设备池里的设备名一致）') +
|
||||
_ledgerField('账号名称', 'nickname', a && a.nickname, '如 AA建材王总') + '</div>' +
|
||||
'<div class="form-row">' +
|
||||
_ledgerField('抖音号', 'douyin_id', a && a.douyin_id, '纯号，如 35377983067（不带「抖音号：」前缀）') +
|
||||
_ledgerField('手机号', 'phone', a && a.phone, '') + '</div>' +
|
||||
'<div class="form-row">' +
|
||||
_ledgerField('注册时间', 'registered_at', a && a.registered_at, '如 2026/9/24（原样存）') +
|
||||
'<div class="form-group"><label>卡在机内 / 可发视频</label>' +
|
||||
'<div style="display:flex;gap:16px;align-items:center;padding-top:4px">' +
|
||||
'<label style="display:inline-flex;gap:4px;align-items:center"><input type="checkbox" data-lf="sim_in_device" '
|
||||
+ (a && a.sim_in_device ? 'checked' : '') + '> 卡在机内</label>' +
|
||||
'<label style="display:inline-flex;gap:4px;align-items:center"><input type="checkbox" data-lf="can_post_video" '
|
||||
+ (a && a.can_post_video ? 'checked' : '') + '> 可发视频</label>' +
|
||||
'</div></div></div>' +
|
||||
'<div class="form-group"><label>简介</label><input class="form-control" data-lf="bio" value="'
|
||||
+ esc(a && a.bio || '') + '"></div>' +
|
||||
'<div class="form-group"><label>备注</label><input class="form-control" data-lf="note" value="'
|
||||
+ esc(a && a.note || '') + '"></div>' +
|
||||
'<div class="help">抖音号在整个台账里必须唯一（一个号只能有一条记录）。' +
|
||||
'<b>设备号</b>要和「工具 → 设备池」里的设备名一致 —— 任务的「本机台账」取号、' +
|
||||
'设备端身份页显示本机账号都靠它匹配。</div>';
|
||||
document.getElementById('modal-body').innerHTML = h;
|
||||
document.getElementById('modal-footer').innerHTML =
|
||||
'<button class="btn" onclick="closeModal()">取消</button>' +
|
||||
'<button class="btn btn-primary" onclick="saveLedger(\'' + (a ? a.id : '') + '\')">保存</button>';
|
||||
showModal();
|
||||
}
|
||||
|
||||
function _ledgerFormValues() {
|
||||
var out = {};
|
||||
document.querySelectorAll('#modal-body [data-lf]').forEach(function (el) {
|
||||
var k = el.dataset.lf;
|
||||
out[k] = (el.type === 'checkbox') ? !!el.checked : el.value;
|
||||
});
|
||||
return out;
|
||||
}
|
||||
|
||||
function saveLedger(id) {
|
||||
var body = _ledgerFormValues();
|
||||
var p = id ? apiPut('/api/ledger/' + id, body) : apiPost('/api/ledger', body);
|
||||
p.then(function (r) {
|
||||
if (r && r.ok) { closeModal(); showToast(r.msg || '已保存', 'success'); loadLedger(); }
|
||||
else showToast('保存失败: ' + ((r && r.error) || ''), 'error');
|
||||
});
|
||||
}
|
||||
|
||||
function deleteLedger(id) {
|
||||
var a = _ledgerById(id);
|
||||
var who = a ? ((a.device_name || '') + ' / ' + (a.nickname || '') + ' / ' + (a.douyin_id || '')) : id;
|
||||
if (!confirm('删掉这条账号？\n\n' + who + '\n\n删掉之后：任务从台账取号就取不到它了。')) return;
|
||||
apiDelete('/api/ledger/' + id).then(function (r) {
|
||||
if (r && r.ok) { showToast(r.msg || '已删除', 'success'); loadLedger(); loadLedgerCounts(); }
|
||||
else showToast('删除失败: ' + ((r && r.error) || ''), 'error');
|
||||
});
|
||||
}
|
||||
|
||||
// ================== 粘贴导入 ==================
|
||||
function openLedgerImport() {
|
||||
document.getElementById('modal-title').textContent = '粘贴导入账号台账';
|
||||
document.getElementById('modal-box').classList.add('wide-modal');
|
||||
document.getElementById('modal-body').innerHTML =
|
||||
'<div class="help" style="margin-bottom:8px">' +
|
||||
'把 Excel 里的表格<b>连表头一起</b>复制，粘到下面。首行是列名，顺序随意、缺列留空。<br>' +
|
||||
'认得的列名：<code>设备号 / 手机号 / 账号名称 / 抖音号 / 注册时间 / 卡在机内 / 可发视频 / 简介 / 备注</code>' +
|
||||
'（认不出的列会被忽略）。<b>没有表头</b>时按上面这个顺序解析。<br>' +
|
||||
'「卡在机内 / 可发视频」认 <code>是/有/1</code> 与 <code>否/空</code>。' +
|
||||
'</div>' +
|
||||
'<div class="form-row" style="align-items:end">' +
|
||||
'<div class="form-group"><label>分隔符</label>' +
|
||||
'<select class="form-control" id="ledger-import-delim">' +
|
||||
'<option value="tab">Tab（Excel 直接粘贴）</option>' +
|
||||
'<option value="|">竖线 |</option><option value=",">逗号 ,</option></select></div>' +
|
||||
'<div class="form-group"><label>遇到已存在的抖音号</label>' +
|
||||
'<select class="form-control" id="ledger-import-mode">' +
|
||||
'<option value="skip">跳过（不动已有记录）</option>' +
|
||||
'<option value="overwrite">覆盖（整行替换，空单元格会覆盖掉原值）</option></select></div>' +
|
||||
'</div>' +
|
||||
'<div class="form-group"><textarea id="ledger-import-text" class="form-control" rows="10" ' +
|
||||
'style="font-family:var(--mono);font-size:12px" placeholder="设备号	手机号	账号名称	抖音号	注册时间	卡在机内	可发视频	简介	备注 A01	13800000000	示例账号	35000000001	2026/9/24	否	是		"></textarea></div>' +
|
||||
'<div id="ledger-import-result"></div>';
|
||||
document.getElementById('modal-footer').innerHTML =
|
||||
'<button class="btn" onclick="closeModal()">取消</button>' +
|
||||
'<button class="btn" onclick="ledgerImport(true)">先预览</button>' +
|
||||
'<button class="btn btn-primary" onclick="ledgerImport(false)">直接导入</button>';
|
||||
showModal();
|
||||
}
|
||||
|
||||
function ledgerImport(dryRun) {
|
||||
var text = (document.getElementById('ledger-import-text') || {}).value || '';
|
||||
if (!text.trim()) { showToast('先粘贴表格内容', 'error'); return; }
|
||||
var delim = (document.getElementById('ledger-import-delim') || {}).value || 'tab';
|
||||
var mode = (document.getElementById('ledger-import-mode') || {}).value || 'skip';
|
||||
var box = document.getElementById('ledger-import-result');
|
||||
if (box) box.innerHTML = '<div class="text-muted">' + (dryRun ? '解析中…' : '导入中…') + '</div>';
|
||||
apiPost('/api/ledger/import', { text: text, delimiter: delim, mode: mode, dry_run: !!dryRun })
|
||||
.then(function (r) {
|
||||
if (!r || !r.ok) {
|
||||
if (box) box.innerHTML = '<div class="text-danger">失败：' + esc((r && r.error) || '') + '</div>';
|
||||
return;
|
||||
}
|
||||
renderImportResult(r);
|
||||
if (!dryRun) { loadLedger(); loadLedgerCounts(); }
|
||||
});
|
||||
}
|
||||
|
||||
var _IMP_ACTION = {
|
||||
add: ['label-success', '新增'], update: ['label-warning', '覆盖'],
|
||||
skip: ['label-default', '跳过'], fail: ['label-danger', '失败']
|
||||
};
|
||||
|
||||
function renderImportResult(r) {
|
||||
var box = document.getElementById('ledger-import-result');
|
||||
if (!box) return;
|
||||
var c = r.counts || {};
|
||||
var head = '<div style="margin:10px 0 6px"><b>' + (r.dry_run ? '预览结果（还没有写入）' : '导入结果')
|
||||
+ '</b> 共 ' + (c.total || 0) + ' 行：新增 ' + (c.added || 0) + ' · 覆盖 ' + (c.updated || 0)
|
||||
+ ' · 跳过 ' + (c.skipped || 0) + ' · 失败 ' + (c.failed || 0) + '</div>';
|
||||
var rows = (r.rows || []).map(function (x) {
|
||||
var a = _IMP_ACTION[x.action] || ['label-default', x.action];
|
||||
var msg = x.error || (x.warns && x.warns.length ? x.warns.join('；') : '');
|
||||
return '<tr><td>' + esc(x.line) + '</td>' +
|
||||
'<td><span class="label ' + a[0] + '">' + a[1] + '</span></td>' +
|
||||
'<td>' + esc(x.device_name || '') + '</td>' +
|
||||
'<td style="font-family:var(--mono)">' + esc(x.douyin_id || '') + '</td>' +
|
||||
'<td>' + esc(x.nickname || '') + '</td>' +
|
||||
'<td style="color:#f59e0b">' + esc(msg) + '</td></tr>';
|
||||
}).join('');
|
||||
var errs = (r.errors || []).map(function (e) {
|
||||
return '<li>第 ' + esc(e.line) + ' 行：' + esc(e.reason) + '</li>';
|
||||
}).join('');
|
||||
box.innerHTML = head +
|
||||
_importErrorsNote(errs) +
|
||||
'<div style="max-height:320px;overflow:auto"><table class="table table-sm">' +
|
||||
'<thead><tr><th>行</th><th>动作</th><th>设备号</th><th>抖音号</th><th>账号名称</th><th>说明</th></tr></thead>' +
|
||||
'<tbody>' + (rows || '<tr><td colspan="6" class="empty">没有可导入的行</td></tr>') + '</tbody></table></div>' +
|
||||
(r.dry_run ? '<div class="help">确认没问题后点「直接导入」。</div>' : '');
|
||||
}
|
||||
|
||||
function _importErrorsNote(errs) {
|
||||
return errs ? ('<div class="help" style="color:#f59e0b">这些行被跳过了（不会导入）：<ul>' + errs + '</ul></div>') : '';
|
||||
}
|
||||
|
||||
// ================== 设备维度：设备池那一列的"账号 N" ==================
|
||||
function loadLedgerCounts() {
|
||||
return apiGet('/api/ledger/by_device').then(function (r) {
|
||||
if (r && r.ok) { _ledgerCounts = r.counts || {}; _ledgerDevices = r.devices || {}; }
|
||||
return _ledgerCounts;
|
||||
}).catch(function () { return _ledgerCounts; });
|
||||
}
|
||||
|
||||
function ledgerCell(serial, name) {
|
||||
var n = _ledgerCounts[name] || 0;
|
||||
if (!n) return '<span class="label label-default">未登记</span>';
|
||||
return '<button class="btn btn-xs" onclick="showDeviceAccounts(\'' + esc(name) + '\')">' + n + ' 个号</button>';
|
||||
}
|
||||
|
||||
function showDeviceAccounts(name) {
|
||||
var g = _ledgerDevices[name];
|
||||
if (!g) {
|
||||
// 没缓存过就现拉一次（例如直接打开设备池）
|
||||
loadLedgerCounts().then(function () { showDeviceAccounts(name); });
|
||||
return;
|
||||
}
|
||||
document.getElementById('modal-title').textContent = name + ' 上的账号（' + (g.count || 0) + ' 个）';
|
||||
var rows = (g.accounts || []).map(function (a) {
|
||||
return '<tr><td>' + esc(a.nickname || '-') + '</td>' +
|
||||
'<td style="font-family:var(--mono)">' + esc(a.douyin_id || '-') + '</td>' +
|
||||
'<td style="font-family:var(--mono)">' + esc(a.phone || '-') + '</td>' +
|
||||
'<td>' + _yn(a.sim_in_device) + '</td><td>' + _yn(a.can_post_video) + '</td>' +
|
||||
'<td>' + esc(a.registered_at || '-') + '</td><td>' + _clip(a.note, 16) + '</td></tr>';
|
||||
}).join('');
|
||||
document.getElementById('modal-body').innerHTML =
|
||||
'<div style="max-height:60vh;overflow:auto"><table class="table table-sm">' +
|
||||
'<thead><tr><th>账号名称</th><th>抖音号</th><th>手机号</th><th>卡在机内</th><th>可发视频</th><th>注册时间</th><th>备注</th></tr></thead>' +
|
||||
'<tbody>' + (rows || '<tr><td colspan="7" class="empty">这台设备还没有登记账号</td></tr>') + '</tbody></table></div>' +
|
||||
'<div class="help">在「账号」页可以增删改；设备端 Agent 的「身份大字页」显示的就是这些。</div>';
|
||||
document.getElementById('modal-footer').innerHTML = '<button class="btn" onclick="closeModal()">关闭</button>';
|
||||
showModal();
|
||||
}
|
||||
+11
-3
@@ -517,9 +517,13 @@ async function loadDevPool(){
|
||||
const tb=document.getElementById('tb-devpool');
|
||||
const status=document.getElementById('devpool-status');
|
||||
if(!tb)return;
|
||||
tb.innerHTML='<tr><td colspan="8" class="empty">加载中...</td></tr>';
|
||||
tb.innerHTML='<tr><td colspan="9" class="empty">加载中...</td></tr>';
|
||||
const r=await apiGet('/api/devices/pool');
|
||||
if(!r||!r.ok){tb.innerHTML='<tr><td colspan="8" class="empty">加载失败</td></tr>';return;}
|
||||
if(!r||!r.ok){tb.innerHTML='<tr><td colspan="9" class="empty">加载失败</td></tr>';return;}
|
||||
// 账号台账：这台设备登记了几个号（顺手把明细也缓存下来，点开就弹）
|
||||
if(typeof loadLedgerCounts==='function'){
|
||||
try{ await loadLedgerCounts(); }catch(e){}
|
||||
}
|
||||
let rows=r.devices||[];
|
||||
// 在线优先排序；「只看在线」勾选时过滤掉离线（IP 换了/长期离线的旧条目不再碍眼）
|
||||
const onlyOnline=document.getElementById('devpool-filter-online')
|
||||
@@ -552,6 +556,10 @@ async function loadDevPool(){
|
||||
'<td>'+online+'</td>'+
|
||||
'<td>'+st+'</td>'+
|
||||
'<td style="text-align:center">'+fp+'</td>'+
|
||||
// 账号台账（「账号」页维护）：0 个号显示"未登记"而不是空白 ——
|
||||
// 空白会让人以为功能坏了，而"未登记"是明确信息
|
||||
'<td style="white-space:nowrap">'+(typeof ledgerCell==='function'
|
||||
? ledgerCell(d.serial, d.name||'') : '—')+'</td>'+
|
||||
'<td style="color:var(--text-light)">'+esc(d.created_at||'')+'</td>'+
|
||||
'<td style="white-space:nowrap">'+
|
||||
'<button class="btn btn-xs" onclick="renamePoolDev(\''+esc(d.serial)+'\')">改名</button> '+
|
||||
@@ -561,7 +569,7 @@ async function loadDevPool(){
|
||||
'<button class="btn btn-xs" onclick="togglePoolDev(\''+esc(d.serial)+'\','+(!d.enabled)+')">'+(d.enabled?'停用':'启用')+'</button> '+
|
||||
'<button class="btn btn-xs btn-danger" onclick="removePoolDev(\''+esc(d.serial)+'\')">删除</button>'+
|
||||
'</td></tr>';
|
||||
}).join('')||'<tr><td colspan="8" class="empty">设备池为空，添加第一台设备开始</td></tr>';
|
||||
}).join('')||'<tr><td colspan="9" class="empty">设备池为空，添加第一台设备开始</td></tr>';
|
||||
}
|
||||
|
||||
async function addPoolDev(){
|
||||
|
||||
+47
-2
@@ -41,7 +41,7 @@ from core.device_worker import BaseWorker, _update_status
|
||||
from core.u2_helper import (ensure_app_running, wait_for_app_home, random_sleep,
|
||||
screen_is_on, current_package)
|
||||
from core.logger import get_logger
|
||||
from core import notifier, step_log, humanize, patrol, gesture, dedup
|
||||
from core import notifier, step_log, humanize, patrol, gesture, dedup, ledger
|
||||
|
||||
_log = get_logger("task.generic")
|
||||
|
||||
@@ -113,7 +113,7 @@ STEP_TYPES = [
|
||||
"params": {"children": []}},
|
||||
{"type": "if_el", "label": "条件判断", "icon": "❓",
|
||||
"params": {"selector_type": "xpath", "selector_value": "", "timeout": 3,
|
||||
"cmp_op": "", "cmp_value": "",
|
||||
"cmp_op": "", "cmp_value": "", "cmp_source": "", "cmp_group": "",
|
||||
"ident_type": "text", "ident_value": "",
|
||||
"then": [], "else": []}},
|
||||
{"type": "mark_done", "label": "记为已做", "icon": "✅",
|
||||
@@ -683,6 +683,12 @@ class GenericStepsWorker(BaseWorker):
|
||||
timeout = float(params.get("timeout", 3))
|
||||
cmp_op = str(params.get("cmp_op") or "").strip()
|
||||
cmp_val = str(params.get("cmp_value") or "")
|
||||
# 候选值可以来自「账号台账」（cmp_source）——这里只把 cmp_val 这个**字符串**
|
||||
# 换掉来路，下面 762-780 的比对、候选计数、日志文案全自动跟着对
|
||||
# （_cmp_hit 保持纯函数，不掺 DB）
|
||||
src_note = ""
|
||||
if cmp_op:
|
||||
cmp_val, src_note = self._resolve_cmp_value(params, cmp_val)
|
||||
# 去重条件不用 selector_value（身份元素在 ident_value 里），所以别按"缺选择器"拦
|
||||
if not sel_val and sel_type != "dedup":
|
||||
_log.warning(f"[{self.serial}] if_el 缺少选择器，跳过")
|
||||
@@ -783,6 +789,11 @@ class GenericStepsWorker(BaseWorker):
|
||||
# 界面上那块是隐藏的，旧值会留在 params 里，那种残留每轮都刷警告没意义
|
||||
_log.warning(f"[{self.serial}] {sel_type} 没有文本可比，已忽略文本比对设置")
|
||||
|
||||
# 候选值来源（台账/手填）也要进日志与步骤明细：取 0 个号会让这一步
|
||||
# **永远走 else 分支**，而任务照样"跑完了"——只有这里能看出原因
|
||||
if src_note:
|
||||
detail = f"{detail}；{src_note}" if detail else src_note
|
||||
|
||||
if dynamic:
|
||||
_log.info(f"[{self.serial}] 条件判断 {detail} → {'命中' if found else '未命中'}")
|
||||
else:
|
||||
@@ -797,6 +808,40 @@ class GenericStepsWorker(BaseWorker):
|
||||
self._exec_steps(d, branch, depth + 1)
|
||||
return found
|
||||
|
||||
def _resolve_cmp_value(self, params, manual_raw):
|
||||
"""「条件判断」的候选值 = 手填值 + 台账取号（合并，OR 语义）。
|
||||
|
||||
返回 (候选值文本, 给日志/步骤明细的来源说明)。
|
||||
|
||||
· **合并**而不是二选一：台账取空时手填值仍然生效（台账没维护好不会把任务
|
||||
直接打哑）；"台账里的号 + 临时补一个"也是自然需求 —— split_cmp_values
|
||||
与 `_cmp_hit` 本来就是多值 OR 语义。
|
||||
· 取 0 个号时**必须留痕**：候选为空 ⇒ 这一步永远走 else 分支，而任务本身
|
||||
"跑完了、显示成功"，不写日志就只能靠人猜。
|
||||
· ⚠ 这里产出的只是**比对用的文本**，绝不参与去重 identity：
|
||||
身份是元素原文逐字算 key，台账里是纯号，格式不同会让去重静默失效
|
||||
（见 core/ledger.py 顶部的警告）。
|
||||
"""
|
||||
source = str(params.get("cmp_source") or "").strip()
|
||||
manual = split_cmp_values(manual_raw)
|
||||
if source not in ("device", "all", "group"):
|
||||
return manual_raw, "" # 手填（默认）：行为与以前完全一致
|
||||
ids, note = ledger.douyin_ids(
|
||||
source, serial=self.serial,
|
||||
device_name=(self.ctx or {}).get("device_name", ""),
|
||||
group=str(params.get("cmp_group") or "").strip())
|
||||
merged = list(ids) + [v for v in manual if v not in ids]
|
||||
if not ids:
|
||||
_log.warning(
|
||||
f"[{self.serial}] 条件判断取号为空（来源 {source}）：{note}；手填候选 "
|
||||
f"{len(manual)} 个 → "
|
||||
+ ("仅用手填值" if manual else "候选为空，这一步将永远不命中（走未找到分支）"))
|
||||
src_txt = (f"候选来自台账({source}) {len(ids)} 个号" if ids
|
||||
else f"台账取号为空：{note}")
|
||||
if manual:
|
||||
src_txt += f"，另加手填 {len(manual)} 个"
|
||||
return "\n".join(merged), src_txt
|
||||
|
||||
def _dedup_policy(self):
|
||||
"""任务级去重有效期（`dedup_reset` / `dedup_hours`）→ (kind, hours)。
|
||||
|
||||
|
||||
@@ -511,6 +511,7 @@ body{background:var(--bg);font-family:var(--body);color:var(--text);font-size:14
|
||||
{% endif %}
|
||||
<div class="tabs">
|
||||
<button class="tab active" data-tab="monitor" onclick="showTab('monitor')">监控</button>
|
||||
<button class="tab" data-tab="account" onclick="showTab('account')" data-perm="devices">账号</button>
|
||||
<button class="tab" data-tab="tasks" onclick="showTab('tasks')">任务</button>
|
||||
<button class="tab" data-tab="logs" onclick="showTab('logs')" data-perm="logs">日志</button>
|
||||
<button class="tab" data-tab="users" onclick="showTab('users')" data-perm="admin">用户</button>
|
||||
@@ -581,6 +582,49 @@ body{background:var(--bg);font-family:var(--body);color:var(--text);font-size:14
|
||||
<div id="jobs-grid" class="jobs-grid"></div>
|
||||
</div>
|
||||
|
||||
<!-- ========== Tab: 账号（台账） ========== -->
|
||||
<div id="tab-account" class="tab-panel">
|
||||
<div class="page-title">账号</div>
|
||||
<div class="page-sub">每台设备上登录的抖音账号（谁在哪台机器上、卡在不在机内、能不能发视频）</div>
|
||||
|
||||
<div class="toolbar">
|
||||
<button class="btn btn-primary" onclick="openLedgerModal('')" data-perm="devices">新增账号</button>
|
||||
<button class="btn" onclick="openLedgerImport()" data-perm="devices">粘贴导入</button>
|
||||
<button class="btn" onclick="loadLedger()">刷新</button>
|
||||
<select class="form-control" id="ledger-device" style="width:140px" onchange="ledgerDeviceChanged()">
|
||||
<option value="">全部设备</option>
|
||||
</select>
|
||||
<input class="form-control list-search" id="search-ledger" placeholder="搜索设备号/账号名/抖音号/手机号...">
|
||||
<span class="text-muted" id="ledger-stats"></span>
|
||||
</div>
|
||||
|
||||
<table class="table">
|
||||
<thead><tr>
|
||||
<th data-sort="device_name" onclick="_lpSort('ledger','device_name')">设备号</th>
|
||||
<th data-sort="nickname" onclick="_lpSort('ledger','nickname')">账号名称</th>
|
||||
<th data-sort="douyin_id" onclick="_lpSort('ledger','douyin_id')">抖音号</th>
|
||||
<th>手机号</th>
|
||||
<th>注册时间</th>
|
||||
<th>卡在机内</th>
|
||||
<th>可发视频</th>
|
||||
<th>简介</th>
|
||||
<th>备注</th>
|
||||
<th>操作</th>
|
||||
</tr></thead>
|
||||
<tbody id="tb-ledger"></tbody>
|
||||
</table>
|
||||
<div class="list-pager" id="pager-ledger"></div>
|
||||
|
||||
<div class="help">
|
||||
这张台账有三个用处：① 人在机器旁时对照（手机端 Agent 的「身份大字页」也会显示本机账号）；
|
||||
② 任务的「条件判断」可以直接从这里取号（编辑器里把<b>候选值来源</b>选成「本机台账」，
|
||||
就不用把几十个号手写进去）；③ 设备池里能看到每台登记了几个号。<br>
|
||||
⚠ 台账里的抖音号是<b>纯号</b>（如 <code>35377983067</code>），只当"比对用的候选值"。
|
||||
<b>不要</b>拿它去填「去重」的身份元素 —— 身份比对的是元素原文
|
||||
（<code>抖音号：35377983067</code>），格式不同会让去重<b>静默失效</b>。
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- ========== Tab 2: 任务 ========== -->
|
||||
<div id="tab-tasks" class="tab-panel">
|
||||
<div class="page-title">任务</div>
|
||||
@@ -1284,6 +1328,7 @@ body{background:var(--bg);font-family:var(--body);color:var(--text);font-size:14
|
||||
<thead><tr>
|
||||
<th>serial</th><th>名称</th><th>型号</th><th>在线</th><th>状态</th>
|
||||
<th title="设备指纹（ro.serialno）：采集到之后，设备换 IP 才能被自动认领">指纹</th>
|
||||
<th title="这台设备在「账号」页登记了几个抖音号（点数字看明细）">账号</th>
|
||||
<th>添加时间</th><th>操作</th>
|
||||
</tr></thead>
|
||||
<tbody id="tb-devpool"></tbody>
|
||||
@@ -1481,5 +1526,6 @@ body{background:var(--bg);font-family:var(--body);color:var(--text);font-size:14
|
||||
<script src="/static/admin/steplog.js"></script>
|
||||
<script src="/static/admin/recorder.js"></script>
|
||||
<script src="/static/admin/dedup.js"></script>
|
||||
<script src="/static/admin/ledger.js"></script>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
+60
-2
@@ -17,7 +17,9 @@
|
||||
|
||||
管理端接口在文件后半段（`/api/agent-store/*`，走正常登录 + 权限）。
|
||||
"""
|
||||
import base64
|
||||
import hmac
|
||||
import json
|
||||
import os
|
||||
import secrets
|
||||
import time
|
||||
@@ -25,7 +27,7 @@ import time
|
||||
from flask import Blueprint, jsonify, request, send_file
|
||||
|
||||
from config import APK_DIR
|
||||
from core import device_pool
|
||||
from core import device_pool, ledger
|
||||
from core.db_config import meta_get, meta_set
|
||||
from core.logger import get_logger
|
||||
from web.auth import PERM_APKS, PERM_DEVICES, perm_required
|
||||
@@ -317,6 +319,32 @@ def api_agent_show_info():
|
||||
"--es", "server", server]
|
||||
if ip:
|
||||
args += ["--es", "ip", ip]
|
||||
# 本机账号台账（可选块）：身份页顺带显示"这台登的是哪几个号"。
|
||||
# **中文必须 base64**（§5.1：adb shell 直传中文/特殊字符会变形）；
|
||||
# `_adb` 是 argv 形式、不过 shell，base64 里的 +/= 安全 —— 将来谁把
|
||||
# 这里改成 shell=True 就会静默坏掉，别改。
|
||||
# 台账里没有这台设备时**整个 extra 不发**（设备端"没有这个 extra"=
|
||||
# 本来就没登记，跟"发了但解不开"能区分开），原因随响应体的 warn 回给操作者。
|
||||
warn = ""
|
||||
try:
|
||||
acc = ledger.agent_accounts(serial, device_name=name,
|
||||
include_phone=bool(data.get("include_phone")))
|
||||
if acc.get("accounts"):
|
||||
b64, acc = _encode_accounts(acc)
|
||||
if len(b64) + sum(len(a) for a in args) < _ARGS_CMD_MAX:
|
||||
args += ["--es", "accounts_b64", b64]
|
||||
_log.info("身份页附账号：%s 共 %s 个号（accounts_b64 %d 字节）",
|
||||
serial, acc.get("shown"), len(b64))
|
||||
else:
|
||||
warn = "账号台账过大，未随身份页下发"
|
||||
_log.warning("身份页未附账号：%s %s（%d 字节）", serial, warn, len(b64))
|
||||
else:
|
||||
warn = f"这台设备在账号台账里没有账号（{acc.get('note') or '未匹配到设备名'}）"
|
||||
_log.warning("身份页未附账号：%s %s", serial, warn)
|
||||
except Exception as e:
|
||||
# 台账坏了不能把"显示身份"这个动作弄坏：跳过该 extra，只回告警
|
||||
warn = f"账号台账读取失败：{e}"
|
||||
_log.warning("身份页附账号失败 %s: %s", serial, e)
|
||||
|
||||
# 先点亮屏幕、解除锁屏：设备息屏时 am start 会把大字页开在锁屏**后面**，
|
||||
# 人看到的还是一片黑（实测踩过）——这正是原来"定位"按钮里的"点亮屏幕"那一步
|
||||
@@ -339,7 +367,37 @@ def api_agent_show_info():
|
||||
"error": "这台设备没装设备 Agent（com.example.deviceagent）——"
|
||||
"可以从「应用管理 → 设备端应用商店」装，或用扫码配置"}), 400
|
||||
_log.info("设备端 Agent %s: %s", "关闭身份页" if close else "打开身份页", serial)
|
||||
return jsonify({"ok": True, "msg": "已关闭" if close else "已让设备显示身份信息"})
|
||||
resp = {"ok": True, "msg": "已关闭" if close else "已让设备显示身份信息"}
|
||||
if not close and warn:
|
||||
resp["warn"] = warn # 前端用 toast 提示（同二维码接口的 warn 惯例）
|
||||
return jsonify(resp)
|
||||
|
||||
|
||||
# accounts_b64 的预算：44 条 × ~90 字节 ≈ 4KB，base64 后 ≈ 5.3KB，余量充足。
|
||||
# 再加一道**命令行总长**闸（Windows CreateProcess 上限 ~32767）。
|
||||
ACCOUNTS_PAYLOAD_MAX = 20000
|
||||
_ARGS_CMD_MAX = 28000
|
||||
|
||||
|
||||
def _encode_accounts(acc):
|
||||
"""把账号块压成 base64（超预算**按整条丢**，永不按字节切）。
|
||||
|
||||
按字节切会产出破损 JSON —— 设备端解析失败只能整块丢掉，
|
||||
还不如少几条但能解开（`truncated`/`shown` 如实反映）。
|
||||
返回 (base64 文本, 修正后的块)。
|
||||
"""
|
||||
acc = dict(acc or {})
|
||||
rows = list(acc.get("accounts") or [])
|
||||
total = acc.get("total", len(rows))
|
||||
while True:
|
||||
block = dict(acc, accounts=rows, shown=len(rows),
|
||||
truncated=len(rows) < total)
|
||||
b64 = base64.b64encode(
|
||||
json.dumps(block, ensure_ascii=False, separators=(",", ":")).encode("utf-8")
|
||||
).decode("ascii")
|
||||
if len(b64) <= ACCOUNTS_PAYLOAD_MAX or not rows:
|
||||
return b64, block
|
||||
rows = rows[:-1]
|
||||
|
||||
|
||||
@bp.route("/api/agent-store/config", methods=["GET", "POST"])
|
||||
|
||||
+104
-1
@@ -4,7 +4,7 @@ from concurrent.futures import ThreadPoolExecutor, as_completed
|
||||
|
||||
from flask import Blueprint, jsonify, request
|
||||
|
||||
from core import device_battery, device_pool, device_discovery
|
||||
from core import device_battery, device_pool, device_discovery, ledger
|
||||
from core.adb_helper import adb_connect, adb_connect_light
|
||||
from core.logger import get_logger
|
||||
from web.auth import perm_required, PERM_DEVICES
|
||||
@@ -445,6 +445,109 @@ def api_devices_battery_scan():
|
||||
return jsonify({"ok": True, "msg": "采集已启动（约 1-3 秒）"})
|
||||
|
||||
|
||||
# ================== API：账号台账（「账号」页） ==================
|
||||
#
|
||||
# 数据在 device_account 表（见 core/ledger.py）；任务侧怎么用它取号见
|
||||
# tasks/generic/task.py 的 `_resolve_cmp_value`（if_el 的 cmp_source）。
|
||||
# ⚠ 台账的抖音号只做「条件判断」的比对值，**不做去重身份**（格式不同会静默失效）。
|
||||
|
||||
@bp.route("/api/ledger")
|
||||
@perm_required(PERM_DEVICES)
|
||||
def api_ledger_list():
|
||||
"""账号列表 + 统计（?device=设备号 &q=搜索 &limit=）。"""
|
||||
device_name = (request.args.get("device") or "").strip()
|
||||
q = (request.args.get("q") or "").strip()
|
||||
try:
|
||||
limit = int(request.args.get("limit") or 500)
|
||||
except ValueError:
|
||||
limit = 500
|
||||
try:
|
||||
rows, stats = ledger.list_accounts(device_name, q, limit)
|
||||
names = ledger.device_names()
|
||||
except Exception as e:
|
||||
_log.warning(f"读取账号台账失败: {e}")
|
||||
return jsonify({"ok": False, "error": str(e)[:120]}), 503
|
||||
return jsonify({"ok": True, "accounts": rows, "stats": stats, "device_names": names})
|
||||
|
||||
|
||||
@bp.route("/api/ledger/by_device")
|
||||
@perm_required(PERM_DEVICES)
|
||||
def api_ledger_by_device():
|
||||
"""按设备分组（设备池显示"这台几个号" + 点开看明细都走它，省一次请求）。"""
|
||||
devices = ledger.by_device()
|
||||
counts = {k: v["count"] for k, v in devices.items()}
|
||||
return jsonify({"ok": True, "devices": devices, "counts": counts})
|
||||
|
||||
|
||||
@bp.route("/api/ledger", methods=["POST"])
|
||||
@perm_required(PERM_DEVICES)
|
||||
def api_ledger_add():
|
||||
"""新增一条账号。"""
|
||||
row, err = ledger.add(request.json or {})
|
||||
if err:
|
||||
return jsonify({"ok": False, "error": err}), 400
|
||||
return jsonify({"ok": True, "msg": "已新增", "account": row})
|
||||
|
||||
|
||||
@bp.route("/api/ledger/<acc_id>", methods=["PUT"])
|
||||
@perm_required(PERM_DEVICES)
|
||||
def api_ledger_update(acc_id):
|
||||
"""改一条账号。"""
|
||||
row, err = ledger.update(acc_id, request.json or {})
|
||||
if err:
|
||||
code = 404 if "不存在" in err else 400
|
||||
return jsonify({"ok": False, "error": err}), code
|
||||
return jsonify({"ok": True, "msg": "已保存", "account": row})
|
||||
|
||||
|
||||
@bp.route("/api/ledger/<acc_id>", methods=["DELETE"])
|
||||
@perm_required(PERM_DEVICES)
|
||||
def api_ledger_delete(acc_id):
|
||||
"""删一条账号（删掉之后任务就取不到这个号了）。"""
|
||||
if not ledger.delete(acc_id):
|
||||
return jsonify({"ok": False, "error": "记录不存在或删除失败"}), 404
|
||||
return jsonify({"ok": True, "msg": "已删除"})
|
||||
|
||||
|
||||
@bp.route("/api/ledger/import", methods=["POST"])
|
||||
@perm_required(PERM_DEVICES)
|
||||
def api_ledger_import():
|
||||
"""从表格粘贴文本批量导入。
|
||||
|
||||
请求：{"text": "设备号\\t手机号\\t…\\nA01\\t…", "delimiter": "\\t",
|
||||
"mode": "skip|overwrite", "dry_run": true}
|
||||
dry_run=true 只解析+判重、**一个字节都不写** —— 界面默认先预览再导入。
|
||||
返回逐行结果（line/action/device_name/douyin_id/nickname/error/warns）+ 汇总。
|
||||
"""
|
||||
data = request.json or {}
|
||||
text = data.get("text") or ""
|
||||
if not text.strip():
|
||||
return jsonify({"ok": False, "error": "粘贴的内容是空的"}), 400
|
||||
delim = data.get("delimiter") or "\t"
|
||||
if delim == "tab":
|
||||
delim = "\t"
|
||||
mode = data.get("mode") or "skip"
|
||||
dry_run = bool(data.get("dry_run"))
|
||||
try:
|
||||
rows, errors = ledger.parse_paste(text, delim)
|
||||
except Exception as e:
|
||||
_log.warning(f"账号台账解析失败: {e}")
|
||||
return jsonify({"ok": False, "error": f"解析失败: {str(e)[:120]}"}), 400
|
||||
if not rows:
|
||||
return jsonify({"ok": True, "counts": {"total": 0, "added": 0, "updated": 0,
|
||||
"skipped": 0, "failed": 0},
|
||||
"rows": [], "errors": errors, "mode": mode, "dry_run": dry_run,
|
||||
"msg": "没有可导入的行"})
|
||||
try:
|
||||
result = ledger.import_rows(rows, mode=mode, dry_run=dry_run)
|
||||
except Exception as e:
|
||||
_log.warning(f"账号台账导入失败: {e}")
|
||||
return jsonify({"ok": False, "error": str(e)[:120]}), 503
|
||||
result["errors"] = errors
|
||||
result["msg"] = ("预览完成（未写入）" if dry_run else "导入完成")
|
||||
return jsonify({"ok": True, **result})
|
||||
|
||||
|
||||
# ================== API：Tailscale 管理（仅管理员） ==================
|
||||
# 通过 Tailscale 官方 API v2 管理 tailnet 设备（列表/改名/授权/密钥不过期/删除/生成 auth key）。
|
||||
# 设备 IP 由 tailnet 自动分配，API 无法修改，列表只读展示。
|
||||
|
||||
@@ -104,6 +104,9 @@ device_battery.init_app(app)
|
||||
# 去重账本（跨设备幂等）：绑 app 供任务线程/Web/清理任务自推 context
|
||||
from core import dedup
|
||||
dedup.init_app(app)
|
||||
# 账号台账：绑 app 供任务线程（条件判断取号）/ Web / 设备端身份页自推 context
|
||||
from core import ledger
|
||||
ledger.init_app(app)
|
||||
mgr = TaskManager(app=app)
|
||||
# 设备换地址（认领/迁址）后同步分组与任务的引用：它们的"内存副本"在 TaskManager 里
|
||||
# （调度用内存对象），device_pool 只改库不改内存不生效，所以在此注册回调打通
|
||||
|
||||
Reference in New Issue
Block a user