vPaste：剪贴板历史管理器

项目简介

vPaste 是一款适用于 Windows 和 macOS 的可视化剪贴板管理器。它会把复制过的文本、图片、链接、颜色和文件记录成卡片，附带复制时间与来源应用，方便随时搜索、预览并再次粘贴。剪贴板历史保存在本地，不需要账号，也不会上传到云端。

项目使用 Tauri 2 + Rust 构建桌面端，界面基于 React 18 + TypeScript + MUI 5 + Motion，许可证为 GPL-3.0-only。

主要功能

支持的内容类型

类型	展示与预览	可用操作
文本	纯文本与富文本，含标题、列表、表格、链接	搜索内容；按原格式或纯文本粘贴
图片	卡片缩略图、原尺寸预览、尺寸信息、GIF 识别	粘贴或拖入支持的应用；导出为图片文件
链接	URL，开启链接预览时显示页面标题与图片	按标题或 URL 搜索；预览页面或在浏览器打开
颜色	色块与色值	在 HEX、RGB、HSL 之间转换；复制所需色值
文件	单个文件、文件夹、多文件记录；支持格式可预览	粘贴或拖拽文件；打开所在位置或复制路径

富文本保真度、文件预览与拖放支持取决于来源格式和接收应用。文件记录指向磁盘上的原始文件，并非永久备份。

搜索与整理

• 关键词搜索：可查找文本、网页标题、URL、文件名、路径或来源应用。
• 筛选：按内容类型、来源应用或日期缩小范围，也可在收藏与标签中查找。
• 整理：收藏常用记录、添加标签，并用自定义标签页分组。

预览与粘贴

启动 vPaste 并完成首次引导后，照常复制内容。Windows 按 Alt + V、macOS 按 Option + V 打开历史面板，选中卡片后按 Enter 粘贴到当前应用。macOS 需要按引导授予辅助功能权限才能自动粘贴。

• 内容预览：按 Space 查看完整文本、图片、网页及受支持的文件内容。
• 粘贴格式：保留受支持的富文本格式，或用 Shift + Enter 以纯文本粘贴。
• 粘贴队列：开启队列后依次复制多项，再用 Ctrl + V 或 ⌘ + V 按顺序粘贴，例如填入多个表单字段。
• 拖放：把文本、链接、图片或文件拖入支持的应用，多文件记录可一起拖动。
• 多显示器：面板会跟随当前工作的屏幕。

默认快捷键

操作	Windows	macOS
显示 / 隐藏面板	Alt + V	Option + V
切换粘贴队列	Alt + Shift + V	Option + Shift + V
在面板内搜索	Ctrl + F	⌘ + F
选择上一张 / 下一张卡片	← / →	← / →
预览选中卡片	Space	Space
删除选中记录	Delete	Backspace
粘贴选中卡片	Enter	Enter
以纯文本粘贴	Shift + Enter	Shift + Enter

面板、队列和纯文本粘贴的快捷键可在设置中修改；删除键固定，且只在面板中生效。

界面设置

• 外观与语言：跟随系统主题，或选择浅色 / 深色模式；支持英文与简体中文切换。
• 启动与后台行为：在设置中配置开机启动、托盘与后台选项。
• 面板状态：可选择在重新打开面板时记住搜索内容、选中的标签页和滚动位置。

本地存储与隐私

• 记录控制：可排除指定来源应用或暂停记录；敏感内容保护会跳过系统标记的敏感内容，但不会自动识别所有密码或机密。
• 存储与清理：可选择历史存储文件夹、查看占用空间，并按时间清理旧记录。
• 历史迁移：可在 Windows 与 macOS 安装之间手动导出 / 导入历史归档，不包含自动云同步。归档含剪贴板内容，需妥善保管。
• 网络访问：链接自动预览默认开启，会请求目标网页获取标题与图片，可在设置中关闭；打开网页预览也会访问该站点。更新检查与下载会连接发布服务。

安装与使用

从 Releases 下载对应安装包：

平台	系统要求	下载
Windows · x64	Windows 10 1709+ / Windows 11，需要 WebView2	安装包 .exe / 便携版 .zip
macOS · Apple silicon	macOS 11 或更高	Apple silicon .dmg
macOS · Intel	macOS 11 或更高	Intel .dmg

从源码构建需安装 Node.js（见 .node-version）、npm 11、Rust（见 Cargo.toml 中的 rust-version）以及 Tauri 平台依赖：

git clone https://github.com/Loxonl/vPaste-desktop.git
cd vPaste-desktop
npm ci
npm run dev:debug

npm run dev:debug 会在 Windows 或 macOS 上运行带开发用教程与测试工具的桌面应用；npm run dev 只运行前端，不提供原生剪贴板集成。

注意事项

• macOS 自动粘贴需要辅助功能权限，可在「系统设置 → 隐私与安全性 → 辅助功能」中启用 vPaste；若自动粘贴失败，可按应用内提示用 ⌘ + V 手动粘贴。
• 文件记录引用磁盘上的原始文件，移动或删除原文件会导致无法预览、粘贴或拖放；导出剪贴板历史不能替代原文件的备份。
• 目前官方支持的桌面平台为 Windows 和 macOS，没有官方 Linux 版本。

---

本作品整理自 GitHub 开源项目 Loxonl/vPaste-desktop，原作者 @Loxonl，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。