Skip to content

About

基于 AutoJs6 / Hamibot 的 Android 多设备自动化预约排班工具。支持多机协同并发、屏幕坐标适配、规则表动态路由与毫秒级定时对齐。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

多手机自动排班与流程调度工具

一套基于 AutoJs6 / Hamibot 的 Android 多设备自动化预约排班工具。针对周期性定时放号、几秒内秒空的场景,通过多台手机协同运行、毫秒级定时对齐、设备坐标与排班规则解耦,实现多终端并行执行与自适应回退,解决人工盯秒操作繁琐和单机易卡死的问题。


一、为什么做这个工具?

很多政务或医疗便民业务(如专科门诊)实行每天清晨固定时间放号,号源极少,几十秒内就会被约满。

如果纯靠人工操作:

  1. 每天清晨盯秒操作非常折磨人,手速和网络稍慢就抢不到;
  2. 单台手机跑自动化也不稳,遇到偶发网络卡顿或系统弹窗,当天就彻底失败;
  3. 出诊人员排班经常变动(比如周一上午出诊,下周又临时调休),如果把人员和时间写死在脚本里,每次变动都得重新改代码。

因此,这个工具的核心目的就是:把多台手机组织起来协同操作,到点自动进页面、按规则选人占座,成功后响铃叫醒人来付款。


二、从“多个独立脚本”到“统一配置框架”的演进

这个项目不是一开始就设计成框架的,而是经历了一个非常真实的工程演进过程:

【第一阶段:单机硬编码脚本】
一台手机,一份脚本,所有点击坐标、等待时间和排班规则全写死在代码里。能跑,但极度脆弱。
       ↓
【第二阶段:多机复制带来的“维护地狱”】
为了提高命中率引入多台手机,不同手机屏幕分辨率和手势距离完全不同;加上人员频繁调休,
导致手里堆了多份类似脚本(如 Xiaomi_周12.js、vivo_周34.js),每次排班微调都要逐台改代码。
       ↓
【第三阶段:架构解耦与配置化抽象】
发现流程主干完全相同,变动的只有“屏幕物理坐标”和“出诊排班表”。
于是彻底重构:将机型坐标抽离为设备配置(JSON),排班映射抽离为规则表,驱动统一的核心执行引擎。

三、我的职责

本项目由本人独立主导并完成,负责实际痛点分析、真机操作流程拆解、AutoJs6 自动化脚本开发、多机型屏幕参数标定、统一执行框架重构及长期实机运行维护。


四、系统架构与演进方向

多设备 Android UI 自动化系统架构与运行流程

⚠️ 实现状态说明(当前实现 vs 后续规划):

  • 【当前已落地实现】:多台手机独立运行、AutoJs6/Hamibot 终端执行、异构设备屏幕坐标配置(JSON)、星期与排班规则表(JSON)、多终端独立并行执行、本地持续震动与系统闹铃提醒;
  • 【后续规划(暂未实现)】:图中展示的 Web 管理后台、Python/Flask 远程调度服务、远程任务自动分发、设备状态在线监控与统一日志汇总,属于系统未来的演进规划方向,目前尚未编码实现。

五、核心设计机制

排班规则表 (Rules) + 设备参数 (Adapter) → 通用执行引擎 (Engine) → 终端独立执行 → 闹铃/震动人工交接

1. 屏幕坐标与代码彻底分开(设备适配层)

不同品牌和型号的手机屏幕大小完全不同。我们将每台手机的坐标、滑动距离全部提取成独立的 JSON 配置文件(存放在 config/devices/ 下)。接入新手机只需要量一下新坐标填进配置,核心代码一行都不用改。

2. 排班规则单独配置(业务调度层)

谁星期几出诊、是上午还是下午、优先选哪个时段,全部写在 config/rules/shift_schedule.json 规则表里。脚本启动时根据当天星期自动匹配,遇到人员调休改表即生效。

3. 毫秒级时间微调(执行层)

  • 提前 30 秒预热:放号前半分钟,手机自动打开 App 并停留在待选列表页,把冷启动耗时留在放号前完成;
  • 提前 30 毫秒发包(05:59:59.970):提前几十毫秒发出点击事件,刚好用动作和系统渲染的耗时抵消掉网络延迟,卡准放号瞬间切入排班表;
  • 时段快速回退:首选时段如果显示没号,脚本在 100 毫秒内自动切换并尝试备选时段,不卡死在单个时段上。

4. 人机分工,守住安全底线(安全提醒层)

程序只负责速度敏感的“选人、选时段、占座”。一旦占座成功进入最终确认页,脚本立刻停止操作,并触发手机持续震动和系统闹铃,由人来做最终核对并完成指纹/人脸支付。


六、项目成果

  • 架构成效:将原本分散维护的多套单机脚本抽象为统一执行框架,使设备差异、坐标参数和排班策略彻底独立配置,后续规则变动零代码修改;
  • 实战验证:通过多终端独立并行运行对冲单机偶发卡死,显著降低了人工清晨盯秒的操作成本,已在多台真机上长期稳定运行。

七、技术栈

  • 自动化引擎:AutoJs6 / Hamibot (基于 Android Accessibility 无障碍服务)
  • 脚本语言:JavaScript (ES5/Rhino 运行时)
  • 配置驱动:JSON 数据建模 (设备物理参数与业务规则解耦)

八、工程目录结构

├── README.md                       # 项目说明
├── LICENSE                         # MIT 开源许可证
├── .gitignore                      # 忽略本地临时文件与日志
├── docs/                           # 架构与演示资源
│   └── images/
│       └── architecture.png        # 系统架构与演进方向示意图
├── config/                         # 配置目录(核心:坐标与规则)
│   ├── devices/                    # 各机型坐标配置
│   │   ├── xiaomi_13.json          # 小米 13 坐标与手势参数
│   │   ├── vivo_x.json             # vivo 机型坐标参数
│   │   └── template.json           # 新手机坐标配置模板
│   └── rules/                      # 排班与时段规则
│       └── shift_schedule.json     # 星期与人员、时段映射配置
└── src/                            # 脚本代码
    ├── core/                       # 通用执行引擎
    │   └── engine.js               # 根据配置自动执行预热、点击、回退与提醒
    └── standalone/                 # 经实机验证的独立脚本
        ├── xiaomi13_runner.js      # 小米 13 专机独立运行脚本
        └── vivo_runner.js          # vivo 专机独立运行脚本

九、使用说明

  1. 手机安装 AutoJs6 或 Hamibot,开启“无障碍服务”并允许后台运行;
  2. 如果使用已有支持的机型(如小米 13、vivo),直接导入对应的专机脚本或通用引擎;
  3. 如果是新手机,打开开发者选项里的“指针位置”,量出对应位置的坐标,参考 config/devices/template.json 填好即可;
  4. 每天放号前启动脚本,保持手机亮屏,到点自动执行,成功后会通过响铃和震动提醒付款。

十、安全声明

  • 本项目代码及配置已全部去标识化脱敏,不包含任何个人账号、密码或私密就诊数据;
  • 仅供日常日程管理与 Android 自动化技术交流学习使用;
  • 遵循 MIT 开源协议。

About

基于 AutoJs6 / Hamibot 的 Android 多设备自动化预约排班工具。支持多机协同并发、屏幕坐标适配、规则表动态路由与毫秒级定时对齐。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages