Copyous:现代GNOME剪贴板管理器,一文看懂7种剪贴板内容的终极管理方案
Copyous:现代GNOME剪贴板管理器,一文看懂7种剪贴板内容的终极管理方案
Copyous 是一款为 GNOME 桌面打造的现代剪贴板管理器(Clipboard Manager),以 GNOME Shell 扩展的形式运行,能自动记录并管理你复制过的 7 种剪贴板内容:文本、代码、图片、文件、链接、字符和颜色。它自带搜索、固定收藏、彩色标签分组、隐身模式与高度可定制界面,一次安装,让每次复制都不再丢失。
一、Copyous 能做什么?
传统系统剪贴板只能保存"上一次"复制的内容,Copyous 则把历史内容全部存下来,并且按内容类型智能分类展示:
- 📋 7 种内容类型:文本、代码、图片、文件、链接、字符、颜色,各自有专属卡片式预览
- 📌 固定收藏:重要内容一键置顶,永不清除
- 🏷️ 9 色标签:给条目打彩色标签,分组管理
- 🕶️ 隐身模式:复制敏感信息时不写入历史
- ⚡ 自定义动作:为不同内容类型绑定快速操作
- 🔌 DBus 接口:可通过命令或脚本自动化控制
- 🗄️ 本地持久存储:历史保存在本机 SQLite 数据库中(依赖 Libgda)
整体架构入口在 src/extension.ts,设置界面逻辑位于 src/prefs.ts。
二、三种快速安装方式
安装前,需要两个运行依赖:Libgda 5.0/6.0(含 SQLite 支持) 和 GSound:
| 发行版 | 安装命令 |
|---|---|
| Fedora | sudo dnf install libgda libgda-sqlite |
| Arch Linux | sudo pacman -S libgda6 |
| Ubuntu/Debian | sudo apt install gir1.2-gda-5.0 gir1.2-gsound-1.0 |
| openSUSE | sudo zypper install libgda-6_0-sqlite typelib-1_0-Gda-6_0 typelib-1_0-GSound-1_0 |
方式一:从 GNOME 扩展商店安装(推荐)
在"GNOME 扩展"网站搜索 Copyous 并点击启用即可,更新最省心。
方式二:从 Release 版本离线安装
- 下载最新的
copyous@boerdereinar.dev.zip - 执行安装命令:
gnome-extensions install -f ~/Downloads/copyous@boerdereinar.dev.zip
- 注销并重新登录,然后启用扩展:
gnome-extensions enable copyous@boerdereinar.dev
方式三:从源码构建
前置工具:Make、Node.js、pnpm、jq。克隆仓库后构建:
git clone --recurse-submodules https://gitcode.com/gh_mirrors/co/copyous
cd copyous
pnpm install
构建流程定义在 Makefile 中,完成后同样注销重启会话并启用扩展。
三、7 种剪贴板内容,逐个看懂
Copyous 的核心亮点在于对每种内容都做了"专属卡片"渲染,源码统一放在 src/lib/ui/items/ 目录:
1️⃣ 文本(Text)
最常见的段落、句子都会自动归档。文本卡片支持换行显示,还能在底部展示字数统计,并可自定义 Tab 宽度。实现见 src/lib/ui/items/textItem.ts。
2️⃣ 代码(Code)
复制一段代码时,Copyous 会自动识别语言并用 highlight.js 做语法高亮,卡片里直接看到彩色代码。语言列表和 highlitht.js 路径在 src/lib/common/constants.ts 中配置,渲染逻辑见 src/lib/ui/items/codeItem.ts。
3️⃣ 图片(Image)
截图、复制的图片会以缩略图预览展示,并标注尺寸信息(如 2560 × 1440),可直接查看、复制回剪贴板。实现见 src/lib/ui/items/imageItem.ts。
4️⃣ 文件(File / Files)
复制文件时,卡片显示文件图标、路径和大小;支持单个文件,也能智能合并一次复制的多个文件为一组显示(自动计算公共目录)。实现分别在 src/lib/ui/items/fileItem.ts 和 src/lib/ui/items/filesItem.ts。
5️⃣ 链接(Link)
复制 URL 时,Copyous 会联网抓取网页元数据(标题、描述、缩略图),把一条光秃秃的链接变成带图文的卡片;还可以直接生成二维码查看。元数据抓取逻辑在 src/lib/misc/link.ts,卡片与二维码对话框分别见 src/lib/ui/items/linkItem.ts 和 src/lib/ui/components/qrCodeDialog.ts。
6️⃣ 字符(Char)
复制单个字符或表情时,会以大号字醒目展示,方便快速辨认和二次插入。实现见 src/lib/ui/items/characterItem.ts。
7️⃣ 颜色(Color)
复制十六进制颜色值(如 #FF6600)时,卡片会渲染成对应颜色的色块,颜色值直接印在色块上,取色、调色一眼可见。实现见 src/lib/ui/items/colorItem.ts。
四、快捷键速查:5 个最常用组合
打开剪贴板主界面的方式是 Super + Shift + V,之后基本可以全程键盘操作:
| 操作 | 快捷键 |
|---|---|
| 打开剪贴板对话框 | Super Shift V |
| 开启/关闭隐身模式 | Super Shift Ctrl V |
| 复制条目(粘贴) | Enter 或 Space |
| 执行默认动作 | Ctrl Enter 或 Space |
| 固定/取消固定 | Ctrl S |
| 删除条目 | Delete(按住 Shift 强制删除) |
| 在条目间移动 | Tab / ↑ ↓ / ← → / Home / End |
| 快速跳到第 N 个条目 | Ctrl 0…9 |
| 仅搜索固定条目 | Alt |
| 循环切换内容类型筛选 | Ctrl Tab |
所有快捷键都可以在设置中重新绑定,快捷键管理逻辑位于 src/lib/misc/shortcuts.ts。
五、进阶玩法:固定、标签与 DBus 自动化
- 📌 固定保护:固定(Pin)或带标签的条目默认受保护,清空历史时不会被误删,对应开关是
protect-pinned/protect-tagged设置项,逻辑见 src/lib/ui/items/clipboardItem.ts。 - 🕶️ 隐身模式:开启后复制的内容不会写入历史,适合处理密码、令牌等敏感信息。
- 🔌 DBus 自动化:通过
org.gnome.Shell.Extensions.Copyous服务可以编程式地打开/关闭对话框、清空历史(支持只清未固定的条目),实现见 src/lib/common/dbus.ts,例如:
gdbus call --session \
--dest org.gnome.Shell.Extensions.Copyous \
--object-path /org/gnome/Shell/Extensions/Copyous \
--method org.gnome.Shell.Extensions.Copyous.Toggle
- 📝 自定义动作:可为每种内容类型配置"默认动作"(如打开文件、插入链接等),配置界面位于 src/lib/preferences/actions/。
六、高度可定制:让它变成你的风格
设置面板通过 gnome-extensions prefs copyous@boerdereinar.dev 打开(也可从顶部面板指示器打开)。Copyous 提供了分组清晰的定制页面:
- 通用设置:历史记录条数、打开位置(鼠标指针/文本光标)、行为反馈(声音与通知)等,见 src/lib/preferences/general/
- 条目外观:每种内容类型都有独立的定制页(宽度、高度、预览类型、信息显示),位于 src/lib/preferences/customization/items/
- 主题与对话框:可跟随 Yaru 主题、自定义对话框外观,见 src/lib/preferences/customization/themeCustomization.ts
- 快捷键:对话框、条目、导航、菜单、搜索五大类快捷键全部可改,位于 src/lib/preferences/shortcuts/
七、写在最后
Copyous 用"卡片式 + 类型识别"的设计,把 GNOME 的剪贴板体验提升了一个档次:文本看全文、代码有高亮、图片有缩略图、链接带网页信息、颜色直接显示色块。它开源(GPLv3+)、轻量、完全本地存储,且支持 DBus 自动化,是 GNOME 用户值得一试的免费剪贴板管理方案。
如果你想进一步了解贡献流程或开发细节,可以查看 CONTRIBUTING.md 和完整说明 README.md。
