跳转到内容

常见问题

当前网络访问不到中继,这时只有和 Mac 在同一网络中的设备能连接。可以在 Mac「设置 › 网络」里填一个能访问的自建中继(iroh-relay,https:// 开头),修改后已配对的手机仍能自动找到这台 Mac。

Mac 菜单栏提示「网络启动失败」时,点「重试」。

部分公共 WiFi(常见于酒店、机场)开启了客户端隔离,禁止接入同一网络的设备互相访问。此时手机和 Mac 虽然连着同一个 WiFi,也无法直连,只能经中继,速度和延迟都会受影响。

让手机关闭 WiFi、改用蜂窝网络(5G / 4G)通常就能直连;也可以把两端都接入不隔离的网络,例如手机热点、家用或办公 WiFi。

Mac 上移除了这台设备、重置了身份,或是改用扫码配对前留下的旧配置。在 Mac 菜单栏点 UULink 图标,选「配对新设备…」,用手机重新扫码。

Mac 和手机上的 UULink 版本不一致。把两端更新到同一版本后点「已更新,重试」。

手机提示「服务端身份已变更」

Section titled “手机提示「服务端身份已变更」”

Mac 端重装或重置了密钥。先核对手机上显示的新指纹与 Mac「设置 › 网络」中的服务端指纹一致,再点「信任新身份」,或者直接重新扫码配对。

「设置 › Agent」里某个 AI 助手显示「未检测到」

Section titled “「设置 › Agent」里某个 AI 助手显示「未检测到」”

UULink 找不到它的可执行文件。在「设置 › Agent」中选中它,按其中显示的安装方式安装并登录(也可以参考支持的 AI 助手),然后点「重新检测」;装在非标准位置时,点「选择…」手动指定可执行文件。

各助手的进程继承登录 shell 的环境变量(~/.zshrc 等里 export 的)。只在函数或别名里设置的变量(比如代理)不会带过去,需要在「设置 › Agent」中选中对应的助手,在「环境变量」里添加;API Key 也填在这里。手机上也可以在 Mac 的「信息」页里点对应的助手,在「环境变量」里改。

菜单栏提示「未检测到可用的 AI 助手」

Section titled “菜单栏提示「未检测到可用的 AI 助手」”

这台 Mac 上没有检测到任何可用的 AI 助手。点提示旁的「安装方法」打开「设置 › Agent」,选中要用的助手,按其中显示的方式安装并登录,然后点「重新检测」。只要有一个助手可用就不会再提示;只使用部分助手时,其余显示「未检测到」不影响使用。

iOS 后台唤醒时机由系统决定;在多任务界面上滑关闭 App 后,系统不会再唤醒它。可以在手机「设置 › 通知 › 后台刷新记录」查看。

仅适用于 Claude Code:长驻的 claude 进程空闲 10 分钟后会退出(可以配置),下一条消息会自动 --resume,对使用没有影响。

Section titled “在终端里用 claude --resume 看不到 UULink 中的会话”

这是 Claude Code 本身的行为,会话没有丢失。

UULink 以 Claude Code SDK 的方式启动 claude,会话记录(~/.claude/projects/ 下的 jsonl 文件)中标记为 SDK 会话。Claude Code 在终端里运行 claude --resume 时,会话列表不显示 SDK 会话,因此在 UULink 中开始的会话不会出现在列表里。以上为 Claude Code 2.1.310 的实测结果,Claude Code 更新后可能变化。

在终端里续接这些会话,有两种方式:

  • 按会话 ID 续接(推荐):在 iPhone 或 iPad 上长按会话列表中的这个会话,选「拷贝会话 ID」;开启了通用剪贴板时,可以直接在 Mac 上粘贴。然后在终端里进入会话所在的文件夹(使用 worktree 的会话为对应的 worktree 文件夹),运行:

    终端窗口
    claude --resume <会话 ID>

    按 ID 续接不受上述限制,会完整打开这个会话。

  • 在会话列表中显示 SDK 会话:运行时带上环境变量,让 Claude Code 以 SDK 的身份运行:

    终端窗口
    CLAUDE_CODE_ENTRYPOINT=sdk-cli claude --resume

    列表中会同时显示在 UULink 中开始的会话。这样启动的 Claude Code 不同于平常的终端运行方式,仅建议在查找会话时使用,不建议设为默认。

反过来,在终端里开始的 Claude Code 会话,在手机上可以正常查看和续接。

不会。消息先写入手机上的发件箱再投递,重连后自动按顺序重发;服务端按消息 ID 去重,同一条消息只执行一次。Mac 重启时执行到一半的任务不会自动重跑,会提示你确认后再重发。

  • 确认 Mac 上 UULink 在运行、Mac 没有睡眠。
  • 在 Mac「设置 › 设备」的「已配对的 iPhone」中确认这台手机还在列表里;不在的话重新扫码配对。
  • Mac 菜单栏提示「未连接中继」时,只有同一网络中的设备能连接,见 显示「未连接中继」。
  • 同一网络却连得慢或只能经中继时,检查 iPhone「设置 › 隐私与安全性 › 本地网络」中是否允许了 UULink。

Mac 菜单栏的「设备」一栏会列出所有已配对的设备:在线的显示直连还是经中继、延迟;离线的显示上次在线时间。

在 Mac「设置 › 设备」的「已配对的 iPhone」中点这台设备旁的「移除」,这台设备会立即断开,要再使用需重新扫码配对。

UULink 运行期间默认会阻止 Mac 闲置睡眠,手机随时都能连上;不需要时可以在 Mac 的「设置 › 通用」里关掉「防止 Mac 休眠」。合上笔记本盖子或手动让 Mac 睡眠后仍会断开,需要长时间远程使用时,请让 Mac 开着盖子并接通电源。

检测到了 AI 助手,但任务执行失败

Section titled “检测到了 AI 助手,但任务执行失败”

会话里会显示助手返回的错误原因。常见的是未登录或 API Key 无效:先在 Mac 的终端里运行一次该助手(如 claude、codex、agent、qodercli),确认已经登录并能正常对话;DeepSeek Harness、Pi 等使用 API Key 的助手,检查「设置 › Agent」中的环境变量。然后在手机上重新发送。

开启「控制桌面」后截不了屏、点不动

Section titled “开启「控制桌面」后截不了屏、点不动”

控制桌面经系统「屏幕共享」实现:在「设置 › 控制桌面」里确认「屏幕共享」显示「已开启」,未开启时点旁边的按钮,到「系统设置 › 通用 › 共享」中打开「屏幕共享」。解锁和填写密码还需要授予「辅助功能」。首次控制时需在 iPhone 上输入这台 Mac 的登录密码,验证通过后才会保存;之后更改了登录密码时,UULink 会自动清除旧密码并在下次控制时重新请你输入,也可以在「控制桌面」里点「清除已保存的密码」。在系统设置里更改后若仍不行,重新打开一次 UULink。详见控制 Mac 桌面。

Mac 端同时支持 Apple Silicon 和 Intel 处理器的 Mac(macOS 14 及以上),下载同一个安装包即可。手机端支持 iPhone 和 iPad(同一个 App,iPadOS 18 及以上),暂不支持安卓。

不是。UULink 是独立开发的工具,与 Anthropic、OpenAI、Google 等 AI 助手的出品方均没有关系。Claude 和 Claude Code 是 Anthropic 的商标,其他产品名称归各自的所有者。

中继是谁的,能看到我的内容吗

Section titled “中继是谁的,能看到我的内容吗”

默认使用 n0(iroh 的开发团队)的公共中继,只在手机和 Mac 无法直连时转发加密后的数据,看不到内容。也可以在 Mac「设置 › 网络」里改用自建中继。

不需要。手机和 Mac 靠扫码配对互相认识,不需要注册 UULink 或其他任何服务的账号。

免费版和订阅版有什么区别,怎么收费

Section titled “免费版和订阅版有什么区别,怎么收费”

免费版可以连 1 台 Mac,文件夹数量不限,直连加速、断线不丢消息、端到端加密、在手机上接着聊终端里的会话都包含在内。订阅版额外解锁:连多台 Mac、推送通知、把图片和文件网页发到手机、随消息发图片、灵动岛实时状态。

UULink 不对任何 AI 助手额外收费。各助手使用你自己的账号、订阅或 API Key,相关费用由对应的服务商收取。

订阅 ¥18 / 月 或 ¥180 / 年(相当于省 2 个月),由 Apple 通过 App Store 收费;管理或取消到 iPhone「设置 › Apple 账户 › 订阅」。完整对比见首页价格。

请准备以下信息,便于定位问题:

  • Mac 日志:「设置 › 关于 › 诊断 › 日志」点「在 Finder 中显示」(~/Library/Logs/UULink/uulink.log)。
  • 两端的版本号(Mac:「设置 › 关于」;手机:「设置 › 关于」)。
  • 手机「设置 › 通知 › 后台刷新记录」的截图(与通知有关的问题)。