把设备和图像准备好
查看 USB 设备并完成激活;使用图色工具准备颜色点和图片模板,为脚本提供准确的输入。
- 连接与激活测试设备
- 截图、取色与裁剪模板
- 按版本使用标注及模型训练工具
勾勾助手使用指南 / 真机测试
适配目标 iOS 16–iOS 27
各版本适配进度不同,安装前请先查看设备与版本说明。
把截图、点击与滑动组织成 Python 脚本。在电脑上编写和调试,把项目保存在手机上,再从一个页面开始。
gg.tap(x, y)以截图左上角为坐标原点工作台准备环境,编辑器组织项目,手机保存并运行脚本。
从开发到执行,每一步都有自己的位置。
查看 USB 设备并完成激活;使用图色工具准备颜色点和图片模板,为脚本提供准确的输入。
在熟悉的编辑器中创建 Python 项目,查看接口提示,选择手机并上传运行,从日志定位问题。
项目保存在手机中,可在 App 内再次启动和停止。完成准备后,手机负责执行脚本中的操作。
按坐标操作,也可以结合图色、文字与模型识别判断页面。
每项能力都有独立的参数、示例和使用条件。
先核对设备与版本说明,准备 iPhone、电脑与 USB 线,按提供的使用说明安装配套工作台、编辑器插件和手机 App。
确保电脑和手机可以联网,解锁手机并信任电脑,在工作台通过 USB 完成激活;用到截图时,在手机上单独允许采集。
在 VS Code 创建 Python 项目,选择 USB 设备,上传运行并结合日志、实际画面检查结果。
已保存的项目可在手机再次运行或停止。手机重启后,需要通过电脑重新激活。
Python 脚本统一使用 import gougou as gg。在插件中选择“上传并运行”,即可在手机执行项目。
先在手机上允许屏幕采集,再读取当前画面的尺寸。
import gougou as gg
image = gg.snap()
print("像素尺寸:", image.width, image.height)返回一张图片对象;print 打印它的像素宽度和高度。
输出示例(尺寸随手机和屏幕方向变化)
像素尺寸: 750 1334先在目标页面核对坐标。本例会实际点击屏幕,并等待 0.5 秒。
import gougou as gg
import time
gg.tap(100, 200)
time.sleep(0.5)tap 不返回值,本例没有控制台输出。等待时间由脚本按页面变化安排。
点击完整说明 ↗在手机上允许屏幕采集,读取当前屏幕可识别的文字。
import gougou as gg
lines = gg.ocr("png")
for line in lines:
print(line["text"])返回识别结果列表;逐行打印文字。没有识别到文字时,列表为空,不输出内容。
输出示例(文字与行数随当前页面变化)
设置
通用从一个真实页面开始,逐步组织成可以复用的流程。
手机主程序可通过既有 TestFlight 测试邀请获取,名额和可安装版本以邀请页面为准。请先查看扫码安装教程。新版工作台与插件公开下载仍在准备中,三者需配套使用。
产品适配目标为 iOS 16–iOS 27,各版本仍在分阶段验证。目前已有 iPhone 8/X(iOS 16)和 iPhone XR(iOS 17)的部分配套版本验证记录;这不代表所有机型、系统版本和安装渠道均已验证。iOS 18、26、27 的完整流程仍需继续核验。获取软件前,请确认你的具体机型、系统版本和安装方式是否适用。
电脑用于初次准备、激活和项目上传。项目上传后保存在手机上,断开电脑连接或退出编辑器不会主动停止手机任务,也可以在手机 App 中再次启动已保存项目。运行仍受手机系统状态与接口条件约束。采用在线授权的版本还需保持手机能访问授权服务;手机独立执行不等于所有功能均可离线使用。
手机重启后需解锁并通过 USB 重新连接电脑,在工作台刷新设备并重新激活,再继续运行脚本。
设备连接与激活不等于屏幕采集授权。使用截图、图色或屏幕识别前,需要在手机上单独允许屏幕采集。
Python 接口由手机执行。请在插件中使用“上传并运行”;电脑上的 SDK 用于代码提示,直接在电脑运行手机接口不能替代手机执行。
需要精确像素比对时优先 PNG。JPG 是有损格式,可能改变颜色值;图片模板与截图方式请按接口说明配置。
先看日志定位执行步骤,再核对手机实际画面、坐标和识别结果。页面变化后按需要等待或轮询;接口返回不代表目标控件已命中或业务流程已完成。
手机测试版 · TestFlight
手机主程序通过 TestFlight 测试邀请安装,名额与可用版本以邀请页面为准。新版工作台和插件公开下载仍在准备中,请使用配套版本。