PasteDirect

简体中文 | English

轻量、安全、纯本地的 macOS 剪贴板历史管理工具

特性

• 🔒 纯本地运行 — 所有数据存储在本地 SQLite 数据库，零网络请求，隐私无忧
• 📋 多格式支持 — 文本、图片、HTML、RTF、富文本、代码片段，通通记录
• 🎨 颜色识别 — 自动检测剪贴板中的 Hex 颜色值并可视化展示
• 🖼️ 图片文字识别（OCR） — 本地识别复制图片中的文字（基于 Vision 框架，零网络请求），让图片可通过搜索图中文字找到；也可在图片右键菜单中直接复制或粘贴识别出的文字
• 📝 实况文本（Live Text） — 预览图片时可直接用鼠标框选、复制图中文字，体验与系统照片一致，电话、网址等还能点击识别
• ⌨️ 快捷键呼出 — 默认 ⌘⇧V，支持自定义快捷键
• 🔍 快速搜索 — 直接键入关键词即时过滤历史记录，搜索框使用 pill 风格
• 🏷️ 多维筛选 — 按类型（文本/图片/颜色）、来源应用、时间范围组合筛选，筛选条件以 tag 形式贴合展示
• 👁️ 空格预览 — 按空格键快速预览选中内容，支持文本、图片、颜色详情，图片预览中可直接选取文字
• 🖱️ 多种粘贴方式 — 双击粘贴、回车粘贴、拖拽到目标位置
• 📝 纯文本模式 — 一键去除富文本格式，粘贴为纯文本
• 📐 面板高度可调 — 拖拽顶部边缘调整面板高度，内容等比缩放
• 🧹 自动清理 — 可设置保留时长：1 天 / 1 周 / 1 月 / 永久
• 🚫 应用过滤 — 可忽略特定应用（如钥匙串、密码管理器）的剪贴板内容
• 🪟 适配 macOS 26 — 全面支持液态玻璃（Liquid Glass）效果

安装

下载

从 Releases 下载最新版本的 .dmg 文件，打开后将 PasteDirect.app 拖入 /Applications 目录即可。

首次运行

由于使用自签名证书，首次运行需要手动授权：

1. 右键点击 PasteDirect.app → 选择「打开」
2. 在弹出的对话框中点击「打开」

或通过终端：

xattr -cr /Applications/PasteDirect.app
open /Applications/PasteDirect.app

首次启动后，系统会提示授予「辅助功能」权限，这是监听剪贴板和模拟粘贴操作所必需的。 自签名证书系统会有安全提示，系统设置->隐私与安全性->仍然打开即可

更新无忧

从 v2.2.0 起，应用采用自签名证书机制，更新时辅助功能权限自动保留，无需重新授权。

从 v3.1.3 起，应用内支持手动检查更新，也可在设置中开启启动时自动检查更新。

使用方式

操作	说明
⌘⇧V	呼出 / 隐藏剪贴板面板（可自定义）
双击	粘贴选中项
Enter	粘贴选中项
Space	预览选中项
Delete	删除选中项
Esc	依次关闭预览 / 筛选弹窗 / 清空搜索筛选 / 关闭面板
拖拽	将条目拖拽到目标位置直接粘贴
输入文字	搜索过滤历史记录，Backspace 可逐个移除筛选条件

设置选项

• 开机启动 — 登录时自动运行
• 状态栏图标 — 显示 / 隐藏菜单栏图标
• 直接粘贴 — 选中后自动粘贴到当前应用
• 纯文本粘贴 — 去除格式，仅粘贴纯文本
• 自动识别图片中的文字 — 对复制的图片做 OCR，使其可通过搜索图中文字找到；可关闭（关闭后仍可在图片右键菜单中手动取用文字）
• 历史保留时长 — 1 天 / 1 周 / 1 月 / 永久
• 忽略应用 — 配置不记录剪贴板的应用列表
• 快捷键 — 自定义全局呼出快捷键
• 检查更新 — 支持手动检查更新与启动时自动检查

从源码构建

环境要求

• macOS 13.0+
• Xcode 16+
• Swift 6

构建步骤

git clone https://github.com/nanshanyi/PasteDirect.git
cd PasteDirect
open PasteDirect.xcodeproj

在 Xcode 中选择 PasteDirect scheme，点击运行即可。依赖通过 Swift Package Manager 自动拉取。

依赖项

库	用途
KeyboardShortcuts	全局快捷键
SQLite.swift	本地数据库
SnapKit	Auto Layout

更新日志

完整版本历史见 CHANGELOG。

License

MIT License