OpenYoink README

The project's README from github.com/MuQY1818/OpenYoink. As one markdown file: README.md.

OpenYoink 图标

OpenYoink

随手一拖,先放一下。

原生 macOS 拖拽暂存架。把文件、文本、图片和链接暂存在屏幕边缘或 Mac 刘海, 切换到目标位置后再继续拖。


最新版本 下载量 macOS 15+ Swift 6 MIT 许可证

下载 · 官网 · 使用文档 · English


OpenYoink — 随手一拖,先放一下

[!NOTE] 当前稳定版 v1.6.6 默认不再让文件拖拽靠近顶部时展开灵动岛,避免干扰浏览器标签页操作;右侧暂存架仍可由真实文件靠近屏幕边缘时展开,也可在设置中单独开启顶部触发。完整教程见使用文档。

它解决什么问题

在 Finder、浏览器、邮件等应用之间搬东西时,目标窗口往往不在眼前。OpenYoink 给内容一个临时落脚点:先拖进屏幕边缘或 Mac 刘海,切换窗口后再拖到目标位置。

OpenYoink 常驻菜单栏,不显示 Dock 图标。需要时出现,用完后收起。

核心亮点

安装

系统要求:macOS 15 Sequoia 或更高版本。 Release 构建同时面向 Apple Silicon 与 Intel Mac。

Homebrew(推荐)

brew install --cask muqy1818/tap/openyoink

Homebrew cask 下载对应版本的 GitHub Release DMG,并在安装后移除这一应用的隔离属性,通常不会出现 Gatekeeper 拦截。该步骤不改变安装包签名,也不等同于 Apple 公证。安装后可由 Sparkle 检查后续更新。

手动安装

  1. 从 GitHub Releases 下载最新 DMG。
  2. 打开 DMG,将 OpenYoink 拖入 Applications。
  3. 首次启动若被 macOS 拦截,在 Finder 中右键 OpenYoink 并选择“打开”,或前往 系统设置 → 隐私与安全性 允许打开。

[!NOTE] GitHub Releases 中的免费社区构建使用 ad-hoc 签名,未经过 Apple 公证,因此首次手动安装可能触发系统提示。Sparkle EdDSA 签名保护的是更新包完整性,不能替代首次下载校验或 Apple 公证。

仍然无法打开?

仅在确认应用来自上面的 OpenYoink 官方 Release 地址后使用。可以先运行 shasum -a 256 OpenYoink-VERSION.dmg(把 VERSION 换成实际版本号),并与同版本 Homebrew cask 中的 sha256 比对。下面的命令会明确绕过这一个应用的 Gatekeeper 隔离检查:

xattr -dr com.apple.quarantine /Applications/OpenYoink.app

快速上手

操作 方式
显示 / 隐藏 ⌘⇧Space、菜单栏菜单,或单击屏幕边缘的拉环
添加内容 拖到暂存架或边缘拉环上
移动而非引用 按住 ⌘ 拖入文件或文件夹
暂存剪贴板 连按两次 ⌘⇧Space
Quick Look 选中卡片后按 Space,或双击卡片
多选 按住 ⌘ 点选,或在空白处拖动框选
移除 悬停后点 ×、按 Delete,或右键菜单
调整位置 沿屏幕边缘拖动拉环,或在设置中选择位置
开启 / 关闭 Island 设置 → 通用 → OpenYoink Island

支持的内容

内容 OpenYoink 的处理方式
文件与文件夹 默认保留对原位置的 sandbox bookmark,不复制到暂存架
纯文本与链接 直接记录在暂存架数据中
图片、HTML 与 RTF 在应用沙箱的托管目录中物化为文件
联系人、日历事件与邮件 来源应用提供可读数据时,物化为 .vcf、.ics、.eml

拖出普通文件时,OpenYoink 提供文件 URL 与 Chromium 兼容的文件名表示,兼容 Finder、Safari 和常见 Chromium 浏览器上传区域;托管移动项目使用可确认落盘的 file promise,交付成功后才离架。是否接受最终仍由目标应用或网站决定。

