ClickZen 2

基于 ADB 与 scrcpy 的 Android 自动化控制工具：应用内投屏、触控录制回放、图像识别自动化、变量与网络同步，支持真机、无线设备和主流模拟器。2.1 起内置 MCP 服务器，Claude、Cursor、VS Code 等 AI 助手可以直接查看画面、操作设备、运行自动化方案。

2.0 版本使用 C# / WinUI 3 完全重写，现已取代旧 Python 版成为主线。不兼容 1.x 的配置、方案和录制格式，请保留旧数据备份。旧版仅保留在历史标签与历史 Release 中，不再作为主线维护。

需要 Windows 桌面自动化？试试 ClickYen。

---

主要功能

• MCP 服务器：AI 可以截图、读取界面元素、点击、滑动、输入、启停应用，运行自动化方案、回放录制、读写变量、执行 adb shell。支持 Streamable HTTP 和 stdio 桥接，可按功能分组授权，每次调用都有记录。
• 应用内投屏：内置 scrcpy-server 协议客户端与 FFmpeg 解码，毫秒级触控注入，支持多指与连续滑动。
• 多设备：同时连接多台真机/模拟器，每台设备独立运行自动化方案，变量可跨设备共享。
• 模拟器助手：自动检测正在运行的 MuMu、雷电、夜神、逍遥、蓝叠、Android Studio 模拟器，从模拟器配置读出每个实例准确的 ADB 端口，一键连接、一键绑定窗口。
• 录制与回放：在投屏画面上直接操作即可录制，保存完整轨迹，按原节奏或变速回放。
• 图像识别自动化：方案 → 任务 → 规则（条件组 + 动作），支持模板匹配、颜色、变量表达式，可点击匹配到的位置。每个任务记住自己的屏幕方向，横屏、竖屏下都能取点和截取模板，运行时只执行与画面方向一致的任务。
• 模拟器窗口模式：直接捕获模拟器窗口画面（支持后台和被遮挡窗口），可一键自动定位画面区域。
• 变量网络同步：TCP 服务，让外部程序或其他实例读写自动化变量。
• 深色/浅色主题、中英双语界面。

系统要求

• Windows 10 1809（17763）或更高版本，x64
• Android 5.0+ 设备，开启 USB 调试（小米需额外开启「USB 调试（安全设置）」）

下载

前往 Releases：

• ClickZen-<版本>-win-x64.zip：解压即用，启动最快（推荐）。
• ClickZen-<版本>-win-x64.exe：单文件版。

adb、scrcpy-server 和 FFmpeg 均已随程序附带，无需另外安装。

快速上手

1. 启动 ClickZen，连接 USB 或无线 Android 设备；模拟器在设备页「检测到的模拟器」里点「连接」即可。
2. 在「投屏」页确认画面；模拟器也可在设备页一键绑定为窗口模式。
3. 在「录制」页操作并保存 .czrec，或在「自动化」页创建方案并运行。
4. 变量页可以启用变量同步服务；协议与示例见 变量同步协议。
5. 想让 AI 操作设备：在「MCP」页打开 MCP 服务器，复制对应客户端的配置，详见 MCP 文档。

界面预览

自动化工作台

录制与回放

设置

模拟器助手

打开设备页时，ClickZen 会检测正在运行的模拟器，并从模拟器自己的配置里读出每个实例的 ADB 端口（如 MuMu 第二个实例的 16416、蓝叠 Hyper-V 版每次启动都会变的端口），不再依赖固定的端口表。每个实例都可以一键连接，也可以一键绑定窗口：ClickZen 会自动定位窗口里的 Android 画面，并关联 ADB、读取分辨率，然后保存档案。支持列表、端口来源和常见问题见 模拟器助手。

模拟器窗口模式

在设备页选择「绑定模拟器窗口」，选择窗口并裁剪 Android 画面，关联 ADB 设备（可选），确认参考分辨率后保存档案；检测到的模拟器可以直接点「绑定窗口」一键完成。窗口画面采用 Windows.Graphics.Capture / PrintWindow 捕获；通过关联 ADB 可以使用 scrcpy、adb 或 Root 输入。没有关联 ADB 时使用窗口输入，受模拟器自身后台输入能力限制。档案会记住窗口匹配规则与裁剪范围。

变量同步

变量页管理变量声明、实时值、同步方向以及 TCP 服务端。设置端口并生成访问令牌，按需配置防火墙；令牌以 Windows DPAPI 加密保存。该协议不提供 TLS，不应直接暴露到公网。客户端示例、握手与消息格式见 变量同步协议。

MCP 服务器

ClickZen 内置 Model Context Protocol 服务器，AI 通过 ClickZen 已建立的设备连接工作。真机、无线设备、模拟器和模拟器窗口都可以直接使用。

1. 在「MCP」页打开 MCP 服务器。默认地址是 http://127.0.0.1:9528/mcp，只监听本机，需要令牌。

