Veronica 剪贴板历史:可搜索、去重、纯本地,Wayland 下也能录下每一次复制
Veronica 剪贴板历史:可搜索、去重、纯本地,Wayland 下也能录下每一次复制
Veronica 剪贴板历史 是一个面向 Ubuntu / GNOME 桌面的本地剪贴板管理器:它把你复制过的每一条文本都记录在电脑上,支持模糊搜索、自动去重与次数统计,且所有数据只存本地一个 JSON 文件。更关键的是,它绕开了 Wayland 的安全限制,借助运行在合成器内部的 GNOME Shell 扩展,真正做到"每次复制都能录下来"——这是普通后台进程在 Wayland 下做不到的事。
为什么 Wayland 下剪贴板历史很难做?
在 X11 时代,任何后台程序都能偷看剪贴板,所以剪贴板管理器遍地都是。Wayland 出于安全考虑改写了规则:
- 只有获得焦点的窗口可以读取剪贴板,任何没有窗口的后台进程一律无权读取;
- 写入剪贴板同样受限,普通进程必须持有最近一次输入事件的凭证(serial)才能写入。
这意味着传统剪贴板管理器在 Wayland 下直接失效。Veronica 的解法很巧妙:让监听逻辑运行在合成器(GNOME Shell)内部。合成器是剪贴板的"所有者",天然有权限监听每一次 owner-changed 事件。相关实现见 extension/clipboard.js,其中 ClipboardWatcher 类负责监听选择变化并把新条目交给 CLI 记录。
一键安装:三步开启剪贴板捕获
- 安装 Debian 包(推荐方式,会同时装好
vr命令和 GNOME Shell 扩展):
curl -fsSL https://namannn04.github.io/Veronica/install | bash
- 注销并重新登录一次——GNOME 只在登录时加载扩展,这是唯一需要等待的步骤;
- 开始复制任意文本,它会自动出现在历史里。
也可以从源码仓库为用户安装扩展:
git clone https://gitcode.com/gh_mirrors/vero/Veronica
cd Veronica
./extension/install.sh
提示:仅运行 AppImage 无法获得剪贴板捕获,因为它不安装 GNOME Shell 扩展,需要完整集成请选用 Debian 包。
可搜索历史:桌面应用与命令行两种玩法
桌面应用:搜索框 + 一键复制
在 Veronica 的 Clipboard 页面 中:
- 顶部搜索框实时过滤历史,匹配不区分大小写;
- 每条记录显示预览文本、行数、大小和"多久之前复制";
- 去重机制会让重复复制的内容置顶并累加计数(例如
copied 3×),而不是新增一行; - 点击记录即可复制回剪贴板,单条删除(✕)或一键清空全部;
- 页面每 3 秒自动刷新,捕获到的新内容无需手动重载。
命令行:vr clipboard 全家桶
喜欢终端的用户可以走 crates/veronica-cli/src/clipboard_cmd.rs 提供的命令:
| 命令 | 作用 |
|---|---|
vr clipboard list --query 关键词 |
搜索历史,返回 id、预览、行数、复制次数 |
vr clipboard get <id> |
打印某条的完整文本,方便直接管道转发 |
vr clipboard remove <id> |
忘掉单条记录 |
vr clipboard clear |
清空全部历史 |
一个典型用法是把历史内容喂给其他工具:
vr clipboard list --query "def main"
vr clipboard get 42 | xclip -selection clipboard
顶栏下拉:最近 5 条随手取
GNOME Shell 扩展还会在顶栏下拉面板中列出最近 5 条剪贴板记录,点击即复制回去——不用打开主窗口,实现见 extension/sections.js 中的 refreshClipboardSection。
纯本地存储:数据在哪个文件、如何彻底删除
历史就是一个你随时能查看、编辑、删除的普通 JSON 文件,不存在任何云端同步或上传:
- 存储路径:
~/.local/share下的clipboard.json,路径定义见 crates/veronica-core/src/paths.rs; - 写入采用原子保存,进程中途崩溃也不会留下半截坏文件;
- 想彻底清空?删除该文件,或在应用里点"Clear all",或用
vr clipboard clear。
去重、容量上限与隐私细节
核心记录逻辑位于 crates/veronica-core/src/clipboard.rs,几个对新手友好的设计决策:
- 去重而非追加:重复复制同一段文字时,条目移到最前、
count加一,首次复制时间(first_seen)保持不变; - 条目上限 200 条:超出后最旧的自动出局,文件体积可控;
- 单条上限 64 KB:整份文件的复制内容会被跳过,避免历史文件膨胀;
- 空白内容直接忽略:焦点切换产生的空选择不会污染列表;
- 密码不会落盘:密码管理器(如 KeePassXC)复制密钥时附带
x-kde-passwordManagerHint标记,扩展在读取文本之前就检查这个 MIME 标记并直接跳过(见 extension/clipboardPolicy.js),敏感内容连进程内存都不会进入; - 回写防抖:Veronica 自己写剪贴板后的 400 毫秒内会忽略选择变化,避免把刚粘贴的内容重复记录、打乱列表顺序。
架构一览:谁负责什么
整个功能的分工非常清晰,想深入的同学可以直接阅读 docs/ARCHITECTURE.md 的 "The clipboard" 章节:
| 模块 | 职责 |
|---|---|
| extension/clipboard.js | 在合成器内监听选择变化、读取文本、写回剪贴板 |
| extension/clipboardPolicy.js | 识别密码管理类 MIME 标记,拦截敏感复制 |
| crates/veronica-core/src/clipboard.rs | 去重、计数、上限、搜索、原子存储 |
| crates/veronica-cli/src/clipboard_cmd.rs | vr clipboard 命令,扩展通过 stdin 传文本,天然免疫 shell 转义问题 |
| apps/desktop/src/pages/ClipboardPage.tsx | 桌面端搜索、复制、删除界面 |
常见问题
Q:为什么我的历史是空的?
A:确认 GNOME 扩展处于 ACTIVE 状态(gnome-extensions info veronica@namannn04.github.io),且安装后重新登录过。AppImage 用户没有捕获能力,需安装 Debian 包。
Q:复制的内容会被上传吗?
A:不会。历史只写在本机的 clipboard.json 里,没有任何网络行为。
Q:快捷键能直达剪贴板吗?
A:可以,Ctrl+Alt+B 全局快捷键直接打开剪贴板页面。
总结:Veronica 剪贴板历史用"合成器内监听 + 纯本地 JSON"的组合,在 Wayland 的安全模型内交出了完整答卷——可搜索、自动去重、密码不落盘、数据随删随走,是 Ubuntu / GNOME 用户值得试用的本地剪贴板管理方案。

