xPaste
免费、开源、纯本地的 macOS / Windows 剪切板历史，自带截图、贴图和录屏。截图里的字、文件里的内容、拼音首字母，都能搜到。
官网 · 下载 · 功能规格说明 · 参与开发
按一个快捷键唤起面板，搜索、预览，再把任意一条复制过的内容贴回当前应用。和同类工具相比，xPaste 的不同之处在于图片和文件里的内容也能搜。
截图、贴图和录屏（录屏仅 macOS）也在 xPaste 里，不用另装工具：截下的图直接进历史，随后能按图里的字搜到；录下的视频同样作为一条记录进入历史，可以直接粘贴。
功能
- 截图里的字能搜到。 截过一张图，只记得图里有某个数字或某句话，照样能搜出来。截图和复制的图片在后台用系统自带的离线文字识别（macOS Vision、Windows.Media.Ocr）读出文字，不联网、不上传、不下载模型，也不增加安装体积；一次复制的多张图片会一起识别。命中时列表行写明“识别文字中含……”，预览里可以看全文、一键复制。
- 截图、标注、钉在屏幕上。 按
⌥ + Shift + A（Windows Alt + Shift + A）冻结所有屏幕，单击选中窗口、拖动框选，或按 F 选整块屏；1–7 依次是矩形、椭圆、箭头、画笔、马赛克、文字、序号。回车复制，截图直接进历史，之后能按图里的字搜到；⌘ S（Windows Ctrl + S）保存到截图文件夹，O 只复制图里的文字（作为一条文本记录进历史），P 把截图钉在屏幕上当参考：可以拖动、滚轮缩放（20%–400%）、双击关闭，右键复制或保存。
- 录屏（仅 macOS 13+）。 按
⌥ + Shift + R，用截图同样的遮罩选窗口、区域或整块屏，倒计时 3 秒后录成 MP4（H.264，30 或 60 fps，清晰度可选），可以带系统声音和麦克风（麦克风要 macOS 15）；录制中菜单栏显示 ● mm:ss，再按一次快捷键或点菜单“停止录制”结束，结果用系统通知告知。视频存进录屏文件夹（默认 ~/Movies/xPaste），同时作为视频记录进入历史，可以直接粘贴。Windows 暂不支持录屏。
- 拼音、首字母都能搜。 不用切输入法，打
huiyi 或 hy 就能找到“会议”；多音字也认得，yinhang 能找到“银行”，命中的字直接高亮。
- 文件按内容找。 打开“搜索文本文件内容”后，复制的 txt、md、csv、json、代码等文件的内容也能搜到，忘了文件名也能找回来。这个选项默认关闭，由你决定要不要为此多占一点磁盘。
- 历史再多也不卡。 三个字符以上的搜索走本地全文索引，几百 MB 的历史文本也是毫秒级；连续输入会合并查询，不会越打越慢。
- 隐私是硬约束，不是开关。 所有数据只在本机，没有账号、没有云同步、没有使用统计。来自密码管理器或被系统标记为敏感的内容默认不记录；日志里从不出现剪切板内容、标题、文件路径和搜索词。
- 两个系统，一套习惯。 macOS 与 Windows 共用同一份核心代码，交互、快捷键、外观都一样，换电脑不用换工具。
- 看得见的复制节奏。 面板顶部的复制频谱让你一眼看到最近复制了什么、复制了多少；“常用”分类按使用次数自动归类，阈值可调。
- 顺手的细节。
- 误删 5 秒内可撤销；
- 数字键直接粘贴前几条；
- 搜索框为空时按退格不会误删记录；
- Esc 先清空搜索，再隐藏面板；
- 面板出现在鼠标所在的显示器。
有意不做的：跨设备同步（和“数据不离开本机”冲突）、片段库与模板。
下载安装
上面的链接始终指向最新版，历史版本在 Releases。
macOS：打开 dmg，把 xPaste 拖进“应用程序”。安装包还没有签名，从浏览器下载后第一次打开会被系统拦下，可能提示“xPaste 已损坏，无法打开”，而且没有“仍要打开”按钮。这不是文件坏了，按下面的顺序放行：
- 在终端运行
xattr -dr com.apple.quarantine /Applications/xPaste.app（去掉隔离属性），再正常打开。这一步在各版本 macOS 上都有效。
- 如果弹窗写的是“无法验证开发者”而不是“已损坏”，也可以先双击打开一次，再到系统设置 → 隐私与安全性，在页面底部点“仍要打开”（出现这个按钮时才行）。
- 仅限 macOS 13–14：在访达的“应用程序”里按住 Control 点按 xPaste →“打开”，在弹窗里再点“打开”。从 macOS 15 起，这个方法不再能绕过拦截。
Windows：运行安装程序，它会装到当前用户目录（%LOCALAPPDATA%\xPaste），不需要管理员权限。SmartScreen 提示“Windows 已保护你的电脑”时，点“更多信息 → 仍要运行”。部分 Windows 10 没有 WebView2 运行时，安装程序会在线下载，需要联网。
快速上手
- 按
⌘ + Shift + V（macOS）/ Ctrl + Shift + V（Windows）唤起面板，快捷键可以在设置里改。第一次启动有引导。
- 直接打字搜索，按 Enter 粘贴到上一个应用：
- macOS 上自动粘贴需要“辅助功能”权限（系统设置 → 隐私与安全性 → 辅助功能）。
- 不授权也能用：Enter 只复制并提示，到目标应用里手动按
⌘ + V 即可。
- 右键一条记录（或按
Shift + F10）：
- 可以粘贴、置顶、删除；
- 链接可以“在浏览器中打开”；
- 文件、视频和来自文件的图片可以“在访达中显示” / “在资源管理器中显示”。
- 片段：
- 历史记录上右键“存为片段…”，或在设置的“记录”标签里“新建片段…”，起个名字；
- 在“全部”里搜名字（支持拼音与首字母）就能找到，Enter 粘贴出的是内容；
- 片段不受保留时长、最多条数和“清空历史”影响，只在“片段”分类里删除（
Mod 点击可多选）。
- 复制频谱：
- 点标题行可以收起，收起后只留一行统计；
- 滚轮或双指捏合可以放大到几分钟，拖动平移，双击回到 24 小时；
- 标题行的
24h 6h 1h 10m 直接跳到对应时长。
- 图片里的文字：
- 搜索命中图中文字时，预览里展开“图中文字”可以看全文、点“复制文字”复制；
- 设置里可以关掉识别，或关掉“为已有图片补识别”。
- 截图：
- macOS 第一次截图前要授予“屏幕录制”权限（系统设置 → 隐私与安全性 → 屏幕录制，macOS 15 起叫“录屏与系统录音”），授权后重新打开 xPaste；
- 截图快捷键、截图文件夹、保存时是否同时复制，都在设置的“截图”标签里改；
- 遮罩里
1–7 选标注工具，⌘ Z（Windows Ctrl + Z）撤销，Esc 直接退出，右键先取消选区、再退出。
- 录屏（仅 macOS）：
- 和截图用同一个“屏幕录制”权限；开着麦克风第一次录制时，系统会再问一次麦克风权限；
- 遮罩工具栏上的系统声音、麦克风开关会被记住，录屏快捷键、录屏文件夹、录完是否复制，都在设置的“截图”标签里改；
- 录制中不能截图，先停止录制。
- 设置里的“外观”点选即生效，不用再点“保存设置”。
- 托盘菜单：
- “暂停记录”在重启后仍然有效；
- 菜单底部灰色的“xPaste <版本>”是当前版本号。
数据与隐私
数据只存在本机，不联网、不同步、不收集使用统计：
- macOS：
~/Library/Application Support/xPaste/
- Windows：
%APPDATA%\xPaste\
设置里可以“清空历史…”，置顶的记录与片段会保留。数据库没有加密，是本机明文 SQLite，靠系统账户权限保护。
卸载
- macOS：
- 从菜单栏图标选“退出 xPaste”，把应用拖进废纸篓。
- 要连数据一起删，还需手动删除这些位置：
- 上面的数据目录；
~/Library/LaunchAgents/ 下 xPaste 的 plist（开过“开机时启动”才有）；- WebView 留下的
~/Library/WebKit/com.xpaste.app 和 ~/Library/Caches/com.xpaste.app。
- Windows：在“设置 → 应用”里卸载。要删历史数据，在卸载确认页勾选“删除应用程序数据”。
已知限制
- 安装包没有签名，也没有自动更新，新版本要手动下载安装。
- Windows 端在 CI 上编译并跑通了全部单元测试，但还没有在真机上手动验收；图片文字识别依赖系统已安装的 OCR 语言包。
- macOS 分 Apple 芯片和 Intel 两个安装包，没有通用版本。
- 截图的选区不能跨显示器；贴图退出 xPaste 就消失，重启不恢复。macOS 15 起系统会定期再次询问是否继续允许屏幕录制。
- 录屏只支持 macOS，麦克风要 macOS 15；同时录系统声音和麦克风时是两条音轨，有的播放器只播第一条。只有从菜单栏“退出 xPaste”会先把视频写完，录制中注销、关机或用
⌘ Q 结束 xPaste 时，正在录的视频无法播放。
- 应用启动后第一次识别图片要加载系统模型，大约 8 秒，之后每张通常不到 1 秒。
完整列表（包括性能测量结果、各平台的细节）见 docs/已知限制.md。
参与开发
需要 Node.js、pnpm 和 Rust ≥ 1.90：
make install # 安装依赖
make dev-isolated # 开发运行，数据目录隔离在 .xpaste-dev/
make check # 提交前全量检查
目录结构、分支流程、发版与签名见 CONTRIBUTING.md。
文档
许可证
MIT
