https://github.com/nanshanyi/pastedirect
mac剪切板工具
https://github.com/nanshanyi/pastedirect
mac paste swift
Last synced: 2 months ago
JSON representation
mac剪切板工具
- Host: GitHub
- URL: https://github.com/nanshanyi/pastedirect
- Owner: nanshanyi
- Created: 2022-11-11T12:18:21.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-12-16T11:55:50.000Z (7 months ago)
- Last Synced: 2025-12-20T01:25:01.703Z (7 months ago)
- Topics: mac, paste, swift
- Language: Swift
- Homepage:
- Size: 1.55 MB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
PasteDirect
轻量、安全、纯本地的 macOS 剪贴板历史管理工具
## 特性
- 🔒 **纯本地运行** — 所有数据存储在本地 SQLite 数据库，零网络请求，隐私无忧
- 📋 **多格式支持** — 文本、图片、HTML、RTF、富文本、代码片段，通通记录
- 🎨 **颜色识别** — 自动检测剪贴板中的 Hex 颜色值并可视化展示
- ⌨️ **快捷键呼出** — 默认 `⌘⇧V`，支持自定义快捷键
- 🔍 **快速搜索** — 直接键入关键词即时过滤历史记录，搜索框使用 pill 风格
- 🏷️ **多维筛选** — 按类型（文本/图片/颜色）、来源应用、时间范围组合筛选，筛选条件以 tag 形式贴合展示
- 👁️ **空格预览** — 按空格键快速预览选中内容，支持文本、图片、颜色详情
- 🖱️ **多种粘贴方式** — 双击粘贴、回车粘贴、拖拽到目标位置
- 📝 **纯文本模式** — 一键去除富文本格式，粘贴为纯文本
- 🧹 **自动清理** — 可设置保留时长：1 天 / 1 周 / 1 月 / 永久
- 🚫 **应用过滤** — 可忽略特定应用（如钥匙串、密码管理器）的剪贴板内容
- 🪟 **适配 macOS 26** — 全面支持液态玻璃（Liquid Glass）效果
## 安装
### 下载
从 [Releases](https://github.com/nanshanyi/PasteDirect/releases) 下载最新版本的 `.dmg` 文件，打开后将 `PasteDirect.app` 拖入 `/Applications` 目录即可。
### 首次运行
由于使用自签名证书，首次运行需要手动授权：
1. 右键点击 `PasteDirect.app` → 选择「打开」
2. 在弹出的对话框中点击「打开」
或通过终端：
```bash
xattr -cr /Applications/PasteDirect.app
open /Applications/PasteDirect.app
```
首次启动后，系统会提示授予「辅助功能」权限，这是监听剪贴板和模拟粘贴操作所必需的。
自签名证书系统会有安全提示，系统设置->隐私与安全性->仍然打开即可
### 更新无忧
从 v2.2.0 起，应用采用自签名证书机制，更新时辅助功能权限自动保留，无需重新授权。
从 v3.1.3 起，应用内支持手动检查更新，也可在设置中开启启动时自动检查更新。
## 使用方式
| 操作 | 说明 |
|------|------|
| `⌘⇧V` | 呼出 / 隐藏剪贴板面板（可自定义） |
| 双击 | 粘贴选中项 |
| `Enter` | 粘贴选中项 |
| `Space` | 预览选中项 |
| `Delete` | 删除选中项 |
| `Esc` | 依次关闭预览 / 筛选弹窗 / 清空搜索筛选 / 关闭面板 |
| 拖拽 | 将条目拖拽到目标位置直接粘贴 |
| 输入文字 | 搜索过滤历史记录，`Backspace` 可逐个移除筛选条件 |
## 设置选项
- **开机启动** — 登录时自动运行
- **状态栏图标** — 显示 / 隐藏菜单栏图标
- **直接粘贴** — 选中后自动粘贴到当前应用
- **纯文本粘贴** — 去除格式，仅粘贴纯文本
- **历史保留时长** — 1 天 / 1 周 / 1 月 / 永久
- **忽略应用** — 配置不记录剪贴板的应用列表
- **快捷键** — 自定义全局呼出快捷键
- **检查更新** — 支持手动检查更新与启动时自动检查
## 从源码构建
### 环境要求
- macOS 13.0+
- Xcode 16+
- Swift 6
### 构建步骤
```bash
git clone https://github.com/nanshanyi/PasteDirect.git
cd PasteDirect
open PasteDirect.xcodeproj
```
在 Xcode 中选择 `PasteDirect` scheme，点击运行即可。依赖通过 Swift Package Manager 自动拉取。
### 依赖项
| 库 | 用途 |
|----|------|
| [KeyboardShortcuts](https://github.com/sindresorhus/KeyboardShortcuts) | 全局快捷键 |
| [SQLite.swift](https://github.com/nicklama/SQLite.swift) | 本地数据库 |
| [SnapKit](https://github.com/SnapKit/SnapKit) | Auto Layout |
## License
MIT License