Step 2：连接第一台设备
画质与设备兼容
大屏右侧「画质」新增编码尺寸对齐：默认使用自动适配，遇到特定设备画面异常可尝试 8 或 16 px。仅调整当前大屏；编码器会依据自身能力约束实际视频尺寸，因此可能略小于所选分辨率上限。切换失败会尝试恢复原配置。降低画质有助于减轻传输和解码负担，但不能保证消除所有延迟。
iOS USB 接入
Windows 点击「安装 / 修复 Apple 设备支持」后，会依次显示组件检测、实际下载百分比、文件与签名校验、等待安装向导。安装前的 Apple 服务检测不依赖采集驱动检测。请完成 Windows 管理员确认和 Apple 许可向导；向导被遮挡时可从任务栏切回。下载失败可重试，或点「手动下载 Apple 官方组件」，下载同一官方 MSI 后双击安装，再回客户端点「重新检测」。下载完成不代表已安装成功。
若缺少 Apple 设备支持或其服务未运行，先完成上述安装或修复；页面不会先等待全机设备与采集驱动扫描。Apple 服务就绪后，再检查当前设备的采集驱动；页面提示需要时，点击「安装此设备的采集驱动」并确认管理员授权。
USB 与无线投屏是独立通道。在此面板选择「USB 有线」后，切到 Android 再切回 iPhone / iPad，不会因此启动无线接收端；选择「无线投屏」才会启用该通道。切换引导页不会自动停止已经启用的无线接收服务。
macOS 使用系统自带的 Apple USB 能力，不需要安装 Windows 的 Apple 设备支持组件或采集驱动。客户端需随包提供 USB 采集与控制辅助程序，用户无需另装 Python。若提示缺少辅助程序，请重新安装完整客户端，不要按 Windows 步骤安装驱动。
Windows 组件检测会检查采集驱动服务、文件完整性和签名，以及 Apple 父驱动和设备过滤驱动状态；“已就绪”不代替实际出帧验收。连接中拔线会提示设备断开，主动停止不会作为连接失败提示。关闭后重新启用操控时，客户端等待旧控制进程释放后再建立新通道。
USB 页面位于「添加设备 → iPhone / iPad → USB 有线」。使用数据线连接并在手机上信任电脑，再选择设备开始投屏；收到画面后从设备卡片打开大屏。USB 操控与无线蓝牙操控分开管理，控制入口仍在大屏右侧。
Windows 的 USB 连接步骤中会单独提示：首次安装或重新安装组件后，若已点「信任」但下方仍未出现设备，请重新插拔 USB 数据线，再点「重新检测」。 请先按通用步骤解锁手机并信任电脑；若设备已出现在下方列表，则无需额外插拔。
macOS USB 点击、拖动及电脑键盘输入已在连接的手机上验证，不代表所有设备均已兼容。支持英文按键、Shift、退格和 Enter；中文仍使用手机输入法。无需为验证此功能先升级手机系统。
Windows 的 USB 页面提供 Apple 设备支持组件与当前设备采集驱动的安装入口。安装需要管理员确认，Apple 许可协议由用户确认，无需关闭系统安全功能。启用操控时会检查开发者模式与开发支持组件，缺失时尝试自动准备。投屏与操控均使用 USB，不自动切换到 Wi-Fi 或蓝牙；操控可用性取决于手机系统和设备检测结果，不支持操控时仍可观看投屏。
Windows 的采集驱动已安装、但重开后找不到 USB 画面时，可在 USB 页面点击「修复 USB 连接」。请先停止 USB 投屏；确认系统管理员提示后，客户端只重连所选 iPhone，不重启共享 Apple 服务、不更换驱动。若仍未恢复，请重新插拔数据线并解锁手机。
点击未投屏的 USB 卡片后，会立即显示「正在连接」。连接期间重复点击不会重复发起请求；失败提示会合并，连接结束后可再次点击重试。设备被检测为断开或主动停止投屏时，本次连接等待会结束，不必等到首帧超时；重新接好后可以重试。
连接与操控要点
- Android 支持 USB 与局域网连接，同一手机可以由多个客户端连接；请避免同时拖动。开启局域网连接后，确认无线画面正常再拔掉数据线。实际流畅度取决于网络和设备性能。
- 聚合大屏及群控只统计可用 Android 设备。iPhone / iPad 保留独立投屏和设备管理，不参与聚合或群控。
- Windows、macOS 可通过蓝牙直接操控 iPhone，电脑需具备兼容的蓝牙能力。按客户端图文引导开启手机「辅助功能 › 缩放」，保持正常画面大小，再验证点击；Linux 暂不支持 iOS 操控。这不是 USB 操控。
插件页面与自定义插件
「全部设备」旁的「插件」打开独立页面，不再弹出插件目录。可搜索插件、管理内置微信增强，或拖入 .zip / .vmosplugin 本地插件包。安装后默认停用，核对权限后启用；启停和卸载会同步到已打开的大屏，不影响设备投屏。
插件中心分为「浏览插件」「用户插件」「开发文档」。详情页提供权限与兼容说明，微信增强设置与话术管理保留内置实现。「开发文档」可离线搜索，覆盖接入模型、清单、设备与应用 Hook、工具栏、右侧面板、权限动作、生命周期、错误与验收；提供应用便笺、指定应用工具、文字填入三个可安装示例。当前接口采用声明式配置，不执行脚本；前台应用识别和文字填入仅支持 Android，且不自动发送。未开放在线商店、自动更新或插件持久化存储。完整格式见自定义插件开发。 插件卡片可查看详情、启用或停用；只有用户安装的插件提供卸载。 插件目前仅面向 Android 设备。客户端界面与内置插件随语言设置显示；用户安装的插件内容按作者提供的原文展示，客户端不自动翻译。
微信快捷回复
顶部「插件」可启用微信增强并管理话术，无需另外安装。Android 手机前台打开微信后，大屏右侧显示「快捷回复」，面板向右展开，不遮挡投屏。
- 话术支持新增、编辑、删除、复制、导入导出和按标题搜索；仅保存标题与正文，不提供分组或收藏。
- 独立大屏中，「填入」用所选话术替换输入框全部内容、不发送；「发送」先替换全部内容，再发送所选话术。原有草稿会被替换，不会与话术拼接。聚合大屏仍按当前光标位置填入，不支持快捷发送。
- 发送快捷键可选 Enter 或 Ctrl/Cmd+Enter，发送当前输入框内容，不替换或填入话术；默认保持原行为，Shift+Enter 换行，输入法选字不发送。
- 操作期间请勿切换聊天。按聊天标题和输入栏控件定位，支持浅色、深色竖屏聊天；无法确认当前聊天或发送按钮时不执行发送，不自动重发。横屏、分屏、改包或多开容器及非中文微信界面尚未完整验证，不能保证所有第三方主题均可使用。
- 首次打开会显示准备状态。空回车、没有发送按钮或页面变化时静默结束；话术替换完成但尚未点击发送时，不弹“结果未知”提醒，请查看微信输入框。正常发送不弹结果提醒，以微信画面为准。写入或发送控制结果未知、连接异常时仍会提示，请先核对，勿重复点击。话术保存在本机，导出文件包含正文，请妥善保管。
三类设备走三条不同的接入路径。先确认设备类型，再看对应的一节。
安卓手机同时连接 USB 和局域网会显示两张卡片，两边都可打开大屏操控，息屏状态同步。批量操作识别到同一实体设备时只执行一次，不会因为双连接而重复操作。
- 一根能传数据的线
- 手机开 USB 调试
- 手机上点一次「允许」
- 设备 IP 地址
- 与电脑同一网络
- 端口通常是 5555
- Windows / macOS / Linux
- 与电脑连同一个 Wi-Fi
- 操控支持 Windows / macOS
三条路径都从左侧栏「添加设备」进入：Android 与 iPhone / iPad 分两个标签，Android 下再选连接方式，选中后下方展示对应的手机端步骤。
A. Android 真机 —— USB 连接
安卓真机首次接入只能使用这条路径。
- 开启开发者选项：手机「设置 → 关于手机 → 版本号」，连点 7 次。
- 打开 USB 调试：回设置进「开发者选项」，打开「USB 调试」。
各家还有额外开关，缺一项就连不上
小米 / Redmi：USB 调试（安全设置）、「仅充电」模式下允许 ADB 调试 · vivo：USB 模拟点击。 逐项对照见 开启 USB 调试（各品牌）。
- 连接数据线：用数据线连到电脑 · 纯充电线不传数据，无反应时先更换线缆。 插上后下拉通知栏 · USB 用途改为「传输文件」，停在「仅充电」时电脑认不到手机。
- 手机上授权：弹出「允许 USB 调试吗？」→ 勾选「一律允许」→ 点「允许」。
- 等待：设备自动出现在设备墙，无需手动添加。
转为无线连接
USB 连接成功后，在设备卡片上点右键 →「添加局域网连接」。之后拔掉数据线，同一网络内继续可用。
B. Android 云机 —— 局域网连接
- 确认设备与电脑在同一个局域网。
- 左侧栏点「添加设备」→ Android → 「局域网连接」。
- 在输入框里填地址，一行一个，点「加入」进入待添加列表。只填 IP 时按 5555 端口处理：
192.168.1.112:5555
192.168.1.113:5555- 点「添加」，画面随即出现在设备墙。添加前可在左下角指定分组。
不确定地址时，用下方「网络发现」填入网段后点「扫描」（留空则只监听自动发现），勾选发现的设备一并添加：
真机填 IP 连不上
安卓真机默认关闭网络连接。先按 A 用数据线连接一次，再在设备卡片上点右键 →「添加局域网连接」转为无线。
连接过的地址会自动保存，下次启动自动重连，无需重复添加。
C. iPhone / iPad —— 屏幕镜像
若手机本机流畅、电脑画面却迟到，请参见 iPhone 排查说明。调整指针速度不能解决视频延迟。
在支持 iOS 操控的环境中，独立大屏与聚合格共用「iOS 操控指针速度」。先比较手机上的实际指针移动，再判断是速度不合适还是画面延迟。
iPhone / iPad 可独立投屏和管理，不加入聚合大屏、Android 群控或批量命令。观看不需要蓝牙；Windows、macOS 的独立大屏可点击「启用操控」并按图文引导配对，Linux 仅观看。蓝牙断开后保留投屏画面。关闭大屏不停止设备墙缩略图。未投屏时仍可选中、重命名、移动分组或移除记录；自动锁定请在手机设置。
投屏由 iPhone 发起，不在电脑上添加。手机上不安装任何应用。
- 电脑上点「添加设备」→「iPhone / iPad」标签，记下框里这台电脑的名称（可点「复制」）。
- iPhone 从屏幕右上角向下轻扫，打开控制中心。
- 轻点「屏幕镜像」（控制中心底部那排圆形控件里）。
- 在弹出的设备列表中选第 1 步那个名称。
- 画面自动出现在设备墙。
| 事实 | 说明 |
|---|---|
| 平台 | Windows、macOS、Linux 均支持投屏 |
| 数量 | 同一时刻只能有一台 iPhone 投屏 |
| 操控 | Windows / macOS · 需先配对蓝牙 · 点画面右侧「操控」 · 配对图示 |
| 网络 | iPhone 需与这台电脑连同一个 Wi-Fi |
iPhone 上看不到这台电脑
先确认两端在同一个 Wi-Fi；再看本页接收端状态是否为「接收端已就绪」，不是则点「重试」。
免数据线接入：无线调试（Android 11 及以上）
Android 11 及以上的安卓真机可用配对码接入，无需数据线：
- 手机「设置 → 关于手机 → 版本号」连点 7 次，开启开发者选项。
- 「开发者选项 → 无线调试」打开开关。
- 点手机上的「使用配对码配对设备」，会显示一个 6 位配对码和一行 IP 地址与端口。
- 电脑上「添加设备」→ Android →「无线调试」，把这两样填进「配对地址」和「配对码」，点「配对」。
- 配对成功后自动连接，之后手机重启也会自动重连。
配对地址通常无需手填
软件会自动发现配对地址。跨网段或路由器限制时自动发现不可用，按第 3 步填入手机上显示的地址。
下一步：上手三件事