安装
- Mac:macOS 14 及以上,Apple Silicon 或 Intel 处理器
- iPhone / iPad:iOS 18 / iPadOS 18 及以上
- Mac 上已安装并登录至少一个支持的 AI 助手,例如 Claude Code、Codex、Cursor
暂不支持安卓手机。不需要注册任何账号。
使用时 Mac 要保持开机。UULink 默认会阻止 Mac 闲置睡眠,但合上笔记本盖子后仍会睡眠,这时手机连不上。
UULink 不会替你下载或安装 AI 助手。各助手的安装命令、登录方式和官网见支持的 AI 助手;未检测到的助手,Mac「设置 › Agent」中也会显示安装方式和官网链接。
1. 安装 Mac 端
Section titled “1. 安装 Mac 端”在 Mac 上下载最新的 UULink,文件名是 UULink-<版本>.dmg。打开后把 UULink(UULink.app)拖进「应用程序」再启动。首次启动会弹出设置向导:
- 「AI 助手」:自动检测 Mac 上已安装的 Claude Code、Codex、opencode、Pi,任一可用即可继续。都没有检测到时,向导会列出 Claude Code、Codex、opencode 的介绍、安装命令和官网,在终端安装其中任意一个并登录后点「重新检测」;其他助手可点「+」添加并查看安装方式,或指定可执行文件。其余助手之后可在「设置 › Agent」中添加,见支持的 AI 助手。
- 「系统权限」:项目放在「文稿」「桌面」「下载」或外置磁盘时,按提示授予访问权限;放在其他位置(如
~/Projects)可以跳过。 - 「控制桌面」:可选,之后也可以在「设置 › 控制桌面」中开启,见控制 Mac 桌面。
- 「配对手机」:显示配对二维码,先不要关,装好手机端后用它配对。
之后 UULink 常驻菜单栏,再配对其他设备时点菜单栏里的 UULink 图标,选「配对新设备…」(⌘ P)。可以在「设置 › 通用」中开启「登录时打开 UULink」,并在「系统设置 › 通用 › 登录项」中允许 UULink。
2. 安装 iPhone 端
Section titled “2. 安装 iPhone 端”在 iPhone 的 App Store 搜索「UULink」安装,或打开 App Store 下载页。
安装后打开 UULink,点「扫描二维码添加 Mac」,扫描 Mac 上的配对二维码(也可以用系统相机扫)。手机没有相机时,在 Mac 的配对窗口点「拷贝链接」,通过「通用剪贴板」等方式发到手机后选「或粘贴配对链接」。配对码 10 分钟内有效、只能用一次。
首次连接时 iOS 会询问是否允许访问本地网络。允许后同一网络中的手机和 Mac 直接连接,速度更快;拒绝也能用,只是改为经中继连接。
App 内嵌 iroh 节点,不需要安装其他 App,也不占用系统 VPN。
需要任务完成通知时,在 App 的「设置 › 通知」点「开启通知」;之前拒绝过的,点「前往“设置”开启」。
3. 开始使用
Section titled “3. 开始使用”- 添加项目:浏览 Mac 上的目录,选中项目文件夹。
- 选择或新建 git worktree。
- 新建会话并选择使用的 AI 助手,或打开已有会话(包括在 Mac 终端里直接跑的会话,DeepSeek Harness 和 Antigravity 除外)。