rclip

简要说明#

rclip 是一个命令行工具，用来在本地照片库中做语义搜索。你在终端里输入 rclip "两只鹦鹉在树枝上"，它会从你的照片文件夹里找出内容最匹配的图片，按相似度排序输出。所有处理在本地完成，不上传任何数据。

项目从 2021 年开始开发，MIT 许可，在 GitHub 上接近 1000 星。2026 年 6 月发布的 v3 版本把搜索速度提升了 4 到 6 倍。

介绍#

为什么需要这样一个工具#

大部分人整理照片的方式是按文件夹归档——按日期、按事件。这种结构在平时够用，但当你记得有张照片但记不清什么时候拍的时候，就不好办了。逐个文件夹翻过去，尤其是有几万张照片的情况下，很费时间。

传统的图片管理软件依赖标签或关键词，但需要手动标记。系统相册的搜索功能有时候能靠人脸或地点匹配，但做不到用任意文字描述来找图。

rclip 解决的就是这个问题：不需要整理、不需要打标签，装一个命令就能搜。它用的模型是 OpenCLIP（OpenAI CLIP 的开源实现），能理解图片内容和文字描述之间的语义关系。

怎么用#

安装很简单，pip 一行命令：

pip install rclip

Linux 也可以用 Snap 或 AppImage，macOS（Apple Silicon）和 Windows 都支持 pip 安装。

首次运行需要在一个目录下建立索引，之后增量和更新都很快。

基本用法：

# 文字搜图
rclip "日落时分的海滩"

# 以图搜图
rclip ./photo.jpg

# 组合搜索（2张金毛 + 游泳池场景 - 水果）
rclip "2:golden retriever" + "./pool.jpg" - fruit

# 终端内预览
rclip --preview "猫咪"

# 管道输出供其他工具处理
rclip -f "搜索词" | head -5 | xargs -I{} cp {} /目标目录

--preview 可以在支持图片显示的终端（iTerm2、Konsole、wezterm 等）里直接看结果缩略图。-f 只输出文件路径，方便接到其他工具做进一步操作。

索引性能#

首次索引的速度取决于图片数量和硬件。开发者测试了几种场景：

• NAS（Intel Celeron J3455），约 8.5 万张照片 → 约 15 小时完成首次索引
• MacBook M1 Max，5 万张 → 约 7 分钟
• MacBook M1 Max，128 万张 → 约 3 小时

v3 版本将文本搜索速度提升约 4 倍，图片搜索提升约 6 倍。在 M1 Max 上搜索约 0.5 秒出结果。

后续运行只索引新增和删除的图片，不需要重新全量扫描。

支持的图片格式#

常用格式都支持：JPG、PNG、WebP、HEIC、TIFF、GIF、BMP、JP2 等。实验性支持 RAW（ARW、CR2、DNG），如果同一目录下有同名的 JPEG 文件会优先用 JPEG。

使用场景#

rclip 最适合已经有大量本地照片、并且习惯用终端的用户。几个典型的用法：

• NAS 照片库搜索：在自托管的 NAS 上装一个 rclip，SSH 连上去就能搜，不需要跑一个 Web 应用
• 素材库检索：设计师或内容创作者从积累的图片素材里按主题找图
• 管道集成：把搜索结果直接送给其他工具——复制到文件夹、批量重命名、作为其他脚本的输入
• 隐私优先的场景：完全离线，照片不上传云端

与同类工具的差异#

语义搜图的方案其实不少，但大多集成在相册应用中：

• PhotoPrism / Immich 是自托管的完整相册方案，功能全面但部署重，需要跑 Web 服务、数据库
• Google Photos 搜索体验好但要上传到云端
• Adobe Lightroom 也有 AI 搜索但需要付费订阅

rclip 走的是另一个方向：不做相册、不做管理、不搞界面，只提供一个命令。它的设计思路更像 grep——grep 搜文字，rclip 搜图片。这种”单点工具”的定位既让它在功能上很简单，也让它在不需要 GUI 的环境中很灵活。

如果已经有自己的照片管理流程，不想再引入一个应用层，rclip 比较合适。

注意事项#

• rclip 需要下载 OpenCLIP 模型（约 1-2GB），首次运行时会自动下载
• 照片数量很大时首次索引耗时较长，建议放在夜间或空闲时间跑
• 搜索结果依赖模型对图片内容的理解，不是所有描述都能准确匹配
• 当前是 CLI 工具，没有图形界面。--preview 功能也只在部分终端中可用