选择并安装 Mac 版

确认 Apple 芯片或 Intel 芯片

点击 Mac 左上角 Apple 菜单，打开“关于本机”。如果“芯片”显示 M1、M2、M3 或 M4，下载 Apple 芯片版；如果“处理器”显示 Intel，下载 Intel 版。

macOS Apple 芯片版 1.0.0M1 / M2 / M3 / M4 · DMG ↓ macOS Intel 芯片版 1.0.0Intel x86_64 · DMG ↓

打开 DMG 并拖入“应用程序”

双击下载的 DMG，将“卓码大师PC端.app”拖到“Applications / 应用程序”快捷方式，然后从“应用程序”文件夹启动。

macOS 阻止首次打开时

当前 1.0.0 使用临时签名，尚未完成 Apple 公证。如果系统阻止打开，可在 Finder 中按住 Control 点击应用并选择“打开”；或进入“系统设置 → 隐私与安全性”，核对应用名称后选择仍要打开。请只使用本页官方地址下载的 DMG。

启动桌面端连接服务

打开“连接服务”标签页

桌面端启动后会自动尝试开启 TCP 服务。页面会显示连接二维码、本机 IP、监听端口和服务状态。默认端口是 9876。

正常状态应显示“服务运行中（端口 9876）”和“等待客户端连接”。如果服务停止，点击“开启服务”；修改端口后点击“应用端口”。

macOS 防火墙提示

首次监听局域网连接时，macOS 可能询问是否允许传入连接。要使用 Wi-Fi 模式，请允许“卓码大师PC端”接收本地网络连接。

确认手机与 Mac 在同一网络

手机和 Mac 应连接同一个路由器的 Wi-Fi；2.4 GHz 与 5 GHz 通常可以互通，但取决于路由器设置。
不要使用启用了客户端隔离的访客 Wi-Fi；这类网络会阻止设备之间互相访问。
如果 Mac 同时连接 VPN 或多个网络，点击桌面端“刷新 IP”，并优先使用与手机同网段的局域网地址。

整个连接发生在本地局域网中，不需要卓码大师账号，也不经过卓码大师服务器。

备用：手动输入 IP 与端口

桌面二维码不方便扫描时，可以使用手动连接：

在手机主界面点击右上角连接图标。
选择“Wi-Fi 连接”。
把桌面端“连接设置”中显示的 IP 填入“IP 地址”。
端口填写桌面端监听端口；未修改时为 9876。
点击“连接”，等待右上角图标变为闭合状态。

应用会保存上次成功使用的 IP 和端口；设置页开启“自动恢复上次连接”后，下次启动会尝试恢复。

开始扫码输入

先在 Mac 上放置光标

单击表格单元格、浏览器输入框或其他需要接收内容的位置，再使用手机扫码。桌面端收到内容后会把文本输入当前光标，并在“扫码记录”标签页保存本地记录。

如果 macOS 提示辅助功能权限，请在“系统设置 → 隐私与安全性 → 辅助功能”中允许卓码大师。该权限用于模拟键盘输入；相机画面仍只在手机端处理。

中文与特殊字符

Wi-Fi 传输的是完整扫码文本，比蓝牙 HID 更适合包含中文或无法用标准键盘映射的内容。

故障排查

二维码为空或没有生成

确认桌面端服务已经启动并检测到本机 IP。点击“刷新 IP”；如果仍显示“未找到 IP”，先检查 Mac 的网络连接。

手机提示连接失败

核对手机与 Mac 是否在同一局域网，确认 IP 和端口与桌面端一致，并允许 macOS 防火墙接收连接。访客网络、公司网络的设备隔离也可能阻止互联。

连接成功但没有输入到光标

先点击可编辑文本框，再检查 macOS 的辅助功能权限。桌面端连接状态能确认网络是否正常；网络正常但无法输入，通常是系统输入权限问题。

Mac 有多个 IP

桌面端会选择可用的本地 IPv4 地址。使用 VPN、虚拟机或多网卡时，可暂时关闭不需要的网络接口后点击“刷新 IP”，再重新扫码。

同一局域网，连接 macOS 桌面端。