- Автор
- zephyr4123
- Размер
- 34 MB
- Звёзды
- 912
- Обновлён
- КоммитNov 18Релизv2.6.2Nov 18
- Возраст
- 5 д
- Коммиты · 90 дней
README проекта с github.com/zephyr4123/snug. Одним файлом markdown: README.md.
简体中文 · English
Make UU Remote Native on Any Device
为 UU远程 打造 · 远程 Mac 的显示与触控增强
每台设备专属屏幕 · 原生触屏手势 · App 资源库
下载 · 原生体验 · 多设备 · App 资源库 · 截图 · 对比 · 安装 · 使用 · 限制 · 开发
▶ 观看高清演示视频
承接自 aoyamashou/UUyc-companion(UU远程伴侣,作者 AoyamaShou,MIT 许可),完整保留原作者的版权声明与提交历史。2.0 起以手机屏为核心重新设计,2.6 起扩展至平板与电脑。
Snug for macOS
通用安装包,支持 Apple 芯片与 Intel,适用于 macOS 14 及更新版本
已签名并经 Apple 公证,拖入「应用程序」即可使用
| 渠道 | 说明 | 下载 |
|---|---|---|
| 国内源 | 腾讯云 CDN 加速,中国大陆推荐 | Snug.dmg |
| GitHub Releases | 附更新说明、校验文件与历史版本 | 前往下载 |
两个渠道的安装包完全相同。Snug 仅需安装于被控 Mac,控制端只需 UU远程。
Windows 被控端:参见 社区移植。
UU远程 将桌面整体等比缩放至控制端,比例不符即留黑边,文字与控件随之缩小。Snug 为每台控制端新增一块比例匹配的屏幕:手机、平板按移动端尺度铺满,适配触屏操作;电脑与本机分辨率一致,全屏无黑边。

同一内容 · 左:UU远程 原版 · 右:Snug

横屏:宽幅页面完整呈现
UU远程 移动端沿用触控板的手势逻辑;Snug 在手机屏与平板屏上按触屏习惯重新映射。
| 触屏操作 | UU远程 原版 | Snug |
|---|---|---|
| 单指滑动 | 鼠标拖拽,易误选文字 | 页面滚动,松手保留惯性 |
| 长按后拖动 | 鼠标拖拽 | 拖选文字 |
| 长按松开 | 普通点击 | 右键菜单 |

单指滚动 · 长按调出右键菜单
平板远程 Mac 以往多需外接键盘与触控板;Snug 平板屏按机型铺满,触控即用。

iPad · 横屏 · 竖屏
Snug 电脑屏按控制端分辨率建立,画面与本机一致。
电脑远程去黑边源自 Snug 的前身 UUyc-companion(UU远程伴侣,作者 AoyamaShou)。Snug 沿用这一能力,改为新增屏幕:原有屏幕保持不变,主屏默认不变。

同一窗口 · 左:UU远程 原版 · 右:Snug 电脑屏
每块屏幕的设备、型号、方向与名字均可自定义,最多 4 块,分别开关。
| 项目 | 说明 |
|---|---|
| 设备 | 手机、平板或电脑;比例与屏上功能随类别而定,见下表 |
| 型号 | 机型库选择,或填写分辨率、比例(如 1080×2400、9×20);更换即时生效,无需重连 |
| 方向 | 竖屏或横屏,添加时选定 |
| 名字 | 显示于 UU远程 屏幕列表,便于识别 |

添加屏幕:设备 · 方向 · 型号 · 名字
| 屏幕 | 比例与尺寸 | 屏上功能 |
|---|---|---|
| 手机 · 竖 / 横 | 按机型计算,避让 UU远程 工具栏 | App 资源库、指示条、原生手势、字号放大 |
| 平板 · 横 / 竖 | 按机型计算,字号略大于原生 | 同上;横屏为左右两栏 |
| 电脑 · 横 | 与控制端分辨率一致;带刘海的 MacBook 避让顶部,像素级对应 | 无附加内容,等同普通显示器 |
设置「屏幕」页集中管理全部屏幕;远程时,在 UU远程 屏幕列表中选择所需屏幕。

左:Snug 设置中的屏幕列表 · 右:远程时 UU远程 中的屏幕列表

型号:按品牌排列,支持自定义分辨率
手机屏与平板屏的首页,在移动端管理 Mac 上的 App:查找、打开、切换、新建、关闭与退出,无需回到电脑前。电脑屏的 App 资源库从菜单栏打开。

运行中 · 全部 · 拼音首字母搜索

左右两栏 · 横屏手机 · 平板

电脑屏:从菜单栏打开 App 资源库
| 操作 | 方式 |
|---|---|
| 打开窗口 | 轻点窗口,即铺满全屏;轻点 App,打开其最近使用的窗口 |
| 新建窗口 | 轻点 App 卡片上的「新建窗口」,新窗口按屏宽打开 |
| 关闭窗口 | 轻点窗口右侧的关闭按钮,再次轻点确认 |
| 退出 App | 轻点 App 卡片上的「退出」,再次轻点确认;10 秒未退出时可强制退出 |
| 存储未保存内容 | 关闭或退出时的「是否存储」对话框显示于当前屏幕,可在移动端直接选择 |
| 退出这块屏 | 轻点右上角「退出这块屏」并确认:窗口归位、屏幕移除,本次远程不再显示,下次远程恢复(断开后 15 秒内重连仍视为本次) |
| iPhone | Snug 手机屏、平板屏 |
|---|---|
| App 资源库 | 首页:查找、打开与管理 Mac 上的 App |
| 主屏幕指示条 | 底部指示条,返回 App 资源库 |
| 左上角「‹ 返回」 | 左上角「‹ App 名」,返回当前窗口 |
Snug 呈现的是 Mac 上的原生窗口,适用于任意 App,不绑定特定 AI:终端中的 Claude Code、ChatGPT 桌面版中的 Codex,体验与电脑前一致。
部分 App 设有最小宽度,无法缩至屏宽。Snug 先按屏宽铺开窗口;App 无法再缩窄时,将屏幕切换至恰好容纳的分辨率,再次铺满。

