Veronica 剪贴板历史:可搜索、去重、纯本地,Wayland 下也能录下每一次复制

原创2026-11-06 12:28:072,175 阅读

Veronica 剪贴板历史:可搜索、去重、纯本地,Wayland 下也能录下每一次复制

Veronica 剪贴板历史 是一个面向 Ubuntu / GNOME 桌面的本地剪贴板管理器:它把你复制过的每一条文本都记录在电脑上,支持模糊搜索、自动去重与次数统计,且所有数据只存本地一个 JSON 文件。更关键的是,它绕开了 Wayland 的安全限制,借助运行在合成器内部的 GNOME Shell 扩展,真正做到"每次复制都能录下来"——这是普通后台进程在 Wayland 下做不到的事。

Veronica 桌面控制中心品牌图,包含剪贴板历史等本地功能

为什么 Wayland 下剪贴板历史很难做?

在 X11 时代,任何后台程序都能偷看剪贴板,所以剪贴板管理器遍地都是。Wayland 出于安全考虑改写了规则:

  • 只有获得焦点的窗口可以读取剪贴板,任何没有窗口的后台进程一律无权读取;
  • 写入剪贴板同样受限,普通进程必须持有最近一次输入事件的凭证(serial)才能写入。

这意味着传统剪贴板管理器在 Wayland 下直接失效。Veronica 的解法很巧妙:让监听逻辑运行在合成器(GNOME Shell)内部。合成器是剪贴板的"所有者",天然有权限监听每一次 owner-changed 事件。相关实现见 extension/clipboard.js,其中 ClipboardWatcher 类负责监听选择变化并把新条目交给 CLI 记录。

一键安装:三步开启剪贴板捕获

  1. 安装 Debian 包(推荐方式,会同时装好 vr 命令和 GNOME Shell 扩展):
curl -fsSL https://namannn04.github.io/Veronica/install | bash
  1. 注销并重新登录一次——GNOME 只在登录时加载扩展,这是唯一需要等待的步骤;
  2. 开始复制任意文本,它会自动出现在历史里。

也可以从源码仓库为用户安装扩展:

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。

Veronica 品牌视觉图,展示本地优先的 Ubuntu 控制中心

纯本地存储:数据在哪个文件、如何彻底删除

历史就是一个你随时能查看、编辑、删除的普通 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 用户值得试用的本地剪贴板管理方案。

登录后查看全文
Veronica