[!WARNING] 对QQPilot PE启用无障碍模式后可能出现按键与蓝牙延迟情况 如果遇到次问题,关闭它的无障碍权限即可。
QQPilot Pocket Edition(QQPilotPE)是一款运行在 Android 上的全自动 QQ 聊天机器人。它采用纯视觉方案完成收发消息,全程不调用 QQ 内部接口、不注入 DLL,尽量避免触发客户端的风险检测。
QQPilot Pocket Edition和QQPilot/QQPilotLinux可以同时在同一个账号上运行。
OpenCV 检测红点 → 点击会话 → 解析屏幕消息 → 生成回复(MNN / OpenAI 兼容 API)→ 输入内容 → 点击“发送”
- 本项目基于 Autox.js v6_ozobi 开发,安全性虽不如 Linux / Windows 版本,但仍然相对安全。
- 无需修改 QQ 客户端,无需 Root 权限。
- 自动化操作仍存在账号风险,建议使用小号测试,并妥善保管 API Key。
Important
QQPilotPE可能会申请root权限,可以直接拒绝。不影响正常使用。
- 运行时独占手机前台,请保持 QQ 在最前方并关闭锁屏。
- 图片解析(把聊天图片作为视觉模型输入)为实验性功能,暂不支持主动发送图片。
- 仅适配“简洁模式 + 极简白”的 QQ 界面,其他主题可能导致控件解析失败。
| 配置等级 | Android 版本 | RAM | ROM |
|---|---|---|---|
| 最低配置 | Android 7+ | 4GB | 4GB |
| 建议配置 | Android 10+ | 8GB | 16GB |
使用本地模型时,请根据模型大小额外预留内存与存储空间。
QQPilotPocketEdition/
├── QQPlilot.js # 主脚本:视觉识别、消息解析、模型调用、发送
├── option/ # 设置 App
│ ├── option.js
│ └── project.json
├── assets/ # 图标与界面资源
├── tutorial/ # MNN Chat 配置教程截图
├── test/ # 调试脚本(截图、图片 Base64 等)
├── config.json # 配置示例
├── project.json # 主项目信息
└── README.md
getAnswer()负责组装 OpenAI 格式请求,通过 OkHttp 发送,超时时间由配置中的timeout控制。- 主循环通过检测
#FA4C2D红点进入会话,滚动读取TextView,再根据控件数量分类出发送者与消息内容。
- 用 Autox.js v6_ozobi 导入
QQPlilot.js或整个项目。 - 修改后先在真机运行
test/test.js,确认截图、控件查找正常。 option/是独立的设置 App 项目,修改后在 Autox.js 中单独打包。- 版本号在
project.json与option/project.json中同步修改。
- 提示“未找到QQ”:确认已安装 QQ,且
getPackageName("QQ")能解析到包名。 - 一直提示 timeout:检查服务地址、API Key、模型名,以及手机是否能访问该地址;本地服务需与手机在同一网络。
- 找不到“发送”按钮:QQ 必须使用简洁模式与极简白主题。
欢迎任何形式的贡献。
- 🐞 发现 Bug → 提交 Issue
- 💡 功能改进 → 提交 Pull Request
- 🌍 语言/模型建议 → 欢迎在 Issue 中讨论
- 代码:采用 GPL-2.0 License
- 图片资源:遵循 QQPilot Windows 版本 许可证
