Caelestia效率工具完全指南：截图选区、OCR文字识别与剪贴板历史

Caelestia 是一个将 macOS 风格界面移植到 KDE Plasma 6 的桌面增强项目，它为日常操作提供了三大效率利器：截图选区（Screenshot Snip）、OCR 屏幕文字识别、剪贴板历史（Clipboard History）。只需三组快捷键Meta+Shift+S、Meta+Shift+D、Meta+V，你就能把"截图—识字—复制粘贴"的重复劳动压缩到两次按键之内。本文将从快捷键、操作步骤到依赖配置，带你完整掌握这套效率工具。

三大效率功能一览表

默认快捷键定义在 keybindsdefaults.hpp 中，后续均可在系统内重新绑定。

截图选区：框选即所得

按下Meta+Shift+S后，屏幕会进入选区模式：按住鼠标拖动框选出目标区域，顶部会出现一个操作工具栏，可在Screenshot（截图）、Google Lens（以图搜图）、Text Recognition（文字识别）三个模式间一键切换，还可以点亮"窗口轮廓"开关，让框选自动贴合窗口边界。这个工具栏由 OptionsToolbar.qml 实现，选区逻辑在 RegionSelector.qml 中。

确认选区后，Caelestia 会自动完成一系列操作（逻辑见 ScreenshotAction.qml）：

1. 用 ImageMagick 裁剪出选区图片；
2. 保存为screenshot-日期_时间.png，默认存入~/Pictures/Screenshots目录；
3. 将图片写入剪贴板，随时可以Meta+V粘贴到聊天或文档中；
4. 弹出通知，点击通知可直接"打开图片"或"打开所在文件夹"。

💡 小技巧：如果选完后还想画箭头、打码，可在 Utilities 面板的Screen Capture卡片中查看最近截图记录。该卡片（CaptureCard.qml）还提供全屏截图、活动窗口截图、以图搜图等入口，底层调用 KDE 自带的 Spectacle 作为兜底方案。

OCR 文字识别：框住屏幕上的字，一键变文本

无法复制的 PDF 截图、游戏说明、验证码预览……只要是屏幕上看得见的文字，OCR 都能帮你"抠"出来。

使用步骤：

1. 按下Meta+Shift+D，屏幕进入选区模式；
2. 框住包含文字的屏幕区域并确认；
3. 识别完成，文字自动进入剪贴板，同时弹出通知预览识别结果。

背后的处理流程（ScreenshotAction.qml）相当讲究：先用 ImageMagick 把选区转灰度、增强对比度并放大 3 倍，显著提高识别率；再自动检测系统中安装的所有 tesseract 语言包，一次性识别多语言混排内容，最后将纯文本写入剪贴板并弹出Text Recognized通知。

⚠️注意：OCR 依赖tesseract引擎，安装脚本（如 packages.sh 中的tesseract tesseract-data-eng）已默认装好。若识别中文不准，请额外安装对应的语言数据包（如tesseract-data-chi_sim）。

剪贴板历史：复制过的文字图片永不丢失

在 Linux 上，粘贴一次后剪贴板内容就会被新复制的内容覆盖。Caelestia 通过cliphist解决了这个痛点，让每次复制（文字或图片）都被记入历史。

打开方式：按下Meta+V，Launcher 会自动以clipboard模式启动，直接展示历史列表（快捷键逻辑见 Shortcuts.qml）。列表功能包括：

• 📋点击即复制：点中任意条目，内容立刻回到剪贴板，并弹出"已复制"提示；
• 📌置顶固定：点击条目右侧的图钉图标，可把常用内容固定在最上方，不会被新内容挤走；
• 🖼️图片预览：复制过的图片会以缩略图形式展示在列表中；
• 🧹一键清空：可清除全部历史，设置中可选择"清空前是否确认"。

剪贴板历史面板的设置位于 LauncherPanel.qml：最多可保存1~2048 条记录，还支持 Vim 风格按键（Ctrl+hjkl）在列表中导航，键盘党狂喜。

剪贴板历史的后台服务原理

历史功能依赖一个后台用户服务cliphist.service，由安装脚本 04-deploy-kde.sh 自动创建。它同时运行三个小组件：

• 两个wl-paste --watch监听器：分别盯住文字和图片的剪贴板变化，实时写入cliphist数据库；
• 一个wl-clip-persist：负责在应用退出后"续命"剪贴板内容，防止复制的图片/文字被覆盖丢失。

如果哪天复制粘贴行为异常，可用systemctl --user status cliphist.service检查服务状态，详细排查方法见官方 TROUBLESHOOTING.md。

常见问题（FAQ）

Q1：按下Meta+Shift+S没有反应？检查是否与其他程序的快捷键冲突，可通过Meta+/打开快捷键设置页面重新绑定；区域截图相关快捷键（如regionScreenshot）默认留空，可在同一页面自行分配。

Q2：OCR 识别结果是乱码或空？确认已安装 tesseract 及所需语言包：tesseract --list-langs查看可用语言。识别中文需安装tesseract-data-chi_sim（Arch）或tesseract-ocr-chi-sim（Debian/Fedora 系）。

Q3：剪贴板历史列表是空的？提示 "cliphist not found" 说明缺少依赖，重新运行安装脚本即可。Debian 系发行版若 apt 中无 cliphist，脚本会自动从上游下载二进制安装（见 packages.sh）。

Q4：截图保存到哪里？默认目录为~/Pictures/Screenshots（定义于 userpaths.hpp），文件名自带时间戳，方便按时间检索。

写在最后

截图选区、OCR 文字识别、剪贴板历史，这三项功能覆盖了桌面工作流中最高频的"取素材"场景。Caelestia 的巧妙之处在于：每个功能都不需要打开任何设置窗口，一组快捷键直达——这正是效率工具该有的样子。更多功能（如仪表盘、AI 助手、侧边栏）欢迎继续阅读 README.md 探索。