ClickZen - 基于ADB的Android自动化控制工具

---

需要Windows的自动化控制工具？ 试试ClickYen！

---

---

📋 项目主页

• ClickZen的GitHub页面

---

📋 项目简介

ClickZen 是一个基于 Python 开发的 Android 设备自动化控制工具，通过 ADB 和 Scrcpy 实现设备投屏、操作录制回放、图像识别自动化等功能。特别适用于自动化测试、游戏挂机、批量操作等场景。部分自动化灵感来源于手机端的成熟项目"klick‘r"。

---

⚠️ 重要声明

1. AI代码风险提示：本项目部分代码由AI辅助生成，可能存在潜在的bug或安全问题。使用前请仔细审查代码，风险自负。
2. 作者能力有限：本人编程水平有限，代码质量可能不高。作者 Python 水平约等于 Hello World → 欢迎 PR 教我写 class。
3. 使用责任：请合理使用本工具，遵守相关法律法规。因使用本工具产生的任何问题，作者不承担责任。

---

✨ 主要功能

• 🖥️ 设备投屏控制：通过 Scrcpy 实现低延迟投屏
• 📱 多平台支持：完美支持 真机、WSA (Windows Subsystem for Android) 以及 主流模拟器 (MuMu、雷电、夜神等)
• 🎬 操作录制回放：精确记录和回放用户操作，支持滑动手势录制
• 🎯 图像识别自动化：基于模板匹配的自动化任务（类Klick’r）
• 🪟 后台挂机：支持后台窗口捕获 (PrintWindow)，应用被遮挡也能正常运行
• 🎲 防检测机制：随机化操作模拟人工行为
• 📊 变量系统：支持条件判断和动态变量
• 🔧 易用的GUI：直观的图形界面操作，新增精准截图与坐标拾取工具

---

🚀 快速上手 (面向普通用户)

如果您不了解代码，只想直接使用本软件，请按以下步骤操作：

1. 下载程序：

   • 前往 Releases 发布页面。

2. 连接设备：

   • 真机用户：开启“USB调试”（小米需开启安全设置），连接电脑。
   • 模拟器用户：启动模拟器，软件通常会自动识别；如未识别请在设置中手动指定端口。

3. 运行软件：

   • 找到并双击 ClickZen.exe 即可启动程序。
   • 点击软件界面上的 “刷新设备”。
   • 点击 “启动 scrcpy” (或直接使用模拟器窗口模式) 即可开始操作。

---

📖 功能指南

🧩 基础使用

1. 确保设备已连接。
2. 点击 “刷新设备” 识别设备。
3. 对于模拟器，推荐使用 “模拟器模式” 以获得更好的后台挂机体验。

⚙️ 进阶功能

🎬 录制脚本

• 点击 “录制” 会从第一个操作开始录制，支持点击与滑动。
• 点击 “结束录制” 完成录制。
• 可以执行录制好的文件——记得先保存！

🤖 类 Klick'r 的自动化监控

1. 创建任务，设置好变量和条件（如果需要复杂的监控方案）。
2. 点击 “监控区域” → 在弹出的投屏窗口上框选您想监控的区域 → 点击 “截取区域”，系统会自动将这块区域的图像作为后续识别的目标。
3. 选择匹配阈值与冷却时间。
   🔸 冷却时间 指的是当条件满足后，执行相应操作的间隔，而不是检测的间隔。
4. 添加您希望执行的动作。
   可执行操作包括：
   • 变量更改
   • 点击、滑动、等待等物理操作
   • 调用您已录制好的脚本

---

🎥 截图示例

---

🗓️ ClickZen 更新计划

ClickZen 目前已更新至 v1.6.3，整合了之前规划的窗口捕获、模拟器支持等大量功能。 后续将继续优化稳定性与插件系统。

---

【v1.6.3】✅ 当前版本

全能兼容与体验升级

• 全面模拟器支持：深度适配 MuMu、雷电、WSA 等主流模拟器
• 后台与遮挡运行：全新窗口捕获机制，不再依赖前台显示
• 精准录制：支持滑动手势录制，操作更丝滑
• 工具增强：优化的截屏拾取与坐标调试工具

更多历史更新详见 ROADMAP.md

---

👨‍💻 从源码运行（面向开发者）

想要参与开发或测试新功能？请参考文档中的「从源码运行」部分。 欢迎提交你的 Pull Request，让 ClickZen 变得更强大！

环境要求

• Windows 10/11 (64位)
• Python 3.8+
• Android 设备（需开启USB调试，小米设备需要开启USB调试安全模式）

安装步骤

1. 克隆项目

   git clone https://github.com/Exmeaning/ClickZen.git
   cd ClickZen

2. 安装依赖

   pip install -r requirements.txt

3. 运行程序

   python main.py

   首次运行时会自动下载 ADB 和 Scrcpy 工具。

---

🔧 技术栈

• GUI: PyQt6
• 设备通信: ADB (Android Debug Bridge)
• 投屏: Scrcpy
• 图像识别: OpenCV
• 截图: mss, win32api

---

📁 项目结构

ClickZen/
├── core/               # 核心功能模块
│   ├── adb_manager.py      # ADB管理
│   ├── auto_monitor.py     # 自动监控
│   ├── device_controller.py # 设备控制
│   └── ...
├── gui/                # GUI界面
│   ├── main_window.py      # 主窗口
│   └── monitor_dialog.py   # 监控配置
├── utils/              # 工具模块
├── main.py            # 程序入口
└── requirements.txt   # 依赖列表

---

🤝 贡献指南

非常欢迎您的贡献！请通过以下方式参与：

1. Fork 本项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

需要帮助的方面

• 🐛 Bug修复
• 📝 文档改进
• 🎨 UI优化
• ⚡ 性能优化
• 🌍 国际化支持

---

📄 开源协议

本项目采用 AGPL-v3 协议开源 - 查看 LICENSE 文件了解详情

🙏 致谢

• Scrcpy - 优秀的Android投屏工具
• Pure-python-adb - Python ADB客户端
• Klick'r - 项目功能主要参考的安卓客户端
• 所有贡献者和用户

📞 联系方式

• GitHub Issues: 提交问题
• Pull Requests: 贡献代码
• 个人邮箱：联系我

---

免责声明：本软件不提供任何形式的保证。作者不对使用本软件导致的任何损失负责。