snug README

README проекта с github.com/zephyr4123/snug. Одним файлом markdown: README.md.

简体中文 · English

Snug 图标

Snug

Make UU Remote Native on Any Device

为 UU远程 打造 · 远程 Mac 的显示与触控增强
每台设备专属屏幕 · 原生触屏手势 · App 资源库

最新版本 Apple Silicon · Intel macOS 14+ 已公证 许可证 MIT

下载 · 原生体验 · 多设备 · App 资源库 · 截图 · 对比 · 安装 · 使用 · 限制 · 开发


原理图:Snug 在 Mac 上为手机、平板、电脑分别建立屏幕,经 UU远程 推送至各设备并铺满画面

▶ 观看高清演示视频

承接自 aoyamashou/UUyc-companion(UU远程伴侣,作者 AoyamaShou,MIT 许可),完整保留原作者的版权声明与提交历史。2.0 起以手机屏为核心重新设计,2.6 起扩展至平板与电脑。

📥 下载

Snug 图标

Snug for macOS 最新版本
通用安装包,支持 Apple 芯片与 Intel,适用于 macOS 14 及更新版本
已签名并经 Apple 公证,拖入「应用程序」即可使用


渠道 说明 下载
国内源 腾讯云 CDN 加速,中国大陆推荐 Snug.dmg
GitHub Releases 附更新说明、校验文件与历史版本 前往下载

两个渠道的安装包完全相同。Snug 仅需安装于被控 Mac,控制端只需 UU远程。

Windows 被控端:参见 社区移植。

✨ 每台设备,原生体验

UU远程 将桌面整体等比缩放至控制端,比例不符即留黑边,文字与控件随之缩小。Snug 为每台控制端新增一块比例匹配的屏幕:手机、平板按移动端尺度铺满,适配触屏操作;电脑与本机分辨率一致,全屏无黑边。

手机:竖屏 · 横屏

UU远程 原版:整块桌面缩小显示于手机屏幕 Snug:窗口铺满全屏,字号放大
同一内容 · 左:UU远程 原版 · 右:Snug

iPhone 横屏:网页完整呈现,右侧为 UU远程 工具栏
横屏:宽幅页面完整呈现

原生手势

UU远程 移动端沿用触控板的手势逻辑;Snug 在手机屏与平板屏上按触屏习惯重新映射。

触屏操作 UU远程 原版 Snug
单指滑动 鼠标拖拽,易误选文字 页面滚动,松手保留惯性
长按后拖动 鼠标拖拽 拖选文字
长按松开 普通点击 右键菜单

实机演示:打开窗口、弹出键盘输入命令、恢复会话、单指滚动、返回列表 长按调出右键菜单
单指滚动 · 长按调出右键菜单

平板:铺满 · 原生手势

平板远程 Mac 以往多需外接键盘与触控板;Snug 平板屏按机型铺满,触控即用。

iPad 横屏:VS Code 铺满全屏,字号放大 iPad 竖屏:Safari 铺满全屏
iPad · 横屏 · 竖屏

电脑:铺满 · 无黑边

Snug 电脑屏按控制端分辨率建立,画面与本机一致。

电脑远程去黑边源自 Snug 的前身 UUyc-companion(UU远程伴侣,作者 AoyamaShou)。Snug 沿用这一能力,改为新增屏幕:原有屏幕保持不变,主屏默认不变。

MacBook Air 上的 UU远程 原版:4K 屏画面上下留黑边,文字缩小 MacBook Air 上的 Snug 电脑屏:同一窗口铺满,文字与本机一致
同一窗口 · 左:UU远程 原版 · 右:Snug 电脑屏

🧩 一台 Mac,所有设备

自定义屏幕

每块屏幕的设备、型号、方向与名字均可自定义,最多 4 块,分别开关。

项目 说明
设备 手机、平板或电脑;比例与屏上功能随类别而定,见下表
型号 机型库选择,或填写分辨率、比例(如 1080×2400、9×20);更换即时生效,无需重连
方向 竖屏或横屏,添加时选定
名字 显示于 UU远程 屏幕列表,便于识别

添加屏幕:选定设备、方向、型号与名字
添加屏幕:设备 · 方向 · 型号 · 名字

屏幕 比例与尺寸 屏上功能
手机 · 竖 / 横 按机型计算,避让 UU远程 工具栏 App 资源库、指示条、原生手势、字号放大
平板 · 横 / 竖 按机型计算,字号略大于原生 同上;横屏为左右两栏
电脑 · 横 与控制端分辨率一致;带刘海的 MacBook 避让顶部,像素级对应 无附加内容,等同普通显示器

屏幕列表

设置「屏幕」页集中管理全部屏幕;远程时,在 UU远程 屏幕列表中选择所需屏幕。

