功能
預設會匯出每一張 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 的版本會完全一致，並且只指出它所列出的項目。其他一切都會帶過去：白平衡、曝光與色調滑桿、紋理、清晰度、去朦朧、鮮明度與飽和度、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。
其餘的 編輯 工具
會用到它的工作流程
- 用 AI 代理批次編輯 RAW 檔 — 批次編輯 RAW 檔 AI
- 挑選並匯出客戶相簿 — AI 挑選最佳照片 客戶相簿
在哪裡執行
在你的電腦上。imagic 的 MCP 伺服器是由你的 AI 用戶端啟動的本機程序；照片絕不會離開你的磁碟，也不會上傳任何東西。參考文件中的每個工具都是如此，包括這一個。
要呼叫它，你需要一個連上 imagic 的 MCP 用戶端。Claude Code、Cursor、VS Code、Codex、Gemini CLI 和其他十個用戶端的設定大約只要三分鐘。