项目功能
无缝 Android 镜像与控制工作流可将 Windows 桌面变成 Android 设备的实时操作界面。它会在可调整大小的窗口中显示设备屏幕，并将鼠标、键盘和导航输入实时传回 Android。
该项目将桌面控制台、所需依赖项和手机端配套组件整合为便携式安装包。你无需分别查找和安装各项依赖，Android 配套组件也不需要手动从应用商店安装。
首次连接时，桌面工具会将一个小型代理推送到设备，建立视频和输入通道，并打开镜像显示。同一连接还可在视频流之外传输剪贴板数据、音频和文件。
主要功能
- 实时屏幕镜像：在低延迟桌面窗口中查看 Android 动画、滚动内容、应用和视频。
- 键盘和鼠标控制：将点击转换为轻触、将拖动转换为滑动，并将实体键盘输入传送为 Android 文本输入。
- 便携式设置：将完整工具包保存在一个文件夹中，并在兼容的 Windows 计算机之间移动。
- 有线和无线运行：先使用 USB 完成设置并确保连接稳定，建立信任后再通过本地网络进行无线镜像。
- 灵活显示：调整窗口大小，使用竖屏或横屏方向，旋转显示画面，或进入全屏模式。
- 捕获和共享工具：截取屏幕、录制会话、共享剪贴板内容并传输文件。
- 多设备支持：为每台已连接设备打开独立的镜像窗口。
- 干净退出：关闭镜像或断开数据线后，手机端配套组件会停止运行，不会留下需要手动卸载的 Android 应用。
要求
开始前请准备以下内容：
- Windows 10 或 Windows 11
- PowerShell 5.1 或更高版本
- 有效的网络连接
- 一部 Android 手机或平板电脑
- 用于首次连接、支持数据传输的 USB 数据线
无需管理员权限。受支持的 Windows 版本已内置 PowerShell 5.1。
安装并准备工具包
1. 打开项目设置页面
使用项目的 PowerShell 命令按钮页面访问设置流程。请按照页面显示的命令或下载说明操作，不要单独组装镜像组件。
2. 保持软件包完整
下载或准备好的文件夹就是安装内容。请将其中的文件放在一起，以便控制台找到依赖项和 Android 端代理。由于该设置具有便携性，你还可以将文件夹复制到可移动存储设备，并在另一台兼容的 Windows 计算机上启动。
3. 谨慎处理安全提示
安全软件可能会检查或标记用于创建本地设备连接的陌生预构建工具。在允许任何操作前，请确认文件来自项目页面。README 声明该软件包仅用于提供所述镜像工作流，但你仍应遵循所在组织的安全政策。
在 Android 上启用 USB 调试
桌面工具需要 Android 的调试接口来完成首次配对，并启动临时配套组件。
- 打开 Android 设备的设置。
- 启用开发者选项。具体路径因设备和 Android 版本而异。
- 打开开发者选项并启用USB 调试。
- 首次连接时保持设备处于唤醒和解锁状态。
- 使用支持数据传输的 USB 数据线将设备直接连接到计算机。
仅支持充电的数据线无法传输所需的设备数据。如果手机可以充电但未被检测到，请尝试更换数据线或 USB 端口。
开始首次镜像会话
- 启动工具包：从便携式文件夹中启动桌面控制台。
- 连接设备：通过 USB 连接已解锁的 Android 设备。
- 授权计算机：当 Android 显示 USB 调试提示时，请查看提示并点击允许。如果信任这台计算机，可以选择记住它。
- 等待镜像启动：工具会传输小型配套代理，协商视频流，并在桌面窗口中打开设备屏幕。
- 测试输入：点击 Android 控件，在窗口中拖动，并在文本字段中输入内容，以确认桌面输入能够传达到设备。
首次握手要求实体设备处于唤醒和解锁状态。开始流式传输后，手机屏幕可能会变暗，但桌面输入仍可正常工作。锁定的 Android 设备在解锁前会拒绝普通轻触操作。
基本桌面控制
镜像窗口的行为类似于可交互的第二屏幕，而不是一组静态屏幕截图。常见交互会自然映射为 Android 操作：
- 点击：使用鼠标点击项目。
- 滑动：按住鼠标并向所需移动方向拖动。
- 滚动：在 Android 界面支持滚动的位置使用鼠标滚轮。
- 输入：选择 Android 文本字段，然后使用 Windows 键盘。
- 导航：使用工具映射的硬件按键操作在 Android 中导航。
示例：回复消息
- 在镜像窗口中点击消息应用。
- 选择一个对话。
- 点击消息输入框。
- 使用桌面键盘输入。
- 点击 Android 发送控件。
示例：测试应用界面
- 从镜像设备打开应用。
- 调整镜像窗口大小，使其适合放在开发或测试工具旁边。
- 使用点击和拖动测试点按及手势。
- 检查竖屏和横屏布局时旋转视图。
- 录制会话或截取屏幕截图，用于演示或错误报告。
调整显示和串流
你可以调整镜像窗口大小以适应工作区、旋转虚拟显示，或在演示时切换到全屏模式。当连接状况需要在图像质量和响应速度之间进行不同取舍时，还可以调整比特率和分辨率。
如果画面变得模糊或卡顿，请尝试以下步骤：
- 使用直接 USB 连接，而不是未供电的集线器。
- 避免使用异常长的 USB 延长线。
- 关闭大型传输任务或其他占用大量带宽的任务。
- 如果连接仍受限，请降低串流分辨率或比特率。
- 如果无线会话不稳定，请切换回有线模式。
带宽有限时，编码器可能会暂时降低图像细节以提升响应速度。直接且稳定的连接通常能提供最清晰、最稳定的输出。
使用无线镜像
无线模式可以让镜像通过局域网保持运行。请先通过初始有线设置建立信任关系，因为首次运行授权需要使用数据线，而且有线连接能为配套设置提供最可靠的路径。
- 成功完成一次 USB 镜像会话。
- 确保 Windows 计算机和 Android 设备可以通过局域网通信。
- 建立信任关系后，使用工具包的无线模式。
- 如果网络状况导致延迟或卡顿，请保留 USB 作为备用连接。
在房间内移动或进行无束缚演示时，无线镜像更加方便。当你需要最高稳定性或一致的视频质量时，USB 仍然是更好的选择。
传输文件、共享文本和录制会话
此工作流程不仅用于查看手机屏幕。它可以在计算机与 Android 设备之间传输剪贴板内容和文件，而截图与录制功能则有助于记录会话。
- 共享剪贴板：在 Android 和 Windows 之间复制文本，无需重新输入。
- 文件传输：在桌面和设备之间拖放受支持的文件。
- 屏幕截图：捕获镜像显示内容的清晰图像。
- 录制：保存演示、测试或可复现错误的视频。
具体控件可能取决于打包后的界面。请使用工具包显示的控件，不要假设存在未记录的命令行选项。
使用多个 Android 设备
该项目支持同时镜像多个已连接设备。每台设备都会在独立窗口中打开，方便你比较布局，或演示跨多部手机的操作流程。
- 在每台设备上启用 USB 调试。
- 使用可靠的数据线连接每台设备。
- 分别在每个 Android 屏幕上批准授权提示。
- 将生成的镜像窗口并排排列。
这种设置适合检查不同屏幕尺寸上的界面，或比较不同代设备之间的行为。
高级提示
关键工作优先使用 USB
对于长时间录制、演示或重视稳定延迟的测试，请使用直接有线连接。无线模式更加灵活，但性能取决于局域网状况。
保留便携文件夹
不要将可执行文件与其捆绑依赖分开。如果要将设置迁移到另一台计算机或 USB 驱动器，请复制完整文件夹。
仅信任已知计算机
Android 调试授权会让计算机获得对设备的重要访问权限。只批准由你控制的计算机，并在适当时从 Android 的开发者设置中撤销已保存的调试授权。
设置期间保持设备解锁
首次握手和授权需要访问实体手机屏幕。如果之后输入似乎停止，请检查 Android 是否已锁定设备。
建立可重复的测试布局
将可调整大小的镜像窗口放在日志、文档或开发工具旁边。对于重复会话，请重新连接之前已信任的设备，并重复使用最适合工作流程的显示布局。
断开连接并清理
会话完成后，关闭镜像窗口或拔出设备。工具包会向临时手机端配套程序发送关闭信号并结束会话，无需你卸载 Android 应用。
下次会话时，重新连接已信任的设备并再次启动工具包。README 说明该工作流程会保留偏好设置，因此熟悉的会话可以减少设置步骤后继续使用。
许可证
本项目采用 MIT 许可证发布。您可以查看、修改、使用和再分发本项目，也可以将其作为其他工作流的一部分，但必须保留原始版权和许可声明。本软件按“现状”提供，不附带任何保证。
结语
这套便携式工作流无需手动收集各个依赖项，即可在 Windows 中以统一方式镜像和控制 Android 设备。启用 USB 调试并批准首次连接后，您可以使用键盘和鼠标操作 Android、调整显示效果、传输数据、录制会话、使用无线模式，并在同一桌面上管理多个设备窗口。