____ ____ _____ _ _ _
/ __ \ / __ \ | __ \ (_) | | | |
| | | | | | | | | |__) | _ | | ___ | |_
| | | | | | | | | ___/ | | | | / _ \ | __|
| |__| | | |__| | | | | | | | | (_) | | |_
\___\_\ \___\_\ |_| |_| |_| \___/ \__|
使用纯视觉 + 窗口自动化实现 QQ 消息自动回复，零 API 依赖、零注入、低封号风险。
适用于带有 图形桌面环境 的 Linux 系统（如 xfce4 等）。纯窗口管理器（如 i3、dwm）未经测试，可能无法正常运行。 由于pyautogui不支持wayland，请在x11下运行。
QQPilot 是一个全自动的 QQ 聊天机器人，通过以下流程实现智能回复：
复制聊天内容 → 解析消息（含图片/表情包）→ 调用 LLM 生成回复 → 模拟输入并发送
全程 不调用 QQ 内部接口、不 Hook 进程、不注入 DLL，极大降低账号封禁风险。
- 1920x1080 分辨率
- 8GB RAM
- 4GB ROM
- 至少一个桌面环境(Xfce4 、KDE 、Gnome 、Cinnamon 、Mate 、LXQt 等)
纯窗口管理器（如 i3、dwm）未经测试，可能无法正常运行。
前往官方页面下载并安装： 👉 https://im.qq.com/linuxqq/index.shtml
确保能正常启动并登录。
uv 是由 Astral 开发的超快 Python 工具链，用于替代 pip + pyenv。
# 官方安装（可能较慢）
curl -LsSf https://astral.sh/uv/install.sh | sh
安装后请重启终端。
tkinter，会导致 GUI 相关功能失败。
# 设置国内镜像加速 Python 二进制下载
export UV_PYTHON_INSTALL_MIRROR=https://mirror.nju.edu.cn/github-release/indygreg/python-build-standalone
# 安装 Python 3.14（QQPilot 推荐版本）
uv python install 3.14
# 验证安装
uv python list从 Releases 页面下载 Linux 版 ZIP 包，然后解压：
unzip *.zip -d QQPilot
cd QQPilotuv venv ./venv
source ./venv/bin/activate
chmod +x ./*.sh # 确保脚本可执行# 使用清华源加速 pip 安装
uv pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simpleQQPilot 依赖以下系统组件：
# 用于 pyperclip（剪贴板操作）
sudo apt install xclip
# 用于 pyautogui（模拟键盘/鼠标）
sudo apt install python3-tk python3-xlib
# （可选）如果你使用截图功能，确保有屏幕捕获权限
# 某些桌面环境（如 Wayland）可能需要额外配置💡 Wayland 用户注意：
pyautogui在 Wayland 下通常无法工作。建议切换到 X11 会话（登录时选择 “GNOME on Xorg” 等）。
项目提供三个核心脚本：
| 脚本 | 功能 |
|---|---|
menu.sh |
启动台 |
option.sh |
配置模型类型、API 地址、截图区域等 |
ExtensionManager.sh |
管理自定义扩展模块 |
run.sh |
启动主程序 |
./option.sh # 首次运行建议先配置
./run.sh # 启动机器人为提升隐私与响应速度，建议使用本地 LLM：
# 安装 Ollama（参考 https://ollama.com/）
curl -fsSL https://ollama.com/install.sh | sh
# 拉取推荐模型（8B 平衡版）
ollama pull huihui_ai/deepseek-r1-abliterated:8b
# 在 option.sh 中选择 "Ollama" 作为模型类型，并填写模型名
⚠️ 视觉多模态模型（如qwen3-vl）目前效果不佳，强烈建议使用纯文本模型。
| 设置项 | 推荐值 |
|---|---|
| 发送消息 | Ctrl+Enter |
| 联系人面板宽度 | 拖动至 最窄 |
| 自动更新 | 关闭 |
| 字体大小 | 设为 “最小” |
| 聊天背景 | 使用 默认白色背景 |
| 系统显示缩放 | 必须为 100%（不可缩放） |
🔍 QQPilot 通过 UI 坐标识别消息，任何界面变动（如缩放、深色主题）都可能导致识别失败。
安装neofetch之类的程序查看你的Linux发行版版本并炫耀
现在你可以让 QQPilot在Linux下自动监听 QQ 消息、调用大模型生成回复，并自动发送！
🌟 小贴士：
- 确保 QQ 窗口处于 前台且未最小化。
✅ 祝你使用愉快！
本项目基于 Python 3.14 开发，依赖见 requirements.txt。
本软件 仅限技术学习与研究用途，严禁用于：
- 自动骚扰、刷屏、诈骗等恶意行为
- 违反《QQ 软件许可协议》的操作
- 任何违法违规场景
使用者须自行承担因使用本软件引发的一切法律责任，作者概不负责。
本项目采用 MIT License。欢迎 Star ⭐、Fork 🍴 与贡献代码！
- 🐞 发现 Bug？ → 提交 Issue
- 💡 想改进功能？ → 提交 Pull Request
- 🌍 有新语言/模型建议？ → 欢迎讨论！
让我们一起打造更安全、智能的视觉自动化工具！