帮助与支持
从第一次配对,到处理连接与传输问题,这里给出最短的解决路径。
应用市场
两端均已上架:macOS 版在 Mac App Store,HarmonyOS 版在华为应用市场。请通过下面的官方入口下载,两端需要配合使用。

鸿蒙版要装在手机上用手机相机扫这个码,直达华为应用市场。在电脑上打开商店页面是装不上的。
第一次无线连接
- 让手机与 Mac 连接同一个可信 Wi‑Fi。
- 打开 Mac 端灵犀互联,确认接收端正在运行。
- 在手机端点「扫码连接 Mac」,扫描 Mac 上的二维码。也可选「输入配对码」,填写 Mac 显示的地址和配对码。
- 连接成功后,双方都会显示对方设备名称和当前链路。要投屏,在手机首页「实时画面」中点「投屏」,按系统提示允许录屏。
在 Mac 上控制手机
请将两端灵犀互联都更新至 3.1.1。控制手机需要 Apple 芯片的 Mac、通过局域网连接的 HarmonyOS 手机,且手机保持解锁;仅通过 USB 连接时不能开启控制。
- 按上面的无线连接步骤完成配对、开启投屏,直到 Mac 出现手机画面。
- 在手机「设置 → 系统 → 开发者选项」中打开「无线调试」,记下页面显示的端口。若找不到开发者选项,HarmonyOS 5 及以上可在设置搜索「关于」,进入关于本机,快速连续点击「软件版本号」7 次,按系统提示开启并重启;重启后重新连接灵犀、恢复投屏,再查看当前端口。详见华为官方说明。
- 在 Mac 的灵犀互联 App 内打开「设置 → 控制手机」,填写手机当前的无线调试端口,无需另填 IP。这里的端口不是灵犀配对码。
- 回到 Mac 投屏画面,点「控制手机」。首次连接时,在手机上确认信任的是这台 Mac,选择「始终信任」。控制就绪后即可操作。
在投屏画面上用鼠标点击、长按、拖动,或用触控板双指滑动、滚轮翻页。点控制图标可打开面板,使用「返回」「主页」「停止控制」。触摸模式下右键返回;开启「键鼠共享(鼠标指针)」后,右键是手机右键。若显示「松手后执行」,请松手后等待手机响应。
推荐:在 Mac 上组字
在控制面板打开「在 Mac 上组字」,点一下投屏画面里的手机输入框,再用 Mac 输入法打字、选词;完成组字后,按回车把整条文字填入手机光标处。此方式无需蓝牙键盘配对,候选显示在 Mac 上。文字发送会覆盖手机剪贴板,且不会自动恢复原内容;填入文字不等于替你发送聊天消息。
可选:用手机输入法打字
两端打开蓝牙,手机放在 Mac 旁边。在灵犀「设置 → 控制手机」开启「启用键盘输入」,点「开始设置」,按提示核对两边配对码并确认,等「键盘输入已就绪」。若提示手动连接,到手机蓝牙的已配对设备中连接对应的 Mac 或 Lynsi Keyboard。设置通常只需一次,期间请跟随灵犀的进度提示。
键盘就绪后关闭「在 Mac 上组字」,点手机输入框即可直接打字,由手机输入法组词:空格或数字选词,单按 Shift 切中英文。看不到候选条时,在手机投屏通知里关闭「隐私保护」;每次投屏都需重新关闭。希望保留该保护时,可以使用「在 Mac 上组字」。
成功控制过一次的手机,后续投屏默认会自动开启控制;可在灵犀设置中关闭「投屏时自动开启控制」。手动停止控制后,本次投屏不再自动重开。免费版的投屏与视频播放共用每天 10 分钟,Pro 不限时长。
USB 连接
两端为 2.1.0 或更高版本时,可用数据线互传文件,无需 Wi-Fi、USB 调试或额外驱动。需要支持配件访问的 HarmonyOS API 14 或更高版本设备。
- 在 Mac 打开灵犀互联,保持正在接收,并在设置中开启 USB 直连。
- 用可传输数据的 USB 线连接手机,解锁并打开灵犀互联。
- 首次连接点「通过 USB 连接」,按系统提示允许访问配件,再输入 Mac 显示的配对码。
- 已配对设备可尝试自动恢复连接;重新插线时,系统可能要求再次允许配件访问。
若提示 USB 被占用,请在 DevEco Studio 或其他占用程序中结束调试;需要继续调试时,可先关闭 Mac 的 USB 直连。灵犀互联不会自动关闭其他程序。传输中断后需重新发送,不支持断点续传。
常见问题
灵犀互联支持哪些语言?
HarmonyOS 与 macOS 两端均支持简体中文和 English。默认跟随系统语言;如果希望灵犀互联单独使用另一种语言,可以在应用内的语言设置中切换。
无线连接为什么找不到 Mac?
确认两台设备位于同一局域网、Mac 端正在接收,并允许系统的本地网络访问。VPN、代理和访客网络可能阻止设备发现;仍无法发现时可直接重新扫描二维码。
投屏为什么没有立即开始?
Mac 只能发起投屏请求,不能替你授权。请在手机上确认系统录屏提示。部分银行、DRM 视频和受保护窗口会按系统规则隐藏内容。
能投屏,但「控制手机」不可用或连不上?
先确认两端均为 3.0.0 或更高版本、Mac 使用 Apple 芯片,手机通过局域网连接且正在投屏。手机需保持解锁并开启无线调试,Mac 设置里填写手机当前显示的调试端口。没有信任弹窗时,可关闭再开启无线调试,核对并更新端口后重试;灵犀配对码不能填作调试端口。
能点击手机画面,键盘却没有反应?
先点手机输入框。使用 Mac 输入法时,在控制面板打开「在 Mac 上组字」;使用手机输入法时,需先完成「启用键盘输入」设置,并关闭「在 Mac 上组字」。蓝牙键盘断开后,可在手机已配对设备中重新连接 Mac 或 Lynsi Keyboard。
能打中文,却看不到手机输入法候选词?
在手机的投屏通知里关闭「隐私保护」,候选条就会进入投屏画面;每次开始投屏都需要重新关闭。也可开启「在 Mac 上组字」,由 Mac 显示候选,无需修改手机的隐私保护设置。
如何停止控制?切到其他 App 会停止吗?
在 Mac 控制面板点「停止控制」,或停止投屏。手机锁屏后控制会停止,解锁后需重新开启。Mac 切到其他 App 时控制连接保持,回到灵犀即可继续;首次成功控制后的自动开启行为可在「设置 → 控制手机」中调整。
控制手机需要 Pro 吗?
控制手机没有单独的 Pro 门槛。它在投屏中使用,免费版投屏与视频播放共用每天 10 分钟;升级 Pro 后不限时长。
关闭 Mac 窗口后还会接收吗?
会。Mac 端接收器继续在菜单栏运行,收到文件时会保存到“下载/Handoff”。你可以从菜单栏重新打开主窗口,或明确选择“停止接收”。
为什么剪贴板没有自动同步?
检查两端的剪贴板开关和 HarmonyOS 剪贴板权限。即使自动同步关闭,手机端仍可点「发送剪贴板到 Mac」主动发送当前文字。
文件传输中断后会留下损坏文件吗?
不会把半文件显示为已完成。当前版本会丢弃不完整的暂存文件;断点续传尚未提供,重连后需要重新发送。
如何取消一台设备的信任?
三个操作的后果不同。Mac 上的「断开手机连接」只结束本次连接,配对仍然有效,在手机上重新连接即可恢复——它不会取消信任。要取消某一台手机的信任,在 Mac 窗口的「已配对设备」中对它点「解除配对」:它的凭据会被删除并立即断开,需要重新扫码才能再连;其他手机不受影响,但当前的配对二维码会随之更换。手机丢失时也用这一项。「解除全部配对…」会删除所有手机的凭据,每台手机都要重新扫码。手机上也可以点「解除配对」,删除手机本地保存的配对信息;Mac 的「已配对设备」中仍会列出这台手机,需要时再到 Mac 上解除。
鸿蒙手机和 Mac 能同步哪些数据?
文件、相册、剪贴板可以在两台设备之间流转,也可以把手机画面投到 Mac。这不是把整台手机备份到电脑。通讯录、短信、日历和通知不能同步。对照说明见Mac 与鸿蒙手机怎么同步数据。
能同步通讯录、短信或日历吗?
不能。灵犀互联不读取通讯录、短信、通话记录或日历,也不打算做这些。
3.1.1:诊断与帮助
投屏、控制或输入遇到问题时,先在 Mac 的「设置 → 诊断」生成本轮诊断,按实际操作结果逐项确认,再预览内容、复制摘要或保存文件。没有连接手机时也可以收集 Mac 记录。手机「设置 → 诊断与帮助」可复制本机摘要,并在本地测试点击与输入。
诊断不会自动上传,不包含输入文字或屏幕内容;测试文字不进入报告。保存后由你决定是否通过现有客服渠道发送。遇到间歇问题,请先保留出问题时的诊断,再重连或重启。
联系与反馈
遇到问题或有建议,可发送邮件至 lynsi@appsupport.mahui.me。为便于定位,请附上系统版本、设备型号、使用 Wi‑Fi 还是 USB、问题发生前的操作,以及不包含私人内容的状态信息。可附上你已预览的诊断摘要或文件;请不要发送剪贴板正文、私人文件或配对二维码。