编辑

export_photos

把照片连同它们的所有编辑渲染并导出到一个文件夹。

作用

默认导出每一张 keep 的照片(包括之前已导出过的,会重新渲染)。传入 photo_ids 可以改为导出指定的一组,传入 status 则导出另一组。dest_dir 在需要时会被创建;在它里面,文件会按源拍摄文件夹的名称,分到各自的子文件夹里,结果会列出写入的确切文件路径。渲染受 CPU 限制,每个 RAW 文件可能要几秒;结果会报告已导出和失败的数量,以及每张照片的错误。当用户想在 Adobe Lightroom 里继续时,请设置 lightroom=True:每个专有 RAW(ARW、CR3、NEF 及类似格式)还会得到一个 Camera Raw .xmp 附属文件,RAW 和它的附属文件会一起复制到导出文件旁边,所以把那个文件夹导入 Lightroom,就能以相同的滑块值打开这个 RAW。结果会在 lightroom_sidecars 里列出这些附属文件。DNG、TIFF 和 JPEG 文件没有附属文件。实验性效果、蒙版图层、LUT、修复和仿制、镜头 / 透视校正,以及专家级的 RAW 引擎设置,在 Lightroom 里没有对应的东西:它们只留在 imagic 自己的渲染里,lightroom_not_carried 会按照片列出它们。当它不为空时,请告诉用户,这样他们就不会指望 Lightroom 里的版本与之一致,并且只说明它所列出的内容。其他一切都会带过去:白平衡、曝光和影调滑块、texture、clarity、dehaze、自然饱和度和饱和度、HSL、调色和分离色调、色调曲线、锐化、降噪、暗角、颗粒、裁剪和拉直。如果用户打算在 Lightroom 里完成,请优先使用这些。在远程连接上,dest_dir 受到限制:只有名称或相对名称(例如 "delivery")总是解析到用户配置的导出文件夹之下,绝对路径必须位于该文件夹内,或者位于他们 imagic 配置里 mcp.remote_allowed_folders 所列出的文件夹内,其他任何路径都会返回错误,说明导出放在哪里,以及如何允许另一个文件夹。它也会在超过调用时间预算后作为后台任务派发,与 scan_directory 一样,用返回的 job_id 轮询 get_job_status。本地客户端不受限制,并且总是直接得到结果。

参数

名称类型必填
dest_dir str 必填
photo_ids list[int] | None 可选
status str 可选
lightroom bool 可选

如何提出要求

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

把暖色胶片风格应用到这个文件夹里的每一张留用照片上,并以质量 92 导出 JPEG。

编辑 其余的工具

list_presets apply_preset list_luts apply_lut apply_auto_color harmonize_series preview_mosaic apply_adjustments mask_adjust crop_photo save_preset get_photo_edits

用到它的工作流程

它在哪里运行

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

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

把整条流程交给你的 AI

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