视频文件名规则 手机号_日期_编号（编号可省略，日期如 20260912 就是发布日期）； 标题 txt 每行 标题内容_手机号_日期_编号（标题里可以有下划线，# 开头的行忽略）。 手机号必须在「账号台账」里，否则拒收。
上传后自动按 (手机号, 日期, 编号) 配对：有编号按编号精确对，没编号按顺序配 —— 没传标题的视频不会被推送（先在计划页改标题或补传标题）。
平台只负责把视频推到手机（推到 /sdcard/DCIM/Camera/、把文件时间改成"现在"好排在相册最前、触发相册刷新并按路径校验进了索引、 把标题写进手机剪贴板）；**抖音里怎么发由你在任务里自己写步骤** —— 步骤顺序是：「推送发布视频」→ 你自己的发布步骤（打开抖音→点+→相册→选视频→下一步→粘贴标题→发布）→ 最后放一个「标记发布结果」。
计划页的「推送到手机」是同一件事的人工入口（推完你在手机上发，发完点「标记已发布」）。
⚠ 发布结果以每行的状态为准：失败(可重试)说明推送都没成功、可以再推； 结果未知(需确认)说明推送之后那一段出了岔子、可能已经发出去了， 要先到抖音里看一眼，再用「已发出 / 未发出」裁决（平台不会自动重发）。

把常用步骤打包成可复用的动作，拖入任务步骤编辑器使用；也可在任务编辑器里"☑选中步骤→打包"生成

步骤默认值：新建步骤时预填这套参数（只影响之后新建的步骤，已有步骤不动； 单步想改就打开那个任务改那一步）。
录制动作：在设备画面上点/划/按键，自动翻译成步骤 —— 既能存成可复用的「自定义动作」， 也能只取一个手势回填到滑动步骤上（步骤编辑器里滑动那一步有「录制手势」按钮）。

选中目标设备后，命令里的 -s <设备> 自动附加，直接写 shell ls /sdcard 即可。离线设备也可选，用"重连设备"恢复。 禁止 kill-server / disconnect（会中断共享的 adb transport，导致设备连接全部重建）。

（执行命令后输出显示在这里）

"设置IP"可修改设备 IPv4（会断开当前连接，平台 serial 随之变化，需同步设备池）；"密钥不过期"= 关闭设备密钥验证，设备不会被定期踢下线；auth key 生成后只显示一次，请立即复制。

设备上装的 Agent 自己来拉这份应用清单 → 在手机上选一个 → 自己下载 → 自己调系统安装器安装。 因为安装由设备上的 App 发起，走的是普通应用安装流程， 不会触发 MIUI 针对 adb 安装的「USB 安装」拦截（那正是 adb install 报 USER_RESTRICTED 的原因）。 适合"人就在机器旁边"的场景（本来就要点一次安装确认）。平台批量推送仍用上面的「安装」按钮。
接口契约见 doc/DEVICE_AGENT.md；令牌属于凭据，别外传。

查询所有设备（本地 adb 含 USB + 设备池）上该包名的安装情况与版本号，用于对比各设备 App 版本是否一致；未连接的设备会自动连接（绝不断开，不影响任务）。

新增设备流程：手机开 USB 调试 → 连上后「adb 终端」执行 tcpip 5555 转网络调试 → Tailscale 上线（同一账号）→ 在此添加 IP:5555（自动尝试连接）→ 任务运行时 u2 自动推送 atx-agent。停用 = 不参与任务调度，删除 = 从池中移除（不影响其他系统）。
设备名称必填且唯一：它是设备在平台里的身份（分组/任务/日志都按名称认设备）； 设备换了 IP 时用「换地址」把记录迁过去，分组与任务的引用会自动同步，不用重新配。

管理设备分组，用于任务按分组执行。分组内的设备需先在设备池管理中确认（不在池内的设备不参与调度）。

导入恢复：上传平台导出的 .zip 或 .db → 先校验预览 → 确认后系统会自动备份当前库（data/backups/pre_restore_*.zip，可直接再导入回来）并把恢复任务挂起， 重启 web_server 后生效（导入将覆盖现有全部数据；数据替换在单个事务里完成，失败会自动回滚）。
备份来自另一个环境（dev↔prod）时默认拒绝导入，需在预览页显式勾选「允许跨环境导入」。

通知：把平台事件（任务失败/成功、设备上下线、安装完成、备份恢复…）推到 webhook， 例如企业微信群机器人。每条 webhook 自己勾选关心哪些事件——不勾就不推。
为防刷屏：同一条 webhook 默认每 30 秒合并一次同类事件、每分钟最多 18 条 （企业微信硬限 20），超出的会压成一条「被限流折叠」摘要而不是丢掉。详见 doc/NOTIFY.md。