Snug 设置「屏幕」页:远程中的屏幕列表与设为主屏 UU远程 屏幕菜单:四块 Snug 屏幕
左:Snug 设置中的屏幕列表 · 右:远程时 UU远程 中的屏幕列表

型号页:当前机型、自定义分辨率与按品牌排列的机型
型号:按品牌排列,支持自定义分辨率

🗂 App 资源库

手机屏与平板屏的首页,在移动端管理 Mac 上的 App:查找、打开、切换、新建、关闭与退出,无需回到电脑前。电脑屏的 App 资源库从菜单栏打开。

运行中:手机屏上窗口所属的 App 置于最上方 全部:本机全部 App 的图标网格 搜索:输入 bwl 找到备忘录
运行中 · 全部 · 拼音首字母搜索

iPhone 横屏:App 资源库左栏为 App,右栏为所选 App 的窗口 iPad 横屏:App 资源库左栏为 App,右栏为所选 App 的窗口
左右两栏 · 横屏手机 · 平板

电脑屏 App 资源库:标注窗口所在屏幕,一键移至此屏,移入的窗口一键还原
电脑屏:从菜单栏打开 App 资源库

操作 方式
打开窗口 轻点窗口,即铺满全屏;轻点 App,打开其最近使用的窗口
新建窗口 轻点 App 卡片上的「新建窗口」,新窗口按屏宽打开
关闭窗口 轻点窗口右侧的关闭按钮,再次轻点确认
退出 App 轻点 App 卡片上的「退出」,再次轻点确认;10 秒未退出时可强制退出
存储未保存内容 关闭或退出时的「是否存储」对话框显示于当前屏幕,可在移动端直接选择
退出这块屏 轻点右上角「退出这块屏」并确认:窗口归位、屏幕移除,本次远程不再显示,下次远程恢复(断开后 15 秒内重连仍视为本次)

与 iPhone 一致的操作

iPhone Snug 手机屏、平板屏
App 资源库 首页:查找、打开与管理 Mac 上的 App
主屏幕指示条 底部指示条,返回 App 资源库
左上角「‹ 返回」 左上角「‹ App 名」,返回当前窗口

适配任意 App

Snug 呈现的是 Mac 上的原生窗口,适用于任意 App,不绑定特定 AI:终端中的 Claude Code、ChatGPT 桌面版中的 Codex,体验与电脑前一致。

部分 App 设有最小宽度,无法缩至屏宽。Snug 先按屏宽铺开窗口;App 无法再缩窄时,将屏幕切换至恰好容纳的分辨率,再次铺满。

ChatGPT 桌面版中的 Codex 铺满 Snug 手机屏 设有最小宽度的系统设置完整铺满手机屏
左:ChatGPT 桌面版中的 Codex(文件链接已打码)· 右:设有最小宽度的系统设置,仍完整铺满

📸 截图

适用于手机屏与平板屏。在设置「触控」页开启「截图」后,底部指示条左侧显示相机键;轻点即截取铺满屏幕的窗口并存入 Mac 剪贴板,可粘贴至任意 App。截取内容为窗口原画,不受远程画质压缩影响。

截图后左下角显示缩略图 裁剪:拖动四角或四边收窄选区
左:截图后显示缩略图 · 右:轻点进入裁剪

🆚 与其他方案的对比

方案 局限 Snug
AI 助手的远程控制 仅限自家 AI 的会话 适用于任意终端与 App,参见 适配任意 App
UU远程 自带终端 独立于本机终端,断开后进程仍驻留 直接使用 Mac 现有的终端窗口
显示器欺骗器、虚拟屏工具 单一比例,换设备即留黑边;无触屏手势与窗口管理 每台设备专属屏幕;手机、平板配原生手势与 App 资源库

📦 安装

系统要求:被控端 macOS 14 及更新版本,已安装 UU远程;控制端为任意安装 UU远程 的手机、平板或电脑。

下载安装(推荐)

  1. 从「下载」一节获取安装包(中国大陆推荐国内源)
  2. 将 Snug 拖入「应用程序」并打开
  3. 按欢迎页提示授予辅助功能权限(macOS 27 起名为「设备控制和数据访问」)

此后 Snug 常驻菜单栏,无需额外操作;再次打开 Snug 即显示设置。

更新:启动时自动检查,一键更新,保留设置与授权;亦可在设置「通用」页手动检查或切换更新源。2.1.0 之前的版本需手动下载替换。

欢迎页:用法与辅助功能授权 设置「屏幕」页:屏幕列表与设为主屏 设置「通用」页:开机启动、权限与软件更新

欢迎页 · 设置:屏幕 · 设置:通用

从源码构建(需要 Xcode 与 Swift 6)

