Clippy Land：COSMIC 剪贴板历史面板

项目简介

Clippy Land 是一个 COSMIC 桌面的 panel applet（面板小程序），用来保存最近复制的文本和图片历史。你可以搜索历史、固定条目，并在复制前预览文本或图片。界面配色跟随你的 COSMIC 主题。

主要功能

• 保存最近的剪贴板条目（文本 + 图片），数量上限可配置
• 单击或按 Enter 复制条目，可选择自动粘贴到之前聚焦的应用，并自动关闭弹窗
• 删除单条历史记录
• 将重要条目固定到历史顶部，固定条目在应用重启后仍然保留，固定数量可配置
• 弹窗内的设置面板可即时调整：最大历史条目数、最大固定条目数、最大图片字节数、最大图片尺寸、选择后是否粘贴、选择后是否关闭弹窗
• 统一的历史列表：文本条目显示最多四行摘录，图片使用等比缩略图；眼睛按钮打开完整文本或大图预览，图片预览显示原始尺寸、格式与文件大小
• 键盘操作：用 up/down 或 k/j 上下移动，用 left/right 或 h/l 在行内动作（复制、预览、固定、删除）间切换；预览中按 Q 关闭，按 Esc 从预览、设置或关于返回历史，再按一次关闭弹窗
• 关于页面显示版本、作者、源码仓库、issue tracker 与许可证
• 支持通过 --toggle 配合自定义快捷键打开历史

安装与使用

可从 COSMIC Store 的 COSMIC Applets 分类安装，也提供 Flatpak、Debian/Ubuntu .deb 和 Fedora RPM 包。

Fedora 可通过 COPR 安装：

sudo dnf copr enable kordus/cosmic-applets
sudo dnf install cosmic-applet-clippy-land

安装后打开 COSMIC Settings → Desktop → Panel → Applets，把 "Clippy Land" 添加到面板；如果列表里看不到，可能需要注销后重新登录。

点击面板图标打开历史，选中条目即可复制。设置快捷键时，在 COSMIC Settings → Keyboard → Custom Shortcuts 新建快捷键，命令填：

cosmic-applet-clippy-land --toggle

Flatpak 安装则使用 flatpak run io.github.k33wee.clippy-land --toggle。二进制还支持 --standalone（启动时强制打开弹窗）和 --no-standalone（关闭自动打开）。

注意事项

• 配置文件位于 ~/.config/clippy-land/config.toml（或 $XDG_CONFIG_HOME/clippy-land/config.toml），可通过 CLIPPY_LAND_CONFIG 覆盖。
• 只有固定的条目会被持久化，未固定的历史仅存在于运行时；固定历史默认存放在 ~/.local/state/clippy-land/pinned-history.toml，可用 CLIPPY_LAND_PINNED_HISTORY 覆盖。
• 自动粘贴需要合成器提供 zwp_virtual_keyboard_v1 协议；不可用时仍会复制条目并关闭弹窗，但不会注入粘贴快捷键。终端类应用会使用 Ctrl+Shift+V，其余应用使用 Ctrl+V。
• 受 COSMIC 面板当前限制，非点击方式打开弹窗不受原生支持，--toggle 会以 layer surface 形式打开历史，并尽量定位到当前窗口或活动显示器。
• Clear History 只清除未固定的条目；要移除固定条目，请先取消固定或直接删除该条目。

---

本作品整理自 GitHub 开源项目 k33wee/clippy-land，原作者 @k33wee，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。