← 返回 Skills 市场

Local Image Search

Name: Local Image Search
Author: zhaomenghuan

作者匠心 · GitHub ↗ · v1.0.0

cross-platform ✓ 安全检测通过

385

总下载

当前安装

版本数

在 OpenClaw 中安装

/install local-image-search

功能描述

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 ma...

使用说明 (SKILL.md)

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 \x3C 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

安全使用建议

This skill appears coherent and focused on local image searches. Before use: (1) Verify you're on macOS and that you understand the directory you point the scripts at (they will enumerate image files and copy files if you run copy_results.sh). (2) Inspect the scripts yourself (they're short and plain shell) and run them first on a test folder to confirm behavior. (3) Be aware that GPS/metadata queries will surface location data from your photos — treat results as sensitive. (4) Note small inconsistencies: some scripts mentioned in SKILL.md are missing, and the mdfind time expressions may need adjusting for your macOS version. If you need stronger assurances, run the scripts in a constrained environment or with test data first.

功能分析

Type: OpenClaw Skill Name: local-image-search Version: 1.0.0 The skill bundle provides scripts for local image search and management, using standard macOS utilities like `mdfind` and `fd`. All shell scripts properly quote user-provided arguments (`"$VAR"`), mitigating shell injection risks. The `SKILL.md` file contains no prompt injection attempts or instructions for the agent to perform actions outside the stated purpose. While the scripts have broad file system access (searching and copying files), this is inherent to their stated function and there is no evidence of malicious intent such as data exfiltration, persistence mechanisms, or unauthorized remote communication.

能力评估

✓ Purpose & Capability

Name/description describe local image search and the included scripts and SKILL.md only perform filesystem queries (mdfind/find/fd), metadata inspection, and file copying which are consistent with that purpose.

ℹ Instruction Scope

Runtime instructions and scripts are narrowly scoped to searching and copying image files. There are a few minor inconsistencies: SKILL.md mentions additional scripts (search_by_size.sh, search_similar.sh, thumbnail.sh) that are not present in the package, and the mdfind examples use $time.*() expressions which may not be valid mdfind syntax on all macOS versions — this is a functionality issue, not a security red flag. The scripts only operate on user-specified directories and do not read unrelated system files or environment variables.

✓ Install Mechanism

No install spec is provided (instruction-only with small helper scripts). Nothing is downloaded or written by an installer, minimizing persistence and supply-chain risk.

✓ Credentials

The skill requires no environment variables, credentials, or config paths. Optional external tools (fd, exiftool) are reasonable for performance/metadata enhancements and are documented as optional.

✓ Persistence & Privilege

always is false and the skill does not request elevated or persistent privileges or modify other skills or system-wide configs. Scripts only perform file reads and optional file copies to destinations you provide.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install local-image-search
安装完成后，直接呼叫该 Skill 的名称或使用 /local-image-search 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release: Fast local image search using Spotlight or find command

元数据

Slug local-image-search

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题