Copyous如何监听系统剪贴板?源码解析剪贴板监控与内容去重实现
Copyous如何监听系统剪贴板?源码解析剪贴板监控与内容去重实现
Copyous 是一款面向 GNOME 的现代剪贴板管理器(Clipboard Manager),它能实时监听系统剪贴板变化,自动把文本、代码、图片、文件、链接等内容保存为历史,并通过 MD5 校验和 + 数据库去重避免重复记录。下面带你从源码角度拆解: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 件事:
- 过滤:只处理
SELECTION_CLIPBOARD(真正的复制粘贴板),忽略鼠标拖选等其它选择。 - 读取内容:按 MIME 类型尝试读取图片 → 文件 → 文本,得到统一的
ClipboardContent。 - 计算指纹:调用
contentChecksum(clipboard.ts),对文本/文件路径/图片数据分别做 MD5 校验和。 - 第一层去重:和上一次记录的指纹比对,若完全一致则直接
return。 - 入库 + 广播:通过
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 命名)存储——不同后端都能用同一套逻辑判断"是否重复"。
四、完整链路串起来
把上面几步连起来,一条剪贴板记录的生命周期是这样的:
Ctrl+C→ GNOME 剪贴板所有权变化 → 触发owner-changed信号ownerChanged读取内容、算出 MD5 指纹- 第一层:与"上一次指纹"比对,拦掉相邻重复
- 检查隐私模式 / 应用排除(
shouldSave),决定是否入库 - 第二层:
selectConflict查库,命中旧记录则只刷新时间,否则新建 emit('clipboard')→ 界面刷新、系统托盘动画、通知与提示音
这套"事件驱动 + 双层去重"的设计,既避免了高频复制时的重复刷屏,又让历史记录干净有序——这也是 Copyous 作为剪贴板管理器的核心竞争力。
小结
- 监听:靠
Meta.Selection的owner-changed信号,纯事件驱动,无需轮询。 - 去重:双层防护——内存层用"上一次 MD5 指纹"防抖,数据库层用
selectConflict查"类型 + 内容"冲突,命中即刷新时间而非新增。 - 可移植:SQLite / JSON / 内存三种后端共享同一接口,换存储不影响去重逻辑。
想继续深入,可以从 src/lib/misc/clipboard.ts 的 ClipboardManager 入手,再顺着 entryTracker 和 src/lib/database/ 下的数据库实现,就能看到整条数据流的全貌了。
