Skip to content

Repository files navigation

Y-Clip 图标

Y-Clip

把 Windows Win + V 的剪贴板历史体验,原生搬到 macOS。

一个轻量、常驻菜单栏的剪贴板历史工具 —— 在任意输入光标旁按下快捷键,即可翻看、选择并自动粘贴最近复制过的文字与图片。

平台 语言 签名 下载

历史面板预览

✨ 功能

  • 📋 自动记录 最近复制过的剪贴板内容,默认保留 50 条,数量可在设置里调整
  • 🖼️ 文字 + 图片 都能记录,图片以统一大小的缩略图展示,列表整齐不跳动
  • ⌨️ 随手呼出:默认 ⌥ + ⌘ + V,在输入光标附近弹出,靠近屏幕边缘自动避让
  • 📌 固定面板:点击右上角图钉,或用默认 ⌥ + ⇧ + ⌘ + V 直接打开固定状态;面板保持在普通窗口上方、可拖拽并记住位置,历史变化会实时刷新
  • 🎯 多种选择方式:鼠标点击、↑↓ 方向键、Enter 粘贴、Esc 关闭;固定状态下选择内容后面板继续显示
  • 选中即置顶:选用某条历史后,它会自动成为当前剪贴板内容并排到最前
  • 📐 显示可调:设置里用滑杆调整历史面板大小、宽度和长度;选择「功能」页时旁侧半透明预览会持续显示并实时更新
  • 🔢 历史上限可调:可设置最多记录多少条历史,默认 50 条
  • 🔄 自动更新:可自动检查 GitHub Release,并按当前编译架构精确选择 Y-Clip-v版本-arm64.dmgY-Clip-v版本-x86_64.dmg;Release 版本必须严格高于当前版本,下载 App 的内部版本必须完全一致,挂载源、临时副本、同卷候选和最终安装路径都会校验 Bundle ID、Developer ID 团队、hardened runtime、代码签名、Gatekeeper 与 thin 架构。安装使用固定互斥锁和 candidate + backup 原子切换;安装器的 READY\n 通道必须随即关闭且不允许尾随内容。新版只有在 AppKit 完成启动、回传随机 token/PID 并继续存活后才提交更新;失败时只恢复并启动已验证的旧版,回滚不完整则保留互斥锁和全部恢复副本供后续处理
  • 🎨 全新图标:浅色 macOS 风格底板,保留层叠剪切板识别点,并收敛图标视觉尺寸
  • 🪶 不抢焦点:弹窗不会激活应用,尽量保留你原本的输入框焦点
  • 🍎 原生体验:菜单栏常驻图标,深色 / 浅色模式自适应,无 Dock 图标打扰

📦 安装

方式一:下载安装包(推荐)

  1. 根据 Mac 处理器下载 v1.0.20 对应安装包:
  2. 双击打开,把 Y-Clip 拖进 应用程序 文件夹
  3. 从启动台或应用程序文件夹打开即可

✅ 两个架构的安装包都分别完成 Apple Developer ID 签名、公证(notarized)与 Gatekeeper 验证,下载后双击即可打开,不会出现「无法验证开发者」或「已损坏」的拦截

v1.0.20 只提供 arm64x86_64 两个独立 thin DMG,不额外提供 universal DMG。

方式二:从源码构建

GitHub 仓库:Rainchen537/Y-Clip

需要安装 Xcode 命令行工具。

git clone https://github.com/Rainchen537/Y-Clip.git
cd Y-Clip
./build.sh                 # 默认构建 arm64 thin app 到 build/Y-Clip.app
TARGET_ARCH=x86_64 BUILD_DIR=build-x86_64 ./build.sh
./install_app.sh           # 安装默认 build/Y-Clip.app 到 /Applications

🔐 权限说明

首次启动时 Y-Clip 会统一说明所需的 「辅助功能」 权限;选择历史记录自动粘贴时,macOS 会要求完成授权 —— 这是模拟 ⌘ + V 粘贴所必需的,所有同类工具都一样。后续只在运行副本或权限状态变化时提示当前未完成步骤,不会反复弹出完全相同的警告。

系统设置 → 隐私与安全性 → 辅助功能 → 勾选 Y-Clip

  • 如果没有自动弹出,可从菜单栏图标的设置里点 「辅助功能」 按钮打开。
  • 没有授予权限时,应用仍会把选中内容复制回系统剪贴板,只是不会替你自动粘贴(需要你手动 ⌘V)。
  • 权限页会标明当前运行的是 「正式安装版」 还是 「开发副本」;若 /Applications/Y-Clip.app 的 Bundle ID 和 Developer ID 团队签名均验证通过,可直接点 「切换到安装版」,避免权限绑定到临时构建。
  • 若系统设置里看起来已开启但仍不生效,「刷新权限记录」 只会重置 Y-Clip 自身 Bundle ID 的辅助功能 TCC 记录,不影响其他 App。若操作来自开发副本,Y-Clip 不会立刻为该副本再次请求权限;检测到有效的 /Applications/Y-Clip.app 时会切换到正式安装版,并在那里引导重新授权。也可以运行 ./reset_accessibility.sh 完成同样的定向刷新。

⌨️ 使用

操作 快捷键
打开临时历史面板 ⌥ + ⌘ + V(可在设置里自定义)
打开固定历史面板 ⌥ + ⇧ + ⌘ + V(可独立自定义)
上 / 下选择 /
粘贴选中项 Enter
关闭面板 Esc
打开设置 点击菜单栏的剪贴板图标

历史面板右上角有图钉和齿轮按钮:图钉用于切换固定状态,齿轮可直接打开设置,适合菜单栏图标被系统隐藏时使用。

在设置面板里可以:分别自定义临时面板与固定面板快捷键、调节历史面板大小/宽度/长度、设置历史上限、开关开机自启、自动检查更新、清空历史、打开辅助功能权限、打开 GitHub 页面。

🛠️ 技术

  • Swift + AppKit,无第三方依赖
  • 全局热键:Carbon RegisterEventHotKey
  • 自动粘贴:CGEvent 键盘事件注入
  • 开机自启:SMAppService
  • 数据:文字与图片元数据仍存于 ~/Library/Application Support/GlobalClipboard/,用于保持从旧版升级后的历史记录兼容;图片原图单独落盘并按内容去重

📄 许可

MIT License


用 ❤️ 为 macOS 打造

友情链接:Linux.do

About

A lightweight native macOS menu-bar clipboard manager. 轻量的 macOS 菜单栏剪贴板历史工具,支持文字与图片、全局快捷键、自动粘贴。

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages