Copyous如何监听系统剪贴板?源码解析剪贴板监控与内容去重实现

原创2026-11-07 15:41:001,895 阅读

Copyous如何监听系统剪贴板?源码解析剪贴板监控与内容去重实现

Copyous 是一款面向 GNOME 的现代剪贴板管理器(Clipboard Manager),它能实时监听系统剪贴板变化,自动把文本、代码、图片、文件、链接等内容保存为历史,并通过 MD5 校验和 + 数据库去重避免重复记录。下面带你从源码角度拆解:Copyous 是如何"监听"剪贴板,又是如何实现内容去重的。

Copyous 剪贴板管理器主界面,展示文本、代码、图片、文件、链接等剪贴板历史记录列表

一、监听的核心:owner-changed 信号

在 GNOME 里,剪贴板并不是一个"可以随时读取"的存储,而是一个拥有者模型——每次 Ctrl+C,剪贴板的"所有权"都会转移给发起复制的应用。Copyous 正是抓住了这一点。

在 clipboard.ts 中,ClipboardManager 拿到全局的 Meta.Selection 对象后,只登记了一个信号:

this.selection = global.display.get_selection();
this.signalId = this.selection.connect('owner-changed', this.ownerChanged.bind(this));

也就是说:只要系统剪贴板的所有权发生切换,ownerChanged 回调就会被触发,这正是"剪贴板监控"的入口。整个监控流程非常轻量,几乎没有轮询,完全靠事件驱动。

二、ownerChanged:从信号到一条剪贴板记录

回调处理函数 ownerChanged(clipboard.ts)按顺序做了 5 件事:

  1. 过滤:只处理 SELECTION_CLIPBOARD(真正的复制粘贴板),忽略鼠标拖选等其它选择。
  2. 读取内容:按 MIME 类型尝试读取图片 → 文件 → 文本,得到统一的 ClipboardContent。
  3. 计算指纹:调用 contentChecksum(clipboard.ts),对文本/文件路径/图片数据分别做 MD5 校验和。
  4. 第一层去重:和上一次记录的指纹比对,若完全一致则直接 return。
  5. 入库 + 广播:通过 tracker.insert(...) 写入数据库,并 emit('clipboard', entry) 通知界面刷新。

其中第一层去重是最关键的"防抖"设计:

const checksum = contentChecksum(content); // 计算 MD5
if (this.prevClipboard) {
  const [type, prevChecksum] = this.prevClipboard;
  if (type === content.type && prevChecksum === checksum) {
    return; // 与上一次完全相同,直接忽略
  }
}

这解决了 GNOME 的一个常见"坑":某些应用会在复制后反复释放/接管剪贴板,导致同一段内容被反复触发。用"上一次指纹"比对后,Copyous 就能在内存层面第一时间拦掉重复项。

三、第二层去重:数据库层的"冲突检测"

指纹防抖只盯着"相邻两次",而历史里更早的重复项,要靠数据库去重兜底。

ClipboardEntryTracker.insert(entryTracker.ts)在真正插入前,会先做一次冲突查询:

const id = await this._database?.selectConflict({ type, content });
if (id) {
  const trackedEntry = this._entries.get(id);
  if (trackedEntry) {
    trackedEntry.datetime = GLib.DateTime.new_now_utc(); // 命中旧记录:只刷新时间
    return null;                                          // 不新建条目
  }
}

逻辑很清晰:如果这条"类型 + 内容"在历史里已经存在,就不新建记录,而是把它的时间戳更新为当前时间,让它"上浮"到列表顶部。这既保证了列表不出现重复,又让最近用过的内容始终排在最前。

三种后端,同一个 selectConflict 接口

Copyous 支持 SQLite、JSON、内存三种数据库后端(见 entryTracker.ts),它们都实现了统一的 selectConflict 接口(database.ts):

后端 去重实现方式 源码位置
SQLite WHERE type == ? AND content == ? LIMIT 1 gda.ts
JSON 继承内存版,按唯一键查表 json.ts
内存 用 类型:内容 作为 Map 的 key memory.ts

以最直观的内存后端为例,它把"类型 + 内容"拼成唯一键(memory.ts):

entryToKey(entry) {
  return `${entry.type}:${entry.content}`; // 例如 "Text:hello world"
}

而 SQLite 后端则翻译成一条标准查询:

SELECT id FROM clipboard WHERE type == ? AND content == ? LIMIT 1;

💡 可以看到,去重的"指纹"始终是 类型 + 完整内容。这也解释了为何 Copyous 对文本做内容比对、对图片按落盘文件(以 MD5 命名)存储——不同后端都能用同一套逻辑判断"是否重复"。

四、完整链路串起来

把上面几步连起来,一条剪贴板记录的生命周期是这样的:

  1. Ctrl+C → GNOME 剪贴板所有权变化 → 触发 owner-changed 信号
  2. ownerChanged 读取内容、算出 MD5 指纹
  3. 第一层:与"上一次指纹"比对,拦掉相邻重复
  4. 检查隐私模式 / 应用排除(shouldSave),决定是否入库
  5. 第二层:selectConflict 查库,命中旧记录则只刷新时间,否则新建
  6. emit('clipboard') → 界面刷新、系统托盘动画、通知与提示音

这套"事件驱动 + 双层去重"的设计,既避免了高频复制时的重复刷屏,又让历史记录干净有序——这也是 Copyous 作为剪贴板管理器的核心竞争力。

小结

  • 监听:靠 Meta.Selection 的 owner-changed 信号,纯事件驱动,无需轮询。
  • 去重:双层防护——内存层用"上一次 MD5 指纹"防抖,数据库层用 selectConflict 查"类型 + 内容"冲突,命中即刷新时间而非新增。
  • 可移植:SQLite / JSON / 内存三种后端共享同一接口,换存储不影响去重逻辑。

想继续深入,可以从 src/lib/misc/clipboard.ts 的 ClipboardManager 入手,再顺着 entryTracker 和 src/lib/database/ 下的数据库实现,就能看到整条数据流的全貌了。

登录后查看全文
copyous