从 Paste、Maccy 到 Deck：无损迁移你的剪贴板历史完整指南
从 Paste、Maccy 到 Deck：无损迁移你的剪贴板历史完整指南
Deck 是一款现代、原生、隐私优先的 macOS 剪贴板管理器，内置一键剪贴板历史迁移功能，可以把你在 Paste、Maccy、Flycut 等工具里积累的全部历史无损导入——全程只读扫描，不改动原应用数据，几分钟即可完成。本文手把手教你完成安装、迁移和迁移后验证，帮你把多年积累的剪贴板资产安全搬进 Deck。
为什么从 Paste / Maccy 迁移到 Deck？
| 对比维度 | Paste | Maccy | Deck |
|---|---|---|---|
| 历史记录 | ✅ | ✅ | ✅ 且支持从两者一键迁移 |
| 搜索方式 | 基础关键词 | 关键词 | 关键词 + 正则 + 类型筛选 + 语义搜索 |
| 图片 OCR | 需付费 | ❌ | ✅ 后台自动识别（Vision 框架，多语言） |
| 隐私保护 | — | — | Touch ID 解锁、敏感窗口自动暂停记录、银行卡号过滤 |
| 文本工具 | 基础 | 基础 | JSON 格式化、Base64、URL 编解码、行去重等 |
注：Paste 的部分高级功能需要订阅；Deck 的迁移入口对全部主流来源免费开放。
除了"搬得过来"，Deck 还有几个值得一提的亮点：
- 上下文感知排序：根据当前应用自动把最相关的记录排到前面；
- IDE 源码定位：从 VS Code、Xcode 等复制时自动记录文件路径与行号，点击跳回源码；
- 本地优先：数据默认只留在你的 Mac 上，使用统计纯本地计算，不上传。
安装 Deck：Homebrew 一键安装步骤
方式一：Homebrew（推荐）
brew tap yuzeguitarist/deck
export HOMEBREW_CASK_OPTS="--no-quarantine"
brew install --cask deckclip
HOMEBREW_CASK_OPTS="--no-quarantine" 用于本次安装关闭 macOS 隔离属性，因为 Deck 暂未完成公证。
方式二：手动安装
- 下载最新
.dmg（获取地址见 README_CN.md 的"安装"章节）； - 将
Deck.app拖入 应用程序 文件夹； - 在
系统设置 → 隐私与安全性中授予辅助功能及输入监控权限。
⚠️ 首次打开若提示"无法打开 'Deck'"，前往 系统设置 → 隐私与安全性，找到 Deck 的提示，点击 仍要打开 即可。系统要求：macOS 14.0+，Apple Silicon / Intel 均支持。
一键迁移剪贴板历史：3 步无损导入
第 1 步：找到迁移入口（2 个位置）
- 首次启动欢迎页：安装后首次运行 Deck，引导流程中会出现"迁移剪贴板"页面；
- 设置 → 存储（Storage）：内置常驻迁移模块，进入页面即自动扫描本机已安装的剪贴板应用。
第 2 步：选择来源，开始迁移
扫描完成后，列表只显示检测到的 App。Deck 支持的迁移来源包括：
| 来源 | 数据位置 | 说明 |
|---|---|---|
| Paste | 旧版 Paste.db / 沙盒新版 index.sqlite |
两种格式均兼容 |
| Maccy | Maccy 的 SQLite 历史库 | 一键迁移 |
| Flycut | Flycut 历史库 | 无历史时优雅跳过 |
| PasteBar / PasteNow | 各自本地数据库 | 一键迁移 |
| CliperX（含 UsePasteAgain 布局） | History.sqlite + Payloads |
只读扫描导入 |
相关演进记录可查阅 CHANGELOG_CN.md 中的"Paste 迁移适配与一键迁移流程"与"CliperX 剪贴板迁移"等条目。
第 3 步：等待批量导入完成
- 只读迁移：Deck 只读取原应用数据库，不会修改、删除任何源数据，原工具可继续正常使用；
- 分批写入：大批量导入走批量事务通道，数万条历史也能较快完成，且对界面几乎无卡顿；
- 导入完成后，历史记录即可像原生数据一样被搜索、筛选和管理。
迁移后验证：5 分钟确认数据完整
Cmd + P打开面板，目测历史条数与条目类型（文本、图片、文件、链接、颜色）是否齐全；- 用关键词、正则、
/斜杠规则（按应用、日期、类型过滤）各搜一次； - 挑一条图片记录按
Space预览，确认缩略图与大图完好； - 用
Enter粘贴一条旧文本，确认粘贴链路正常。
迁移完成后，你的旧历史即刻享受全部新功能：NLEmbedding 语义搜索（离线运行）、OCR 文字识别（图片转文字后台完成）、模板库、队列粘贴、AI 剪贴板助手等。
常用快捷键速查（详见 README_CN.md）：
| 快捷键 | 功能 |
|---|---|
Cmd + P |
打开 Deck 面板 |
Enter |
粘贴选中项 |
Shift + Enter |
粘贴为纯文本 |
Cmd + 数字(1–9) |
快速粘贴 |
Option + Q |
切换队列模式 |
Space |
切换预览 |
Esc |
关闭面板 |
常见问题（FAQ）
Q1：迁移会影响原应用的历史记录吗？ 不会。迁移是只读扫描，Paste / Maccy 等原工具数据保持原样；你随时可以再次执行迁移。
Q2：列表里没有我要迁移的 App？ 确认该应用曾产生过历史记录（Flycut 等无历史时会被自动跳过）；也可以在 设置 → 存储 重新触发一次扫描。
Q3：几万条历史，迁移会很慢吗？ 不会明显卡顿：导入采用批量事务与分批写入，大图片文件也会分页处理，历史越多耗时略长，但整体在分钟级。
Q4：迁移前需要备份吗？ Deck 不改动源数据，但稳妥起见，若你的旧工具支持导出（如 JSON），可以先导出一份存档。Deck 自身也提供数据导出功能，可随时备份新库。
写在最后
迁移只是开始——把 Paste、Maccy 里的历史无损搬进 Deck 之后，你获得的不仅是"更多历史"，还有语义搜索、OCR、隐私保护这些日常真正用得上的能力。现在打开 Deck，去 设置 → 存储 点一下迁移按钮吧 🚀