git clone https://github.com/zephyr4123/snug.git
cd snug && scripts/snug install
从「UU远程伴侣」迁移

两者同时运行会相互干扰,Snug 启动时提示退出旧版。若曾在旧版中启用守护助手,请另行执行:

launchctl bootout gui/$(id -u)/com.corndog.uudisplay.watchdog-agent
rm ~/Library/LaunchAgents/com.corndog.uudisplay.watchdog-agent.plist

🧭 使用方式

  1. 添加屏幕(按需):默认仅一块竖屏「Snug 手机屏」;平板、电脑或横屏手机,在设置「屏幕」页添加并选定型号
  2. 切换屏幕:连接后,在 UU远程 屏幕列表中选择对应屏幕
  3. 选择 App 或窗口:手机屏、平板屏上,在 App 资源库中轻点 App 或窗口,即铺满全屏;电脑屏从菜单栏打开 App 资源库
  4. 切换窗口:轻点底部指示条返回 App 资源库;另选窗口时,原窗口自动归位
  5. 结束远程:窗口归位、字号复原,Snug 屏幕随之移除;设过主屏的,主屏与排布一并还原

💡 建议将 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   # 构建、安装并打开

🧹 卸载

  1. 在菜单栏退出 Snug(窗口先行还原)
  2. 将「应用程序」中的 Snug 移至废纸篓
  3. 可选:删除设置与日志 rm -rf ~/Library/Application\ Support/Snug ~/Library/Logs/Snug.log*
  4. 可选:在系统设置「辅助功能」中移除 Snug;开启过截图的,一并在「录屏与系统录音」中移除

🌐 社区移植

平台 项目 维护者 说明
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远程 致以诚挚的敬意。

谨此致谢。

亦感谢以下项目与贡献者:

⭐ Star 趋势

Snug 的 GitHub Star 数随时间的变化

📄 许可证

MIT © 2026 AoyamaShou,© 2026 zephyr4123

snug (zephyr4123/snug)

Ищем в базе…

912 ·GitHub
Что это такое?Snug — это приложение для macOS, которое делает UU Remote удобнее и привычнее, когда вы управляете Mac с телефона, планшета или ПК. Поверх UU Remote оно добавляет виртуальные экраны, подобранные под устройство, и жесты касания.
Это самостоятельное приложение для удалённого доступа или дополнение к UU Remote?Это дополнение, а не отдельный клиент удалённого доступа. Snug создаёт на вашем Mac дополнительный виртуальный экран для каждого устройства, и при подключении вы выбираете этот экран в списке экранов UU Remote.
Что мне нужно, кроме самого Mac?macOS 14 или новее и UU Remote на обеих сторонах. Snug устанавливается только на Mac, которым вы управляете, а телефону, планшету или ПК нужен только UU Remote. В macOS 27 и новее разрешение «Универсальный доступ» называется «управление устройством и доступ к данным».
В чём подвох?Оно опирается на недокументированные интерфейсы macOS, поэтому крупное обновление macOS может его сломать. UU Remote позволяет управлять только одним устройством за раз, в списке на стороне Mac максимум пять экранов, включая собственный экран Mac, а экраны не поворачиваются вместе с устройством, поэтому используйте два экрана: для портретной и для альбомной ориентации.
Работает ли оно и на Mac с Intel?Да. Универсальный пакет поддерживает Mac как на Apple silicon, так и на Intel, на macOS 14 и новее.
Работает ли оно с программными агентами для кода, такими как Claude Code или десктопное приложение Codex?Да. Работает любое окно Mac, включая терминал с Claude Code или десктопное приложение Codex в ChatGPT. Приложения с минимальной шириной окна подгоняются: экран переключается на ближайшее подходящее разрешение.
Можно ли увеличить текст на телефоне?Да. Terminal, iTerm2, VS Code, Cursor и Zed автоматически увеличивают шрифт на экране телефона, и это запоминается для каждого приложения. Окна, которые остаются мелкими, можно масштабировать щипком.
Что такое библиотека приложений на телефоне?Это домашний экран телефона и планшета. Он показывает запущенные приложения с их окнами, сетку всех установленных приложений и поиск, который понимает инициалы пиньинь, так что «bwl» находит «Notes».
Откуда взялся этот проект?Он создан на основе UUyc-companion от AoyamaShou по лицензии MIT, с сохранением его уведомлений об авторских правах и истории коммитов. Версия 2.0 переработала его под экран телефона, а 2.6 расширила поддержку на планшеты и компьютеры.
Какие есть похожие проекты?opendisplay, sill, rooms, Sapphire, OpenYoink, Loop, tinycast, KiwiDesk
Автор
zephyr4123
Размер
34 MB
Звёзды
912
Возраст
5 д
Коммиты · 90 дней