下面按首页功能逐条拆解：每节都给出「做什么 → 怎么做 → 按哪个键」。所有快捷键都分 macOS 与 Windows / Linux 两套，页面右上角可随时切换。
GrapeClip 桌面端是常驻后台的菜单栏 / 托盘应用：装好之后它就安静地待在那儿，用一个全局快捷键随时唤起。
同步是可选的：不开也能当本地剪贴板管理器用。开了之后，内容在离开设备前就完成加密，服务端只见密文。
同步后端三选一，都在「偏好设置 → 同步」里配置。三者的加密方式完全一样，区别只在密文存在哪儿。
自己部署开源服务端（Docker 一条命令）。填服务器地址 → 注册 / 登录账号即可。支持多设备实时增量同步。
docker compose -f docker-compose.sqlite.yml up -d密文以文件形式存在 iCloud Drive 的 GrapeClip 目录里，不需要账号、不需要服务器。适合全 Apple 设备的用户。
填 WebDAV 根地址（如 Nextcloud 的 remote.php/dav/files/用户名）、用户名和密码，点「测试连接」验证。密文放在 GrapeClip/sync 目录。
所有剪贴板内容都用这把主密钥派生的数据密钥加密（HKDF-SHA256 + XChaCha20-Poly1305）。它只存在设备的系统钥匙串里，不写磁盘、不上传服务器——所以服务端无法读取你的任何内容，也无法帮你找回密钥。
配好之后打开「启用自动同步」，设一个同步间隔（秒）。想立刻验证就点「立即同步」，会提示上传下载各多少条。
唤起面板后，键盘就够用了——鼠标是可选的。
唤起面板时自动聚焦，直接打字就是搜索。搜索位置（顶部 / 底部）和是否默认聚焦都可以在偏好设置里改。
全部 / 收藏 / 文本 / 图片 / 文件 / 摘录，用 Tab 键循环切换。
按最近复制时间倒序。每条显示类型、来源应用图标、复制次数和同步状态圆点。
右栏显示完整内容与元信息（字符数 / 尺寸 / 大小 / 来源 / 来源链接 / 创建时间 / 最近复制 / 使用次数），以及这条内容对应的智能操作按钮。
面板打开时，按住 Command（Windows / Linux 是 Ctrl）加数字 1~9，直接粘贴列表里的第 N 条——搜索过滤之后同样按当前列表顺序算。这个键不需要任何设置，开箱即用，也不占用系统全局快捷键。
重复复制的内容不会堆成一屏，而是合并成一条、累计次数、置顶到最前——首次复制的时间仍然留档可查。
正文、备注都能搜。唤起面板直接打字即可，不用先点搜索框。
macOS 上用系统本地 Vision 框架做 OCR（默认开启，全程离线，不联网）。截图里的验证码、报错信息，事后都能靠关键词捞回来。
搜索的同时按 Tab 切到「图片」或「收藏」，可以把结果限定在该类型内。
默认保留 365 天 / 最多 10000 条，两个值都可以改，填 0 表示不限。超出的旧记录自动清理。
要往表单里填一串信息时，来回切窗口最费神。GrapeClip 让你一次挑好，然后一路 Enter 填完。
队列一旦启动，屏幕上会出现一个小小的悬浮牌堆：显示还剩几条、下一条是什么、以及当前生效的快捷键。粘一条，飞走一张。上面还有跳过 / 上一条 / 取消按钮，鼠标也能操作。
收藏的条目不受保留期限影响，永远不会被自动清理——剪贴板历史因此变成可以沉淀的摘录本。
剪贴板里躺着一段话，却想不起它来自哪儿——GrapeClip 在复制的那一刻就把上下文记下来了。
自动记录内容来自哪个应用，并在列表和详情里显示应用图标。不需要任何额外授权。
从浏览器复制时，可以额外记下页面地址和标题，详情里一键跳回原文。这一项需要 macOS 的「自动化」权限（GrapeClip 要向浏览器询问当前标签页），所以默认关闭，在「偏好设置 → 剪贴板」里手动开启。
GrapeClip 会看懂你复制的是什么，并在详情面板直接给出对应操作。转换结果一键回流剪贴板，粘贴即用。
「在 Finder 显示」在 Windows / Linux 上是「在文件资源管理器中显示」，同一个按钮按平台改称呼。右键菜单里还有「粘贴为纯文本」「粘贴为路径」「导出为文件」「下载图片」等按内容类型出现的操作。
从网页复制的内容常常带一身样式。右键选「粘贴为纯文本」可以剥掉格式；如果你经常这么做，去偏好设置给它分配一个快捷键——这一项默认是空的，需要自己设。
邮箱、地址、常用话术、代码片段——把它们存成摘录，之后键入一个别名就能展开。
;mail;addr → 收货地址：杭州市西湖区……效率工具不该成为泄漏点。密码这类内容，GrapeClip 从一开始就不记录。
GrapeClip 遵循 nspasteboard.org 的约定：密码管理器等应用在复制时会给剪贴板打上「机密 / 瞬态」标记，声明这份内容不该被历史工具记录。带标记的内容直接跳过，不落库、不同步。
有些应用不打标记，就靠这份清单兜底。内置了常见密码管理器，你可以自己往里加任何应用——来自清单里的复制一律不记录。
菜单栏 / 托盘图标右键选「停止监听」，在做敏感操作的这段时间里完全不记录，做完再点「开启监听」。
手机上没有全局快捷键，取而代之的是一块随时可以调出来的剪贴板键盘。
GrapeClip 自带一个输入法键盘。在设置里启用后，任意输入框都能切到它，直接挑历史内容粘贴，还支持把一段话分词后逐段插入。
在历史列表里长按任意条目进入多选模式，勾选框会直接显示合并序号，可以批量收藏、合并分享或删除。
颜色转换、JSON 格式化、时间戳换算在 Android 历史列表里同样可用。
同步配置最快的路径：桌面端「导出密钥」显示二维码，手机扫一下即可，不用手打 24 个助记词。
配置和数据始终握在自己手里。
内置更新器，发现新版本会提示更新日志与版本号，一键完成。可以在偏好设置里关掉自动检查，也可以订阅 beta 通道抢先体验。
「偏好设置 → 备份」可以把配置和数据导出成文件，换机或重装时导入即可。
备份文件和加密密钥是两回事。24 个助记词请单独存进密码管理器——这是唯一无法从任何备份里重建的东西。
全局快捷键在任何应用里都生效，可以在「偏好设置 → 快捷键」里改；面板内快捷键只在 GrapeClip 窗口打开时生效，其中带「可改」标记的同样支持自定义。
| 打开剪贴板面板 | ⌥ CAlt + C | 默认 |
| 打开偏好设置窗口 | 未设置未设置 | 默认留空，可自行设置 |
| 开关连续复制（收集模式） | ⌘ ⇧ CCtrl + Shift + C | 默认 |
| 粘贴队列中的下一条 | ⌘ ⇧ VCtrl + Shift + V | 默认 · 仅队列进行中占用 |
| 快速粘贴前九项 | ⌘ ⇧ 1~9Win + Shift + 1~9 | 默认关闭，需手动启用 |
| 选中上一条 / 下一条 | ↑ / ↓↑ / ↓ | 固定 |
| 选中上一条 / 下一条（字母键位） | ⌃ P / ⌃ NCtrl + P / Ctrl + N | 可改 |
| 切换分组 | Tab / ⇧ TabTab / Shift + Tab | 固定 |
| 聚焦搜索框 | ⌘ FCtrl + F | 固定 |
| 回到顶部 | HomeHome | 固定 |
| 粘贴选中条目 | EnterEnter | 固定 |
| 粘贴列表第 1~9 条 | ⌘ 1~9Ctrl + 1~9 | 固定 |
| 粘贴为纯文本 | 未设置未设置 | 可改 |
| 预览图片 | SpaceSpace | 固定 |
| 收藏 / 取消收藏 | ⌘ DCtrl + D | 固定 |
| 删除条目 | Delete / ⌫Delete / Backspace | 固定 |
| 加选 / 取消单条 | ⌘ + 点击Ctrl + 点击 | 固定 |
| 范围选择 | ⇧ + 点击Shift + 点击 | 固定 |
| 固定窗口（不自动隐藏） | ⌘ PCtrl + P | 固定 |
| 打开偏好设置 | ⌘ ,Ctrl + , | 固定 |
| 取消多选 | EscEsc | 固定 |
| 隐藏窗口 | Esc / ⌘ WEsc / Ctrl + W | 固定 |
面板内几乎所有快捷键在 macOS 用 ⌘（Command），在 Windows / Linux 用 Ctrl。这是自动切换的，不需要你配置。
「打开面板 / 偏好设置」用的 Alt，在 macOS 上就是 ⌥（Option）键，两边其实是同一个物理位置。
它的默认修饰键是 Command，在 Windows / Linux 上会映射到 Super（Win 键），而 Win+Shift+数字 被 Windows 系统占用了。这一项默认就是关闭的；Windows 用户启用时请顺手改成别的组合，见下一节。
面板内的「选中上一条」默认是 Ctrl+P，而「固定窗口」在 Windows / Linux 上也是 Ctrl+P（macOS 是 ⌘P，不冲突）。Windows 用户建议把「选中上一条」改掉，或直接用方向键。
截图 OCR（系统 Vision 框架）、浏览器来源链接（自动化权限）、快捷短语全局展开（输入监控权限）目前是 macOS 独有，Windows / Linux 正在跟进。
全局快捷键是一种「抢占」：一旦注册，它在所有应用里都优先生效，原本属于某个应用的同名快捷键就被吃掉了。所以选键的核心原则不是好不好按，而是抢得值不值。
唤起面板一天要按几十次，值得占一个两键组合；一天按一次的「打开设置」用三键组合甚至不设都行。
⌘⇧字母 / Ctrl+Shift+字母 是应用自定义快捷键最密集的区间。全局抢一个走，代价往往比你想象的大。
C 系列管「收集」，V 系列管「粘出」——修饰键递增，肌肉记忆一次建立。
Win+V（Windows 剪贴板历史）、⌘Space（Spotlight）、Alt+Space（Windows 窗口菜单）这类系统级组合，抢不稳也不该抢。
单修饰键 + C（Clipboard），两键就能按到，全局占用代价很低——几乎没有应用把 ⌥C / Alt+C 用作核心功能。唯一的副作用是 macOS 上 ⌥C 原本会输入「ç」，被全局占用后就打不出这个字符了；如果你需要它，改成 ⌘⌥C / Ctrl+Alt+C。
打开设置是低频动作，从菜单栏 / 托盘图标点一下、或在剪贴板窗口里按 ⌘, / Ctrl+, 都能到，不值得为它长期占一个全局坑位。所以它默认就是空的；真需要时到「偏好设置 → 快捷键」自己录一个即可。
这是浏览器和编辑器的重灾区：Chrome / Edge 的 ⌘⇧C / Ctrl+Shift+C 是开发者工具的元素选择器，很多编辑器也占了它。全局注册会把这些统统吃掉。
⌘⇧V / Ctrl+Shift+V 在 Chrome、VS Code、Slack、Notion 等一大批应用里是「粘贴为纯文本」——这可能是最不该被全局抢走的组合之一。好消息是 GrapeClip 只在队列进行中才占用它，但队列一开，你就粘不了纯文本了。
默认修饰键是 Command，在 Windows / Linux 上映射成 Super（Win 键），而 Win+Shift+数字 是 Windows 保留组合（跳转任务栏应用的新实例），注册不稳。macOS 上 ⌘⇧1~9 相对安全，但它会一次吃掉九个组合——除非你真的常用，否则不如就靠面板内的 ⌘1~9。
⌃P / ⌃N 是 macOS 系统级的文本光标约定（上一行 / 下一行），在 mac 上非常自然。但在 Windows / Linux 上，Ctrl+P 和面板内置的「固定窗口」撞了车——按一下会同时移动选中项并切换窗口固定状态。
核心思路：把全局快捷键统一收进「⌃⌥ / Ctrl+Alt」这个几乎无人认领的区间，只有最高频的「唤起面板」保留单修饰键的两键组合。
| 动作 | macOS | Windows / Linux | 为什么 |
|---|---|---|---|
| 打开剪贴板面板 | ⌥ C | Alt + C | 保持默认。最高频动作，值得一个两键组合 |
| 打开偏好设置 | （留空） | （留空） | 已是默认值。菜单栏和面板内 ⌘, / Ctrl+, 已够用 |
| 开关连续复制 | ⌃ ⌥ C | Ctrl + Alt + C | 让开浏览器开发者工具 |
| 粘贴队列下一条 | ⌃ ⌥ V | Ctrl + Alt + V | 让开「粘贴为纯文本」 |
| 粘贴为纯文本（面板内） | ⌘ ⇧ V | Ctrl + Shift + V | 面板内快捷键不是全局注册，可以放心沿用通用习惯 |
| 快速粘贴（如果要开） | ⌘ ⇧ + 1~9 | Ctrl + Alt + 1~9 | Windows 务必改掉默认的 Super 修饰键 |
| 面板内选中上/下一条 | ⌃ P / ⌃ N | Alt + P / Alt + N | Windows 上避开与「固定窗口」的 Ctrl+P 冲突 |
| 快捷短语触发前缀 | ; | ; | 保持默认。分号几乎不会在中文输入里误触 |