文件安全与生命周期

隐私与设计

从源码构建

开发环境需要 macOS 15+ 与 Xcode 26+。

git clone https://github.com/MuQY1818/OpenYoink.git
cd OpenYoink

xcodebuild \
  -project Open-Yoink.xcodeproj \
  -scheme OpenYoink \
  -destination 'platform=macOS' \
  build

xcodebuild \
  -project Open-Yoink.xcodeproj \
  -scheme OpenYoink \
  -destination 'platform=macOS' \
  test \
  -only-testing:OpenYoinkTests

本地构建无需设置 DEVELOPMENT_TEAM。项目使用 SwiftUI 渲染界面,以 AppKit 管理窗口、拖放和全局事件;测试覆盖持久化、拖入拖出、快捷键、触发器和布局等核心行为。

维护者可通过 Scripts/make-release.sh 生成 Developer ID + 公证的正式构建,或显式使用 --adhoc 生成免费社区构建。脚本不会在签名失败时静默降级发布模式。

参与项目

欢迎提交 Issue 和 Pull Request。

Roadmap

Roadmap 表示探索方向,不承诺具体版本或时间;优先级会根据稳定性和用户反馈调整。

致谢与许可

OpenYoink 是独立的开源实现,与商业应用 Yoink 及其开发者没有隶属、授权或背书关系。自动更新由 Sparkle 提供。

第三方组件与许可证见 THIRD_PARTY_NOTICES.md。项目基于 MIT License 开源。


© 2026 weijue · MIT License

OpenYoink (MuQY1818/OpenYoink)

Searching Database…

这是什么?OpenYoink 是一个免费开源的 macOS 实用工具,让你把文件、图片、文本和链接拖到屏幕边缘的临时搁架或 Mac 的灵动岛上,切换到目标窗口后再把它们拖出来。它用 SwiftUI + AppKit 构建,驻留在菜单栏,没有 Dock 图标。
它和商业的 Yoink 应用是同一个东西吗?不是——OpenYoink 是对 Yoink 和 Dropover 等商业应用所普及的“搁架暂存”理念的独立开源重新实现,与两者均无关联。
它需要什么 macOS 版本?OpenYoink 要求 macOS 15 Sequoia 或更高版本,Release 构建同时支持 Apple Silicon 和 Intel Mac。
macOS 会阻止首次启动吗?GitHub Releases 上的免费社区构建是临时签名且未经 Apple 公证的,因此手动首次安装可能触发 Gatekeeper 警告——你需要右键选择“打开”,或在“隐私与安全性”设置中允许它。通过 Homebrew 安装会自动移除隔离属性,从而避免这个问题。
考虑到名字借鉴了 Yoink,授权上有顾虑吗?OpenYoink 以 MIT 许可证发布,并明确声明它与商业的 Yoink 应用或其开发者没有任何隶属、许可或背书关系。
它会复制我的文件,还是只引用原文件?默认情况下,OpenYoink 只保留一个指向原文件的沙箱书签——什么都不会复制。拖动时按住 Cmd 会切换为受管移动,把文件复制进应用的沙箱,然后把原文件移到废纸篓。
侧边搁架和灵动岛有什么区别?它们是共享同一暂存区的两个独立入口:经典的侧边搁架在文件靠近屏幕边缘时展开,而灵动岛与 Mac 的刘海集成(在外接或无刘海显示器上显示为浮动胶囊),还能承载电池、正在播放和快速访问收藏文件夹等模块。
除文件外,我还能把哪些内容放到搁架上?它接受文件、文件夹、纯文本和富文本、图片、链接;当来源应用为联系人、日历事件和邮件暴露了可读数据时,也接受这些内容。
Creator
MuQY1818
Size
29.2 MB
Stars
236
Age
2mo
Commits · 90 Days