图库

list_photos

列出照片,包含 id、文件名、路径、状态、得分、描述和拍摄时间。

作用

name 按文件名查找照片,就像人们称呼它们的方式(“DSC04851”):不区分大小写,匹配名称的一部分,并且可以一次传入多个用逗号分隔的名称。用它把用户提到的名称,转换成其他每个工具所需要的照片 id。taken 是照片的拍摄时间(来自 EXIF 的 ISO 时间):在没有描述的情况下,可用它按天或按傍晚(“日落时分的画面”)对一场拍摄分组。taken_after / taken_before 按它筛选(ISO 格式,包含边界;只写日期则覆盖整天),例如 status="keep", taken_after="2026-09-22T18:00":在大型拍摄中,请筛选,而不要列出全部。拍摄时间由 analyze_photos 读取,所以在按时间筛选之前要先运行它;在此之前,响应里的说明会告诉你有多少张照片还没有时间。按状态(pending、keep、trash、culled、exported、error)筛选,或者省略它以列出全部。用 limit 和 offset 翻页浏览大型照片库;响应包含匹配的总数。此列表中的照片 id,就是每个针对单张照片的工具所需要的。

参数

名称类型必填
status str | None 可选
limit int 可选
offset int 可选
taken_after str | None 可选
taken_before str | None 可选
name str | None 可选

如何提出要求

你不需要按名字调用它。你只需说出想要什么,由智能体选择工具:

给 D:/Shoots/eva_tom 里的婚礼拍摄选片,留下最好的画面,并告诉我你丢弃了哪些。

图库 其余的工具

scan_directory get_library_stats get_photo get_preview_url get_job_status

用到它的工作流程

它在哪里运行

在你的电脑上。imagic 的 MCP 服务器是由你的 AI 客户端启动的本地进程;照片不会离开你的磁盘,也不会上传任何内容。参考中的每个工具都是如此,包括这一个。

要调用它,你需要一个连接到 imagic 的 MCP 客户端。对于 Claude Code、Cursor、VS Code、Codex、Gemini CLI 以及其他十个客户端,设置大约需要三分钟。

把整条流程交给你的 AI

list_photos 是 imagic Max 中 30 个工具之一。500 次导出的免费试用包含所有这些工具。