勾勾助手获取平台

勾勾助手使用指南 / 真机测试

适配目标 iOS 16–iOS 27

各版本适配进度不同,安装前请先查看设备与版本说明。

从一次点击,
到一条测试流程。

把截图、点击与滑动组织成 Python 脚本。在电脑上编写和调试,把项目保存在手机上,再从一个页面开始。

屏幕坐标示意原点 (0, 0)
(x, y) (0, 0)
gg.tap(x, y)以截图左上角为坐标原点

在电脑上编写,
在手机上执行。

工作台准备环境,编辑器组织项目,手机保存并运行脚本。
从开发到执行,每一步都有自己的位置。

电脑工作台

把设备和图像准备好

查看 USB 设备并完成激活;使用图色工具准备颜色点和图片模板,为脚本提供准确的输入。

  • 连接与激活测试设备
  • 截图、取色与裁剪模板
  • 按版本使用标注及模型训练工具
查看设备准备步骤
VS Code 插件

写代码,也看运行结果

在熟悉的编辑器中创建 Python 项目,查看接口提示,选择手机并上传运行,从日志定位问题。

  • 项目文件与资源管理
  • 代码补全与 API 提示
  • 上传、停止和错误定位
从一个脚本示例开始
手机端 App

把项目留在 iPhone 上

项目保存在手机中,可在 App 内再次启动和停止。完成准备后,手机负责执行脚本中的操作。

  • 保存并管理测试项目
  • 运行、停止与查看结果
  • 按需授权屏幕采集
了解独立运行条件

从看到页面,
到完成下一步操作。

按坐标操作,也可以结合图色、文字与模型识别判断页面。
每项能力都有独立的参数、示例和使用条件。

屏幕截图与图色

读取全屏或区域图片,提取颜色、比色和查找模板,为页面判断提供依据。

截图与图色
点击、滑动与输入

把屏幕坐标操作和文字输入组织成步骤,按业务需要等待页面变化。

触控操作
文字识别 OCR

读取屏幕或图片中的文字,获取识别框与坐标,按指定文字查找目标。

OCR 与文字查找
目标检测 YOLO

加载配套模型,识别图片中的目标并读取类别、位置和置信度。

模型识别
项目界面与交互

为脚本提供参数界面,读取用户选择,处理按钮事件和提示消息。

项目界面
Python 与第三方库

结合 NumPy、OpenCV、HTTP 请求和数据存储,把识别结果接入自己的流程。

第三方库指南

第一次使用,按这四步开始。

先完成设备准备,再运行脚本。接口调用发生在手机上。

查看完整入门教程 · 扫码安装手机主程序

  1. 准备设备与软件

    先核对设备与版本说明,准备 iPhone、电脑与 USB 线,按提供的使用说明安装配套工作台、编辑器插件和手机 App。

  2. 连接、信任与激活

    确保电脑和手机可以联网,解锁手机并信任电脑,在工作台通过 USB 完成激活;用到截图时,在手机上单独允许采集。

  3. 编写并上传运行

    在 VS Code 创建 Python 项目,选择 USB 设备,上传运行并结合日志、实际画面检查结果。

  4. 在手机管理项目

    已保存的项目可在手机再次运行或停止。手机重启后,需要通过电脑重新激活。

Python 脚本统一使用 import gougou as gg。在插件中选择“上传并运行”,即可在手机执行项目。

先读一段,
再写你的第一段。

从截图、点击或文字识别开始。示例可以直接复制到手机项目的 main.py。

使用配套手机与插件版本,先满足对应接口的运行条件。

阅读 Python API 入门

先在手机上允许屏幕采集,再读取当前画面的尺寸。

main.py
import gougou as gg

image = gg.snap()
print("像素尺寸:", image.width, image.height)

返回一张图片对象;print 打印它的像素宽度和高度。

输出示例(尺寸随手机和屏幕方向变化)

像素尺寸: 750 1334
截图完整说明 ↗

把这些能力,放进你的测试里。

从一个真实页面开始,逐步组织成可以复用的流程。

快速检查核心路径

把进入页面、点击关键控件和采集截图串起来,帮助检查一轮操作之后的实际页面。

打开目标页面 → 执行交互 → 核对截图

查看点击用法

按页面内容判断

读取文字或查找图片模板,根据识别结果决定下一步,让脚本跟着页面状态走。

读取画面 → 查找文字或图片 → 判断下一步

查看文字查找

复用重复操作

把常用步骤封装成 Python 函数,结合等待、日志和参数,在不同测试用例中重复使用。

组织函数 → 传入参数 → 记录结果

查看项目参数界面

接入前,
先看这里。

连接、授权、版本和运行方式,
是开始之前最常遇到的问题。

在 API 文档中查具体接口
现在可以下载使用吗?

手机主程序可通过既有 TestFlight 测试邀请获取,名额和可安装版本以邀请页面为准。请先查看扫码安装教程。新版工作台与插件公开下载仍在准备中,三者需配套使用。

支持哪些设备和系统?

产品适配目标为 iOS 16–iOS 27,各版本仍在分阶段验证。目前已有 iPhone 8/X(iOS 16)和 iPhone XR(iOS 17)的部分配套版本验证记录;这不代表所有机型、系统版本和安装渠道均已验证。iOS 18、26、27 的完整流程仍需继续核验。获取软件前,请确认你的具体机型、系统版本和安装方式是否适用。

电脑需要一直连接吗?

电脑用于初次准备、激活和项目上传。项目上传后保存在手机上,断开电脑连接或退出编辑器不会主动停止手机任务,也可以在手机 App 中再次启动已保存项目。运行仍受手机系统状态与接口条件约束。采用在线授权的版本还需保持手机能访问授权服务;手机独立执行不等于所有功能均可离线使用。

手机重启后要做什么?

手机重启后需解锁并通过 USB 重新连接电脑,在工作台刷新设备并重新激活,再继续运行脚本。

为什么连接成功后还需要截图许可?

设备连接与激活不等于屏幕采集授权。使用截图、图色或屏幕识别前,需要在手机上单独允许屏幕采集。

脚本是在电脑还是手机运行?

Python 接口由手机执行。请在插件中使用“上传并运行”;电脑上的 SDK 用于代码提示,直接在电脑运行手机接口不能替代手机执行。

PNG 和 JPG 应该怎么选?

需要精确像素比对时优先 PNG。JPG 是有损格式,可能改变颜色值;图片模板与截图方式请按接口说明配置。

如何排查脚本没有达到预期?

先看日志定位执行步骤,再核对手机实际画面、坐标和识别结果。页面变化后按需要等待或轮询;接口返回不代表目标控件已命中或业务流程已完成。

手机测试版 · TestFlight

获取配套版本

手机主程序通过 TestFlight 测试邀请安装,名额与可用版本以邀请页面为准。新版工作台和插件公开下载仍在准备中,请使用配套版本。

电脑工作台VS Code 插件手机 App

使用前请阅读 用户协议、隐私政策与使用风险提示(待发布稿)。

扫码安装手机主程序17088280@qq.com

QQ 交流群:12320321
在 QQ 中搜索群号申请加入。

配套版本咨询可通过邮箱或 QQ 群联系。请勿提供密码、验证码或私钥。