選片

analyze_photos

對所有待處理的照片執行 AI 品質評分與自動選片。

功能

評分銳利度、曝光與構圖,偵測重複照片,並把照片分類為 keep、trash 或 culled(未決定)。選用的門檻值介於 0.0 到 1.0:分數達到或高於 keep_threshold 的照片會變成 keep,達到或低於 trash_threshold 的會變成 trash。兩者都不設定時,會使用使用者設定好的預設值。處理大型圖庫可能要一段時間;較重的 AI 模型在未安裝時會自動略過。回傳分析統計,以及各狀態的圖庫數量。只有待處理的照片會被評分:已分析過的照片保留它儲存的分數,即使評分器之後已經改進也一樣。這些照片請用 reanalyze_stale_photos。smart_rank(預設為 false,實驗性)會在快速選片之後增加第二輪:由影像理解模型評估哪些已分析的照片值得留用、哪些只是隨手拍(招牌、停放的車、地板),再據此重新排序整個圖庫。它也會重新排序先前分析過的照片,所以在沒有待處理照片時也可以單獨使用。只有在使用者想要更好的精選而不是速度時才選用:如果這台電腦從未用過照片搜尋,它需要一次性下載約 600 MB,而且每 1000 張照片大約增加兩分鐘。它絕不會重新執行分析,絕不會更動手動的 keep/trash 決定,而且如果失敗或無法使用,快速選片的結果會維持原樣。回覆會附帶一個 smart_rank 區塊,內含預估、狀態和數量。遠端:超過呼叫時間預算後,會像 scan_directory 一樣以背景工作派送,請用回傳的 job_id 輪詢 get_job_status。

參數

名稱類型必填
keep_threshold float | None 選填
trash_threshold float | None 選填
smart_rank bool 選填

如何要求

你不需要指名呼叫它。你說出想要的,代理會挑選工具:

替 D:/Shoots/eva_tom 裡的婚禮拍攝選片,留下最好的畫面,並告訴我你丟掉了哪些。

其餘的 選片 工具

reselect_photos check_score_freshness reanalyze_stale_photos set_photo_status

會用到它的工作流程

在哪裡執行

在你的電腦上。imagic 的 MCP 伺服器是由你的 AI 用戶端啟動的本機程序;照片絕不會離開你的磁碟,也不會上傳任何東西。參考文件中的每個工具都是如此,包括這一個。

要呼叫它,你需要一個連上 imagic 的 MCP 用戶端。Claude Code、Cursor、VS Code、Codex、Gemini CLI 和其他十個用戶端的設定大約只要三分鐘。

把整條流程交給你的 AI

analyze_photos 是 imagic Max 中 30 個工具之一。500 次匯出的免費試用包含全部工具。