千万级本地图库秒级以图搜图实战：ImageSearch拖图即搜与EXIF隐私清理全攻略-平芜编程栈

千万级本地图库秒级以图搜图实战：ImageSearch拖图即搜与EXIF隐私清理全攻略

【免费下载链接】ImageSearch基于.NET10的本地硬盘千万级图库以图搜图案例Demo和图片exif信息移除小工具分享项目地址: https://gitcode.com/gh_mirrors/im/ImageSearch

晚上十点，设计师老周对着屏幕叹了口气。客户要"背景是海边、构图里有灯塔"的那张老照片做延展，他翻了快一个钟头，文件夹点开又合上——上万张素材，文件名全是IMG_20210809_204817.jpg这种天书，Windows 自带搜索只认文件名，一个字都搜不出来。他盯着桌面发呆，心想：要是能"拿一张图去找图"就好了。

巧了，还真有这种东西，而且就藏在下面这个叫ImageSearch的开源项目里。

揭晓答案：一个仓库，打包了两个救命的本地小工具

ImageSearch 是基于 .NET 10 开发的本地图片工具集，它不联网、不上传，所有运算都在你硬盘里完成。仓库里躺着两个互不干扰的小工具：

以图搜图：给图库建立索引，把示例图拖进窗口，秒级吐出相似结果；
ExifStraper：命令行小工具，批量抹掉照片里的 GPS、相机型号、作者等 EXIF 隐私信息。

一个是"找图的"，一个是"护隐私的"，都完全开源免费，Windows 7 及以上、装上 .NET 10 Desktop 运行时就能跑。

最快上手：5 分钟跑通第一次"拖图即搜"

按下面四步走，你的第一次搜索马上就能出结果：

获取代码

git clone https://gitcode.com/gh_mirrors/im/ImageSearch cd ImageSearch

恢复依赖（会下载所需组件，等它转完就行）

dotnet restore 以图搜图/以图搜图.csproj

编译整个解决方案

dotnet build 以图搜图.sln -c Release

启动主程序

cd 以图搜图/bin/Release/net10.0-windows/ 以图搜图.exe

程序起来后，把图库文件夹拖进"目录"框，等索引建完，再把你手头那张示例图拖进"图片"框，回车。结果列表就出来了，双击任意一条还能直接打开原图。

内功心法：它凭什么秒级找到"长得像"的图？

你可以把每张图想象成一个"人的脸"，算法做的事就是给这张脸取一个数字指纹——专业术语叫图像哈希。不管图片被压缩、调色还是加了小水印，指纹的核心特征都还在，比对指纹就能算出相似度。

主程序内置三把不同精度的"尺子"：

DifferenceHash：跑得最快，适合海量图库快速初筛；
DctHash32：速度与准确度兼顾，日常用它最省心；
DctHash64：最精细，适合设计稿查重这种高精度需求。

相似度阈值默认卡在 70%，这是作者反复测试得出的经验值——低于这个数，肉眼看上去已经完全不是一张图了，再往下搜纯属浪费算力。

实战演示：从找图到清隐私，跟着走一遍

我们模拟老周的完整工作流。他先把那堆素材按"2023-婚礼""2023-旅拍"分好文件夹，一次性拖进图库目录，索引进度条滚了一会儿就完成了。他把手机上随手拍的灯塔样图传到电脑，复制后回到程序里直接Ctrl+V，秒级弹出一串结果，相似度从高到低排得明明白白。

这里来了个小插曲——他要的那张原图是旋转过的竖构图，前两次搜索结果里愣是没有。他差点以为程序不靠谱，结果发现界面上有个"检查旋转"的选项没勾。勾上再搜，那张转了 90° 的照片立刻出现在结果第一位。原来算法默认只比对正放的指纹，勾选后会自动把 90°、180°、270° 的旋转变体都算一遍。

找到图，活还没干完。老周记得他拍的那张照片里带 GPS，直接交付给客户等于把拍摄地都送出去了。他打开第二个工具：

cd Straper dotnet build Straper.csproj -c Release Straper.exe "D:\个人照片"

把整个相册目录甩给它，GPS 经纬度、相机型号、作者版权、IPTC/XMP 元数据被一口气抹干净，连文件夹名里的繁体字都被顺手转成了简体。跑完再去右键看文件属性，信息栏干干净净。

进阶玩法：配置项与 HTTP API，把搜图变成"本地搜索服务"

主程序目录下的config.ini握着三个开关：

[Global] IndexAutoUpdate=true ; 启用后每小时自动更新一次索引 RunServer=false ; 改成 true 开启 HTTP 服务 HttpPort=5000 RunAsAdmin=true ; 管理员模式可能导致网页拖拽失效

把RunServer改成true再启动，程序就会在 5000 端口挂起一个本地接口，访问http://localhost:5000/api还能看到交互式文档。主要就两个接口：

PATCH /index?dir=目录&removeInvalid=true：创建或更新指定目录的索引；
POST /search：上传图片并搜索，支持similar（相似度）、algorithm（1 是 DifferenceHash，2 是 DctHash32，4 是 DctHash64，7 是全部）、checkRotated（查旋转）等参数。

配合几行 Python，就能把搜图接进自己的自动化流程：

import requests resp = requests.post( "http://localhost:5000/search", files={"file": open("query.jpg", "rb")}, data={"similar": 75, "algorithm": 7, "checkRotated": True} ) for item in resp.json(): print(f"相似度: {item['匹配度']:.2%} 路径: {item['路径']}")

ExifStraper 那边还有个更省事的玩法：执行Straper.exe reg-menu注册右键菜单，之后在任何文件夹或图片上右键，一键就能调用清理，全程不用开命令行。想更彻底，加-a参数开启"全部字段清除"的暴力模式。

避坑速查：最常见的四个坑，一句话解法

现象	一句话解法
第一次搜索特别慢	是在建索引，耐心等一次，之后秒级响应
相似图搜不出来	阈值太高，降到 70～75 再试
混进一堆无关图	阈值太低，拉回 80～85
旋转过的图找不到	搜索时勾上"检查旋转"

另外，如果你装了 Everything，程序会自动调用它来加速目录扫描；不想要这个联动，把程序目录下的Everything64.dll删掉即可。程序默认会自动请求管理员权限，如果发现网页拖拽搜索不生效，多半是 UAC 的限制，在config.ini里把RunAsAdmin改成false就好。