butubb/auto_control
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
auto_control/doc/README.md
T
butubb b98e6deac1 feat(发布计划): 视频发布计划（批量上传配对 → 时间线 → 推送到手机 → 发布任务 → 分享链接） 
一、平台侧（账号 → 发布计划页）
- 新表 video_plan（schema v9→v10）：账号×发布日期×编号 → 素材 + 标题 + 发布状态 + 分享链接；
  状态机 pending/ready/pushing/publishing/done/failed/unknown/skipped（**failed 与 unknown 必须分开**：
  推送阶段的失败可安全重试；碰过抖音之后的岔子只能算"结果未知"，绝不自动重发）
- 素材上传：文件名 `手机号_日期_编号`（编号可省）解析配对；标题 txt `标题内容_手机号_日期_编号`；
  内容寻址落盘 data/videos/YYYY-MM/（sha1 分块算，同名不存两份），**不进整库备份**但进 manifest 反查
- 新蓝图 web/video_plan_api.py：上传/时间线/统计/单条增删改/推送到手机/标记结果/裁决/链接导出 CSV/
  任务列表与一键新建、**就地编辑**（GET/PUT /tasks/<id>）、**一键推送**（POST /push_all，按设备分组、设备内串行）
- 账号页拆子分栏（台账 / 发布计划）+ static/admin/release.js；清理 job（04:41 僵尸回收+过期行、04:47 素材文件）
- 上传体积：MAX_CONTENT_LENGTH（默认 2GiB）+ 413 JSON + nginx client_max_body_size（修现有 APK 上传隐患）

二、任务侧（平台推素材，抖音流程你自己写）
- 新步骤 push_release「推送发布视频」：原子占位 → adb push → **touch 改成"现在"** → 清旧目录同名副本 →
  触发扫描并**按路径**校验相册索引 → 标题写进剪贴板；默认目录 /sdcard/DCIM/Camera
- 新步骤 mark_release「标记发布结果」：回写 done/failed/unknown，成功时抓作品分享链接、删手机素材
- input_text 支持 text_source=release_title（自动取计划标题 + 回读校验）；
  if_el 的候选值来源新增 release（**本机当前发布计划**的抖音号/昵称，发布前校验"登的是不是要发的号"）
- build_release_steps 骨架 15 步：⓪ 亮屏 → ① 打开抖音(等首页) → ② 点「我」→ ③ 等抖音号出现 →
  ④ 条件判断(账号) → then ⑤ 推送 ⑥⑦⑧⑨⑩⑪⑫ 抖音点击/填标题 → ⑬ 标记 / else 发通知跳过

三、修（推送这一路的检测机制）
- **uiautomator2 3.x 的 d.shell() 返回 ShellResponse（tuple 子类）不是 str**：`'x' in resp` 恒 False、
  `.strip()` 不存在 → "推上去的文件大小不对"每次都判失败（文件其实推上去了）、相册校验永远报没进、
  删除确认永远判没删掉。新增 publish_flow._sh() 统一取 .output；大小改成解析 ls -l 的大小列
- **adb push 保留本地 mtime** → 推 3 天前上传的素材在按时间排序的相册里排不到最前，
  "点第一个 = 刚推的那个"不成立 → 推完 touch
- 相册校验**按路径**比（MediaStore 的 _data 会把目录小写、/storage/emulated/0 ≡ /sdcard），
  只比文件名会被老目录的同名残留骗过去
- 屏幕没亮就启动抖音会永远停在启动页（UI 树为空）→ 后面"点我/等抖音号"必然 miss，
  最后报成误导人的"账号不符" → 骨架第一步固定加「亮屏」，open_app 等「首页」出现

四、其它
- core/ledger.serial_of()：设备名 → 当前地址（设备换 IP 后快照是错的）
- 通知事件 task.video.published / task.video.failed；备份清单加 video_plan 与素材统计
- 文档同步：DATA_MODEL §2.11 + schema v10、API（新接口与语义）、TASK_DEV §4.7 专章、
  ARCHITECTURE（账号页子分栏/release.js/两个 job）、DEPLOY（表数/nginx）、NOTIFY、DEVELOPMENT、README
2026-09-28 15:59:09 +08:00

5.9 KiB
Raw Permalink Blame History

auto_control 文档总索引

本目录是 auto_control（Android 多设备自动化任务平台）的唯一权威文档源。代码即事实，文档与代码不一致时以代码为准，并顺手把文档改对（见文末维护约定）。

项目名称统一为 auto_control（历史文档里出现过的 platform-tools 均为旧名，已全部改名）。

1. 文档地图

文档 内容 主要读者
ARCHITECTURE.md 架构详解：分层、启动装配顺序、线程与并发模型、设备生命周期、任务调度链路、状态机、关键设计决策与扩展点 所有开发者（先读这篇）
DATA_MODEL.md 数据模型：SQLite 表与字段、schema 迁移、非模型表、app_meta 配置键、数据目录、备份覆盖清单 后端开发、运维
API.md HTTP 接口全量：按蓝图分组的路由表、鉴权、请求/响应示例、非 JSON 响应、错误分支 前端开发、外部接入
TASK_DEV.md 任务与步骤开发：TaskType/TaskJob 概念、24 种步骤全表、公共巡检、选择器与定位、自定义动作、新增任务类型模板 写任务的开发
MCP.md MCP 手机控制手册：20 个 de_* 工具用法、写操作门控、坐标换算、接入示例 接入方、数字员工
MCP_DESIGN.md MCP 设计文档：边界划分、错误码、白名单/审计设计、演进方向 平台开发者
AI_CONSOLE.md AI 控制台：会话/SSE、经验库、动作库、巡检、Markdown 渲染、推理链、token 统计 使用者、平台开发者
AI_TASK_GEN.md AI 建任务：AI 自己在真机探索 → 写出可调度任务 → 人工确认入库（P0 已实现；契约与红线） 平台开发者、使用者
NOTIFY.md 通知 / Webhook：事件目录、企业微信/通用 JSON 适配、防刷屏（聚合/限流/折叠）、排障、怎么加事件 运维、平台开发者
DEVICE_AGENT.md 设备端 Agent 接口契约：应用商店的设备专用接口（清单/下载/上报）、adb 指令协议、版本约定 —— 与设备端 APK 仓库共享的契约 设备端开发者、平台开发者
DEPLOY.md 部署与运维：环境准备、生产容器、数据备份导出/导入、故障排查 运维、部署者
DEVELOPMENT.md 开发手册：git 流程、技术红线、本地开发与调试、常见开发任务、文档同步约定 所有开发者
STF_REMOVAL.md 历史记录：摘除 OpenSTF 的迁移过程（阶段 0-3） 追溯背景时参考
staffdeck/KNOWLEDGE_BASE.md 给 StaffDeck 数字员工的知识库（MCP 接入/工具/约定/红线） 外部 AI 接入方
staffdeck/JOB_SPEC.md 数字员工岗位说明（岗位描述/看板摘要/执行约束） 外部 AI 接入方
research/U2_ELEMENT_SELECTORS.md 元素选择器研究：「点不到按钮」的根因（序号型选择器随界面变形而错位）与语义选择器解法 写任务/抓元素的开发
backlog/TODO.md 已确认但暂缓的待办（含已知问题） 所有开发者

项目根目录的 README.md 是项目总览与快速上手（面向第一次接触项目的人），细节都在本目录。

2. 推荐的阅读路径

你的目的 按顺序读
第一次接触项目 根 README.md → ARCHITECTURE.md → DATA_MODEL.md
搭环境跑起来 根 README.md 的「快速上手」→ DEPLOY.md
写/改任务 TASK_DEV.md → ARCHITECTURE.md §任务调度
改后端/前端 DEVELOPMENT.md（流程+红线+本地开发）→ ARCHITECTURE.md → API.md
对外提供手机控制 MCP.md → staffdeck/KNOWLEDGE_BASE.md
排故障 DEPLOY.md §故障排查 → DEVELOPMENT.md §调试

3. 文档维护约定（红线）

与「doc 同步红线」一致：任何功能/配置/接口/表结构的增删改，必须在同一个 commit 里同步更新对应文档。

改动类型 必须同步的文档
HTTP 接口（新增/改参数/改返回/改鉴权） API.md
数据库表/字段/迁移 DATA_MODEL.md + ARCHITECTURE.md
新增持久化表 还要登记进 core/system_backup.py 的 SUMMARY_TABLES + DEPLOY.md §3.5（备份覆盖红线）
config.py / .env 键 DEVELOPMENT.md 配置速查 + DEPLOY.md + .env.example
页面 Tab / 子分栏 / 前端 JS 拆分 ARCHITECTURE.md §前端 + DEVELOPMENT.md
任务类型 / 步骤 schema TASK_DEV.md
常驻线程 / 进程装配 ARCHITECTURE.md §线程与并发
MCP 工具 MCP.md + MCP_DESIGN.md
设备端 Agent（APK） DEVICE_AGENT.md
对外接入约定 staffdeck/KNOWLEDGE_BASE.md
暂缓项 / 已知问题 backlog/TODO.md（完成时移出并同步相关文档）

新增文档时：在本文 §1 表格里登记一行，并在根 README 的「更多文档」里加链接——否则等于没写。

历史文档不追改：STF_REMOVAL.md 是迁移阶段的历史记录，只增不改，不随现状改写。

Reference in New Issue View Git Blame Copy Permalink