左:ChatGPT 桌面版中的 Codex(文件链接已打码)· 右:设有最小宽度的系统设置,仍完整铺满
适用于手机屏与平板屏。在设置「触控」页开启「截图」后,底部指示条左侧显示相机键;轻点即截取铺满屏幕的窗口并存入 Mac 剪贴板,可粘贴至任意 App。截取内容为窗口原画,不受远程画质压缩影响。

左:截图后显示缩略图 · 右:轻点进入裁剪
| 方案 | 局限 | Snug |
|---|---|---|
| AI 助手的远程控制 | 仅限自家 AI 的会话 | 适用于任意终端与 App,参见 适配任意 App |
| UU远程 自带终端 | 独立于本机终端,断开后进程仍驻留 | 直接使用 Mac 现有的终端窗口 |
| 显示器欺骗器、虚拟屏工具 | 单一比例,换设备即留黑边;无触屏手势与窗口管理 | 每台设备专属屏幕;手机、平板配原生手势与 App 资源库 |
系统要求:被控端 macOS 14 及更新版本,已安装 UU远程;控制端为任意安装 UU远程 的手机、平板或电脑。
下载安装(推荐)
此后 Snug 常驻菜单栏,无需额外操作;再次打开 Snug 即显示设置。
更新:启动时自动检查,一键更新,保留设置与授权;亦可在设置「通用」页手动检查或切换更新源。2.1.0 之前的版本需手动下载替换。
欢迎页 · 设置:屏幕 · 设置:通用
从源码构建(需要 Xcode 与 Swift 6)
git clone https://github.com/zephyr4123/snug.git
cd snug && scripts/snug install
两者同时运行会相互干扰,Snug 启动时提示退出旧版。若曾在旧版中启用守护助手,请另行执行:
launchctl bootout gui/$(id -u)/com.corndog.uudisplay.watchdog-agent
rm ~/Library/LaunchAgents/com.corndog.uudisplay.watchdog-agent.plist
💡 建议将 UU远程 画质调至最高:画质较低时画面模糊,平板上尤为明显。
| 限制 | 说明 |
|---|---|
| 依赖 macOS 未公开接口 | 系统大版本更新后可能失效 |
| UU远程 一次仅允许一台设备控制 | 多块屏幕轮换使用,不支持多台设备同时远程 |
| UU远程 每次连接从主屏开始 | 需在屏幕列表中手动选择一次;设为主屏后,连接直接进入该屏 |
| UU远程 Mac 端最多列出 5 块屏幕 | 含 Mac 自身屏幕;以 Mac 远程时,可先关闭暂不使用的 Snug 屏幕 |
| 屏幕不随设备自动横竖切换 | 横竖兼用时各设一块,转向时在 UU远程 中切换 |
| 非网易官方软件 | 与 UU远程 及其开发商无关;UU远程 更新后部分功能可能受影响 |
| 远程结束后 Snug 屏幕偶尔未移除 | 推流停止未被系统日志记录时出现,菜单栏仍显示「远程中」;在设置中关闭已开启的屏幕即可还原 |
| VS Code、Cursor 窗口在移动端以快捷键或菜单关闭后,字号可能被保留 | 远程结束后重新打开时若字号偏大,按 ⌘- 复原(关闭时屏上提示级数);开启手势时轻点窗口关闭按钮,或在 App 资源库中关闭,则不受影响 |
| 未接显示器的 Mac 无法切回原屏幕 | macOS 仅在无任何显示器时提供默认屏幕,Snug 屏幕出现后即撤下;在 App 资源库右上角退出这块屏,或在设置中关闭,即恢复原画面 |
各项限制的成因见 工作原理。
scripts/snug check # 构建并运行全部测试
scripts/snug install # 构建、安装并打开
rm -rf ~/Library/Application\ Support/Snug ~/Library/Logs/Snug.log*| 平台 | 项目 | 维护者 | 说明 |
|---|---|---|---|
| Windows 10 / 11 | snug-win | nicocart | 基于 Snug 2.5.0 移植,C# / .NET 8 / WPF |
| Windows x64 | Snug for Windows | rizetngan | 基于 Snug 2.5.0 移植,C# / .NET 10 / WPF;社区预览版,尚未发布正式版本 |
社区移植由各自作者独立开发、发布与维护。本仓库仅开发与测试 macOS 版,未测试上述移植版本;使用问题请至对应仓库反馈。
首先,谨向 UU远程 致以诚挚的敬意。
谨此致谢。
亦感谢以下项目与贡献者:
CGVirtualDisplay 接口声明MIT © 2026 AoyamaShou,© 2026 zephyr4123