SuperAPI AI 工具集

phone-harness

通用与其它

查看项目

更新于 10-16 03:36

技能介绍

用途:phone-harness 让 Python 脚本直接控制手机,同一套助手函数可驱动多种手机,区别在于各设备如何“看”和“点”屏幕。

主要能力:ensure_device() 返回可用后的屏幕边界;screen() 返回可见文本框 {text, confidence, source, x, y, w, h};screenshot() 截图;find_text()、tap_text()、tap()、long_press()、type_text()、press()、open_app()、swipe()、scroll()、scroll_screen()、scroll_until()、scroll_collect()、home()、back()、app_switcher()、wait_stable()、wait_for_text()、wait_for_app()、ui()、tap_ui()、current_app()、list_apps()、screen_info()、find_window()、image_point()、tap_image_point()、connection_state()、shell() 等。

使用方式:以 heredoc 调用 phone-harness,助手已预导入,脚本以 # task: 和 # step: 开头。读取用 screen() 而非肉眼截图;操作后需验证,如 wait_for_text()、wait_for_app() 或 wait_stable()。scroll 表示想看到的内容方向,swipe 表示手指方向。type_text 需先聚焦输入框。

适用场景:仅手机可用的应用、与手机号或 2FA 绑定的任务、查看手机上的显示效果。若任务可在 Mac 或网页完成,应优先在那边做。

限制:涉及发送、发布、关注、购买、删除、改设置等对外或难以撤销的操作前须征得用户同意;不得输入 PIN、密码或 2FA 码。云手机按分钟计费,默认 15 分钟、上限 30 分钟,需及时停止。个人 iPhone 与云 iPhone 是不同设备,不可混用。配对、解锁、批准登录等需用户自行完成。未登录需用户运行 phone-harness cloud login。具体平台支持与配置细节以官方资料为准。