多设备内容发布系统任务后台使用文档API 文档

项目使用说明

当前运行模式：Mock 模式：只模拟流程，不会向任何平台发布。人工确认默认开启；页面出现“确认发布”按钮时，点击后才会触发最终发布步骤。

第一次使用

  1. 从“项目文档”阅读设备接入和安全配置，确定发布设备及平台账号归属。
  2. 手机插在 Windows/Mac/Linux 控制电脑上；该电脑运行 Control Agent、ADB、Appium。服务器不需要直接连 USB 手机。
  3. 在服务器配置设备节点和平台账号；在控制电脑配置同一设备编号、真实 ADB 序列号及对应 Appium。
  4. 把图片/视频放在服务器 MEDIA_ROOT 目录内，并确认格式可读。远程 Agent 只会下载该目录中的素材。
  5. AI 系统或 n8n 调用 POST /jobs 创建任务。可在 API 文档中试调；任务状态和设备心跳在 任务后台查看。
  6. 任务到时间后会由指定设备准备草稿。状态变为 WAITING_CONFIRM 后，检查标题、账号、素材和截图，再点击“确认发布”。遇到登录、验证码、人脸或风控提示时停止并人工处理。

创建任务示例

curl -X POST https://x.jishengai.com/jobs \
  -H 'Content-Type: application/json' \
  -d '{"platform":"douyin","device_id":"phone01","content_type":"video","media_files":["/data/videos/001.mp4"],"title":"示例标题","description":"正文","hashtags":["示例标签"]}'

media_files 使用服务器上的绝对路径，不是手机路径，也不是控制电脑路径。选择设备前先在任务后台确认它显示在线，并已配置所需平台。

任务状态说明

PENDING 等待计划时间；READY 已可运行；RUNNING/UPLOADING/FILLING_CONTENT 正在准备；WAITING_CONFIRM 等待人工审核；SUCCESS 表示适配器报告完成。模拟模式下的成功只是模拟结果。NEEDS_HUMAN 表示需要人工检查设备和平台状态；普通错误重试耗尽后显示 FAILED。

控制电脑启动

Windows、macOS 的自动启动模板和安装步骤分别在对应平台的项目文档目录；Linux 可使用 systemd 模板。首次 USB 调试授权必须在手机上人工确认。每台手机需要唯一 device_id，同一控制节点最多并发管理 7 台，单台设备一次只执行一个任务。

访问说明

推荐通过 https://x.jishengai.com 访问，HTTP 域名会自动跳转到 HTTPS。项目不再要求操作员账号密码，页面和普通 API 打开即用；仅 Control Agent 接口仍校验节点 Bearer Token。8002 端口仍可直接访问，但请使用 HTTPS 域名。