不用记文件名拿一张图就能翻遍整个硬盘这款开源以图搜图工具把千万级图库变成可搜索内容【免费下载链接】ImageSearch基于.NET10的本地硬盘千万级图库以图搜图案例Demo和图片exif信息移除小工具分享项目地址: https://gitcode.com/gh_mirrors/im/ImageSearch深夜十一点设计师老周盯着屏幕发了十分钟呆。甲方要的和去年那版类似的、带蓝紫渐变的产品海报就在某个硬盘里他翻了四个移动硬盘、十几个命名乱七八糟的文件夹最终一无所获。类似的场景每天都在上演摄影师要找某张客户很满意但忘了叫什么的原片宝妈想找出拍糊了但表情很好的那张电商运营想确认某张商品图是不是重复了。真正的问题不是图片太多而是图片的存在方式没有改变——它们只是一堆等待被记忆命名的文件。而今天要讲的这个基于 .NET 10 的开源项目ImageSearch以图搜图干的正是这件事把图片变成能按内容搜索的数据让本地硬盘里哪怕千万级的图库也能在一两秒内找到相似结果它还附带一个叫Straper的小工具顺手解决照片里的 EXIF 隐私信息问题。改造前的一天 vs 改造后的一天改造前找图靠记忆 文件名忘了名字就等于丢了素材堆在几十个文件夹里分类越分越乱发给客户的预览图、原片一张张翻费神费力想把照片发到网上还要担心照片里带的 GPS 定位会暴露家庭住址改造后丢一张样图进去同场景、同构图、同风格的图自动排队出来索引建好后搜索耗时以毫秒计跟图库大小基本无关旋转过、翻转过的图也能被认出来不再换个方向就不认识一个命令批量清掉所有 EXIF/IPTC/XMP 信息定位、作者、版权标记全部抹除三个最疼的痛点它逐个击破痛点一只记得画面不记得文件名这是所有图片管理工具绕不开的坎。ImageSearch 的做法不是让计算机看图片而是给每张图算出一组数字指纹搜索时拿指纹去比对。它内置三种指纹算法DifferenceHash差分哈希、DCT Hash 32和DCT Hash 64默认三种同时启用、互相印证。索引阶段每张图会被解码成 160px 的灰度小图再浓缩成一串哈希值你看到的原图细节并不参与存储——这也是索引文件极小的原因。痛点二图太多索引慢项目作者显然被索引三天三夜折磨过。ImageIndexService.cs里针对机械硬盘和 SSD 分别做了调度SSD 走高并发直读HDD 则先把文件整块预读进内存再排队处理避免磁头来回跳GIF 动图按帧拆开逐帧建索引所以连动图都能搜。索引过程实时显示速度、吞吐量、预估剩余时间甚至画出一条速度曲线索引到一半想停随时可停。痛点三方向不对就找不到照片从相机导出来随手旋转了 90°、镜像翻转了肉眼觉得就是同一张机器却容易认不出来。ImageSearch 在搜索时默认开启旋转匹配90/180/270 度也提供翻转匹配开关把横着看和竖着看当成同一件事处理。这招在整理手机照片时特别实用。跟着做一遍从克隆到第一次搜图环境要求不苛刻4 核处理器、8GB 内存起步Windows 系统开发机装 Visual Studio 2026 或 .NET 10 SDK只运行成品的话装 .NET 10 Desktop Runtime 即可。克隆仓库git clone https://gitcode.com/gh_mirrors/im/ImageSearch cd ImageSearch编译主程序dotnet build 以图搜图/以图搜图.csproj -c Release生成的可执行文件在以图搜图/bin/Release/net10.0-windows7.0/以图搜图.exe。想发布成单文件免依赖版本项目里已备好发布配置dotnet publish 以图搜图/以图搜图.csproj -p:PublishProfileFolderProfile输出到bin/Release/publish/win-x64 单文件拷到别的电脑也能跑。几个会卡住新手的坑首次运行请先添加文件夹再点更新索引否则会弹警告请先选择文件夹。索引是增量的重复点击只会补新图不会重扫全部。如果电脑上装了 Everything 且正在运行程序会自动调用它来加速目录扫描根目录的Everything64.dll起这个作用。不想要这个行为删掉这个 dll 即可。相似度最低只能调到 70——这是作者反复试验后的结论低于 70 的相似度肉眼看上去已经是完全不同的图了。选了DCT Hash 32时阈值会被强制提到 90因为它是最严苛的算法。跑起来后把一张图片拖进窗口、粘贴剪贴板里的图、甚至直接从浏览器拖 URL 进来都能发起搜索。结果列表按匹配度排序每条带文件大小、所在文件夹的图片数和总大小方便你判断这是一个孤品还是某个系列里的一张。一个完整的故事线从翻找素材到安全发图假设你是个旅行博主硬盘里躺着五年、十几万张旅行照片按年份和城市分了 40 多个文件夹。你想给新文章配一张和 2023 年青海那张日落几乎同款的图把青海那张日落照拖进 ImageSearch相似度拉到 75回车。一两秒后列表里同时出现同一机位不同时间的版本、旋转过 90 度的竖版以及一张镜像翻转的图——你差点忘了它。选中其中一张CtrlO直接在资源管理器中定位到它所在的文件夹顺手就能把周边同批次照片一起拖走。文章配图确定后打开另一个工具 Straper把整批待发布的照片文件夹拖进去回车。它会逐个清掉 EXIF 里的 GPS 定位、拍摄作者、版权描述以及 IPTC/XMP 元数据并把文件夹里繁体中文的目录名自动转成简体。图片发布到网上再也没有定位泄露家里地址的隐患。这条工作流里ImageSearch 负责找Straper 负责洗两个小工具拼成完整闭环。它为什么这么快一个厨师的比喻想象你是位盲品厨师。你不需要记住一道菜的全部做法只需把味道量化成甜度、咸度、酸度几个数字。尝过一百道菜后你手里有一本味道数字册。新上一道菜你尝一口、记下数字再翻册子找数字最接近的几道——这就是哈希检索的本质。图片也是一样任何一张图都被压成 160px 的灰度小图再换算成一组ulong数字。DCT Hash类似记录明暗变化在频域里的主旋律Difference Hash则比较相邻像素的明暗起伏像在描一条山脊线。相似度就是两组数字的吻合程度。搜索时所有比对都是纯数字运算全部并行跑在 CPU 多核上并行度是核数的 4 倍于是在百万张图里找相似就退化成了在一本数字册里翻页快是顺理成章的事。索引文件index.json和frame_index.json动图专属就是这本数字册。因为存的是指纹而非原图占空间通常只有图库本身的百分之几。定期备份这两个文件重装系统后搜索能力能直接恢复。进阶技巧与维护1. 让索引自己续命。config.ini里把IndexAutoUpdate设为true程序每小时自动做一次增量更新只处理新增和变化的文件不必手动重建。2. 开一个本地 HTTP API。同一份config.ini里把RunServer改为true、HttpPort保持 5000重启程序后就多出一个本地 Web 服务Swagger 文档在/openapi交互式接口调试页在/api。其他程序、脚本都可以通过 HTTP 调用它做相似图检索适合把搜索能力接到自己的工具链里。3. 搜 GIF 动图。因为 GIF 是逐帧建索引的搜动图时拿任意一帧都能命中整张动图这是很多同类工具不具备的能力。4. 索引瘦身。更新索引时勾选移除无效索引程序会扫描索引里指向已删除文件的条目并清理。删除结果项时也支持直接进回收站选中项按ShiftDelete比彻底删除更稳妥。常见问题Q支持哪些图片格式A索引支持 jpg、jpeg、png、bmp、gif、webp其中 gif 按帧索引。Straper 元数据清理目前处理 jpg、jpeg、bmp。Q索引几万张图要多久A取决于硬件和图库分布。程序会实时显示索引速度和吞吐量MB/s并估算剩余时间。SSD 上的图会明显快于 HDD多盘并行时速度还会叠加。Q搜索对相似度是怎么定义的A相似度指哈希指纹的吻合比例70 是肉眼能接受的相似下限DCT Hash 32这种严格算法下限是 85。阈值越高结果越少越精准。Q隐私安全吗会不会上传图片A全程本地计算图片和索引都不离本机。Straper 清理元数据也是离线完成的。Q能搜索网络图片吗A不能直接索引网络图库但支持把网页图片URL 或拖拽作为查询样本传入用于在本地图库中查找相似图。下一步做什么如果上面的内容让你动心不妨现在就动手克隆仓库先拿一个 500~1000 张图的小文件夹练手感受索引速度和搜索精度。试不同相似度阈值70 / 80 / 90建立自己的阈值手感。用一张截图、一张照片的局部测试旋转和翻转匹配的实际效果。装好 Straper把待发布的照片批量清一遍元数据再右键属性→详细信息看一眼 GPS 是不是真的消失了。ImageSearch 不追求取代专业的图片管理软件它的定位很朴素给记不住文件名的人一个按内容找图的口子给在意隐私的人一个清洗照片的工具。它在 GitHub 上有上千 Star作者也把设计思路和相似度为什么限 70这类决策过程写在了文档里。对想研究 .NET 图像处理、感知哈希或者 WPF 并行编程的人来说它还是一份不错的实战范本。记住那句老话最好的工具是能无缝融入你工作流的东西。ImageSearch 想做的就是让你把时间从翻文件夹里省出来留给真正重要的创作与回忆。快乐找图放心发图。【免费下载链接】ImageSearch基于.NET10的本地硬盘千万级图库以图搜图案例Demo和图片exif信息移除小工具分享项目地址: https://gitcode.com/gh_mirrors/im/ImageSearch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考