GameScrcpy 把安卓手机的画面低延迟地投到电脑上，键位直接摆在游戏画面上，用键盘、鼠标和手柄操作。键位不够用时，可以用蓝图（节点和连线）或 TypeScript 给它们写逻辑，识图、找色、定时任务都能做。手机端服务、通信协议和电脑端全部是这一版重新写的，思路源自 scrcpy。
- 低延迟：显卡硬件解码，解码出的画面直接交给界面显示，不经过内存拷贝；支持 H.264、H.265、AV1。
- 声音：在电脑上播放手机的声音（Android 11 及以上）。
- 多种连接：USB 数据线；无线调试，用配对码或扫二维码配对；画面也可以走 WiFi 直连（UDP 加纠错，断线后自动续上）。
- 多台手机：每台一个窗口，或者放进宫格里一起看；可以同步操作，也能对选中的几台一起打开应用、安装 APK、发送文件或运行任务。
- 录像：录下画面、声音和你的操作，导出 MP4，也能拿来回放测试逻辑。
- 手机管理：文件管理、应用管理、状态浮层，把应用开在单独的虚拟屏幕上；还能测出从按键到画面变化的真实延迟。
- 手机伴侣：可选装的手机应用，在手机上显示光标和键位提示，提供输入法，扫码就能连上电脑。
- 在画面上摆键位：在投屏窗口里打开编辑器，把组件拖到游戏按钮上、配好按键，随时"试一试"。
- 组件库：点击、按住、长按、连发、滑动、双指缩放、WASD 轮盘、右键行走、视角、自由视角、技能、方向轮盘、多点同按、动作轮盘、临时光标，以及手柄摇杆与手柄视角。
- 按游戏自动切换：每个游戏一套方案，前台换了游戏就自动换方案；每台手机记住自己的选择。
- 手柄：Xbox、PlayStation、Switch Pro 手柄可以驱动方案里的键位；也可以把手柄直接交给游戏（实验性）。
- 分享：方案导出成文件，带逻辑和图片的方案可以整个打包。
- 蓝图就是代码：每个键位一个文件，节点与连线和 TypeScript 是同一份内容，两边随时切换；公共函数放进函数库，任何页都能调用。
- 识图与文字识别：在手机画面里找图、找色，用 Windows 自带的 OCR 识别文字。
- 任务：按时间表或手动运行的自动化流程。
- 调试：断点、单步、看变量；不连手机也能用录像回放测试。
- 命令行工具
gs：新建方案文件夹、类型检查、回放测试；脚本接口文档见sdk/docs。
- AI 小助手：在主窗口和各个编辑窗口的右下角，看得到你正在编辑的内容，可以帮你写蓝图、解释节点、排查连接问题。接你自己的 OpenAI 或 Anthropic 兼容接口与密钥，密钥存在 Windows 凭据管理器里。
- 本地 MCP 服务：让 Claude、Cursor 等 AI 工具直接读写方案和蓝图、运行测试、查看录像。
- USB 调试：默认方式，不需要额外硬件。
- AOA：手机把电脑当成一块 USB 触摸屏，不打开 USB 调试也能操作（实验性）。
- ESP32 触控盒：刷了 GameScrcpy 固件的 ESP32 开发板扮成手机的触摸屏、键盘、鼠标和手柄。ESP32-S3、S2、P4 走 USB；经典 ESP32、C3、C6 走蓝牙（实验性）。固件随程序附带，在程序里就能刷写，见
firmware/esp32。 - 采集卡：显示 HDMI 采集卡的画面，配合 AOA 或 ESP32 触控（实验性）。
- 扩展包
.gsext：主题、画面滤镜、键位方案与补丁、逻辑扩展、原生 DLL 扩展；原生扩展在单独的低权限进程里运行，安装时有安全检查。 - 整合包
.gsbundle：一次装好一组扩展；出了问题可以一步步找出是哪一个。 - 开发：C 接口头文件在
sdk/include，示例在examples。
- 深色优先的界面，可选浅色主题与六种强调色；命令面板（Ctrl+K）和可自定义的快捷键。
- 内置图文帮助（F1）与新手引导；中文与英文界面。
- 安装包与便携版两种发布形式。
| 设备页 | 投屏窗口 |
|---|---|
 |
 |
| 键位编辑器 | 蓝图 |
 |
 |
| 项目 | 要求 |
|---|---|
| 电脑 | Windows 10 / 11，64 位；建议使用支持 Direct3D 11 的显卡（没有可用显卡时由处理器解码和绘制，可能会卡） |
| 手机 | Android 9 或更高版本；声音与无线配对需要 Android 11 或更高版本 |
| 连接 | USB 数据线，或与电脑在同一局域网的 Wi-Fi |
从 Releases 下载其中一种：
- 安装包
GameScrcpy-<版本>-setup.exe：默认只为当前用户安装，不需要管理员权限；卸载时保留你的设置、方案和日志（在%APPDATA%\GameScrcpy）。 - 便携版
GameScrcpy-<版本>-portable.zip：解压后直接运行GameScrcpy.exe，数据存在旁边的data文件夹里。
两种都自带运行所需的一切（包括 adb），不用另装 Android SDK 或 VC++ 运行库。程序暂时没有代码签名，第一次运行时 Windows 可能提示"Windows 已保护你的电脑"：点"更多信息"，再点"仍要运行"。
- 在手机上打开"开发者选项"和"USB 调试"。第一次启动时的引导会按手机品牌告诉你怎么开。
- 用数据线连接手机，在手机上允许 USB 调试。
- 在"设备"页点"投屏"。
- 在投屏窗口的工具栏里打开"编辑键位"，把组件拖到游戏按钮上、配好按键。
- 按 F1 打开帮助，里面有投屏窗口、键位编辑器、方案、脚本与常见问题的图文说明。
| 内容 | 位置 |
|---|---|
| 使用帮助（与程序里 F1 打开的是同一份） | docs/README.md |
| 脚本接口 | sdk/docs |
| 架构概览 | docs/architecture.md |
| 通信协议 | protocol/SPEC.md |
| ESP32 固件 | firmware/esp32 |
| 从源码构建与参与开发 | CONTRIBUTING.md |
- 问题与建议：Issues。报告问题时附上程序里"设置 > 关于 > 导出诊断包"生成的文件，能更快找到原因。
- 安全问题请按 SECURITY.md 私下报告。
- QQ 交流群：762961615
GameScrcpy 免费、开源。如果它帮到了你，欢迎在爱发电支持后续开发。
GameScrcpy 以 Apache License 2.0 发布。
- scrcpy：安卓投屏的先驱，GameScrcpy 的思路源自它。
- QtScrcpy：GameScrcpy 1.x 的基础。
- 用到的第三方组件（Qt、FFmpeg、dav1d、SDL、libusb、QuickJS-ng、TypeScript、QWindowKit、nlohmann/json、miniz、QR Code generator、Lucide、doctest、tl::expected）及其版本与许可证见 third_party/README.md，程序里在"设置 > 关于 > 开源许可"。