Local Image Search

基于 macOS Spotlight（mdfind）与可选的 fd 在本地检索图片，可按文件名、日期、GPS 位置、尺寸等元数据筛选，列出目录内图片，并支持把结果复制到指定文件夹。已提供脚本覆盖按名称、日期、位置检索与列出全部；尺寸、相似图片和缩略图脚本仅被文档引用，未包含在文件列表中。

zhaomenghuan

热度 58.05

最近更新 2026-05-11 17:27:54

分类：搜索依赖：代码执行 / 读写文件应用场景：工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add local-image-search

Metadata

name: local-image-search
description: Fast local image search using macOS Spotlight or fd. Search images by name, date, location, or metadata. Use when users need to find images on their local machine quickly without manual browsing.

Local Image Search

Search local images quickly using macOS Spotlight or fd.

Quick Start

Search by Name

# Using fd (fastest)
fd -e jpg -e png -e jpeg -e heic -e webp -e gif -e tiff "pattern" /path/to/search

# Using Spotlight
mdfind -onlyin /path/to/search "kMDItemDisplayName == '*pattern*'"

Search by Date

# Today
mdfind -onlyin ~/Pictures "kMDItemContentTypeTree == 'public.image' && kMDItemFSContentChangeDate > $time.today()"

# Last 7 days
mdfind -onlyin ~/Pictures "kMDItemContentTypeTree == 'public.image' && kMDItemFSContentChangeDate > $time.now(-604800)"

# This month
mdfind -onlyin ~/Pictures "kMDItemContentTypeTree == 'public.image' && kMDItemFSContentChangeDate > $time.this_month()"

Search by Location (GPS)

# Has GPS coordinates
mdfind "kMDItemContentTypeTree == 'public.image' && kMDItemGPSStatus == 'GPS'"

# In specific area (approximate)
mdfind "kMDItemContentTypeTree == 'public.image' && kMDItemGPSLatitude > 39 && kMDItemGPSLatitude < 41"

List All Images

# All images in home
mdfind "kMDItemContentTypeTree == 'public.image'"

# Specific directory only
mdfind -onlyin ~/Pictures "kMDItemContentTypeTree == 'public.image'"

# Specific types only
mdfind -onlyin ~/Pictures "kMDItemContentType == 'public.png'"

Available Scripts

Basic Search

scripts/search_by_name.sh - Search images by filename pattern
scripts/search_by_date.sh - Search by creation/modification date
scripts/list_all.sh - List all images in a directory

Advanced Search

scripts/search_by_location.sh - Search by GPS coordinates
scripts/search_by_size.sh - Search by image dimensions
scripts/search_similar.sh - Find visually similar images (requires perceptual hash)

Utility

scripts/thumbnail.sh - Generate thumbnails for results
scripts/copy_results.sh - Copy search results to destination

Image Types Supported

Extension	Type
jpg/jpeg	JPEG images
png	PNG images
heic	iPhone photos
webp	WebP images
gif	GIF images
tiff	TIFF images
raw	RAW camera files
dng	Digital negatives

Metadata Search Keys

Key	Description
kMDItemDisplayName	Filename
kMDItemFSContentChangeDate	Modification date
kMDItemContentCreationDate	Creation date
kMDItemPixelWidth	Image width
kMDItemPixelHeight	Image height
kMDItemGPSLatitude	GPS latitude
kMDItemGPSLongitude	GPS longitude
kMDItemMake	Camera make
kMDItemModel	Camera model

Examples

# Find all screenshots
./scripts/search_by_name.sh "Screen Shot" ~/Desktop

# Find photos from today
./scripts/search_by_date.sh today ~/Pictures

# Find iPhone photos
./scripts/search_by_name.sh "IMG_" ~/Pictures

# Copy results to folder
./scripts/search_by_date.sh today ~/Pictures | ./scripts/copy_results.sh ~/Desktop/today_photos

Requirements

macOS (uses Spotlight/mdfind)
fd (optional, for faster filename search): brew install fd
exiftool (optional, for advanced metadata): brew install exiftool