2. 选择客户端，点击 复制配置。以 Claude Code 为例：

   claude mcp add --transport http clickzen http://127.0.0.1:9528/mcp --header "Authorization: Bearer <令牌>"

   Claude Desktop、Codex 等只支持 stdio 的客户端使用 ClickZen.exe --mcp-stdio。这种方式不需要在配置中写令牌，ClickZen 未运行时会自动启动。

3. 对 AI 说：「截一张图，找到设置并打开 WLAN 页面」。

共 33 个工具，分为查看、操作、自动化、录制回放、变量、ADB Shell 六组，每组都能单独关闭，修改即时生效。AI 也能自己发现、连接和绑定模拟器（list_emulators / connect_emulator / bind_emulator_window）。页面会实时列出 AI 的每次调用。坐标约定、工具参考与安全说明见 MCP 文档。

从源码构建

前置条件：

• .NET 10 SDK
• Windows SDK 10.0.19041 或更高（或安装 Visual Studio 的「WinUI 应用程序开发」工作负载）

git clone https://github.com/Exmeaning/ClickZen.git
cd ClickZen
dotnet build ClickZen.slnx -c Release          # 首次构建会下载并校验 scrcpy 4.1 发布包
dotnet test --solution ClickZen.slnx -c Release
dotnet run --project src/ClickZen.App -c Release

冒烟测试（逐页导航、切换主题后自动退出，退出码 0 表示通过）：

$env:CLICKZEN_DATA_DIR = "$env:TEMP\cz-smoke"
& src\ClickZen.App\bin\Release\net10.0-windows10.0.19041.0\win-x64\ClickZen.exe --smoke --lang en-US

--lang zh-CN / --lang en-US 临时覆盖本次启动语言，不改用户设置。--page mirror 可直接导航到页面。冒烟不联网、不启动 ADB。

设备自检参数：--selftest-input、--selftest-recording、--selftest-automation、--selftest-window、--selftest-variables、--selftest-emulator。前四项需要在线 Android 设备或 Android Emulator；窗口自检需要可捕获的模拟器窗口；模拟器自检需要运行中且带窗口的 Android Studio 模拟器（检测 → 一键连接 → 一键绑定）。--selftest-mcp 不需要设备，会在随机端口上启动 MCP 服务，用官方 SDK 客户端分别经 HTTP 和 --mcp-stdio 桥接验证工具调用。每次自检应指定全新的 CLICKZEN_DATA_DIR；通过退出 0，失败非零。自检不会检查更新。

快捷键：F9 录制/停止，F10 回放/停止（录制页）；F5 运行/停止（自动化页）；Ctrl+S 保存、Ctrl+O 打开当前文档；Ctrl+Shift+S 保存当前设备截图；Ctrl+, 打开设置。设置即时保存，语言需重启，设备/自动化默认值用于下一次连接或新建方案。

项目结构

src/
  ClickZen.Core/      领域模型与纯逻辑（坐标、手势、自动化引擎、变量、序列化、模拟器目录与配置解析），不依赖 Windows
  ClickZen.Device/    ADB、scrcpy 协议、视频解码、输入注入、设备会话
  ClickZen.Platform/  Win32/WinRT：窗口枚举与窗口捕获、模拟器进程检测
  ClickZen.Vision/    OpenCV 模板匹配与图像编解码
  ClickZen.Mcp/       MCP 服务器：工具定义、Streamable HTTP 服务端（Kestrel）、stdio 桥接，只依赖 Core
  ClickZen.App/       WinUI 3 界面
tests/                xUnit v3 测试
build/                构建脚本（第三方组件下载与校验）

升级 scrcpy

scrcpy 客户端与 server 的协议必须版本一致。升级时需同时修改：

1. build/ThirdParty.targets 中的版本号与 SHA-256；
2. src/ClickZen.Device/Scrcpy/ScrcpyServerInfo.cs 中的 Version；
3. 对照新版 doc/develop.md 与 app/src/control_msg.c 检查协议变更。

界面文字

界面字符串维护在 src/ClickZen.App/Strings/strings.tsv（中英对照），修改后运行：

python src/ClickZen.App/Strings/gen_resw.py

测试会检查中英文键集合一致、所有 x:Uid 都有对应资源。

数据位置

内容	位置
设置、设备、模拟器档案、日志、崩溃报告	%LocalAppData%\ClickZen\
方案（.czscheme）、录制（.czrec）、截图	文档\ClickZen\

开源协议

AGPL-3.0，见 LICENSE。第三方组件见 THIRD-PARTY-NOTICES.md。

致谢

• scrcpy
• AdvancedSharpAdbClient
• Klick'r：自动化功能的主要参考
• MaaFramework、MAA、ALAS：模拟器进程、配置与端口规则的参考
• FFmpeg、OpenCV / OpenCvSharp
• Model Context Protocol C# SDK

免责声明

本软件不提供任何形式的保证，请合理合法使用。

联系：GitHub Issues · exmeaning@foxmail.com