功能
當照片已經評分、你只想要不同的挑選結果時，請用它來取代 analyze_photos：它會依儲存的資料重新套用門檻值與留用上限，不到一秒就完成，不需要重新分析。手動挑選（使用者或 set_photo_status 選定的狀態）一律保留，並以 manual_preserved 回報。mode="pipeline"（預設）會重新執行一般的決策引擎：keep/trash 門檻值，加上相對於這場拍攝的挑選步驟，其中 target_count 是留用數量的上限。那個步驟會把近似重複的畫面限制在每種風格最多 4 張，所以留下的數量可能少於 target_count；發生這種情況時，結果會附上說明。mode="top_n" 就是「幫我挑出作品集的最佳 N 張」的意思：剛好 target_count 張照片會變成 keep，其他所有已分析的照片變成 culled（待檢視），沒有任何照片會被移到 trash，而且來自同一個近似重複／連拍群組（與 App 自己的選片所用的分組相同）的照片最多 max_per_group 張（預設 1），所以猛按快門的連拍不會讓挑選結果被一堆幾乎相同的畫面塞滿。如果每組一張的候選數量少於 target_count，剩下的名額會不分群組，從次佳的畫面補足，結果也會說明。target_count 為必填。很適合即時微調：用不同的值反覆呼叫，直到使用者滿意數量為止。回傳 keep/review/trash 的數量、manual_preserved、total_considered，以及各狀態的圖庫數量。當部分儲存的分數來自較舊的評分器時，會出現 stale_scores 區塊；重新排序無法修正這些分數，所以請轉告使用者，並建議使用 reanalyze_stale_photos，而不是再重新篩選一次。
參數
| 名稱 | 類型 | 必填 |
|---|---|---|
keep_threshold |
float | None |
選填 |
trash_threshold |
float | None |
選填 |
target_count |
int | None |
選填 |
mode |
str |
選填 |
max_per_group |
int |
選填 |
如何要求
你不需要指名呼叫它。你說出想要的，代理會挑選工具：
從這場拍攝中，替客戶相簿挑出最好的 60 張並匯出。
其餘的 選片 工具
會用到它的工作流程
- 挑選並匯出客戶相簿 — AI 挑選最佳照片 客戶相簿
在哪裡執行
在你的電腦上。imagic 的 MCP 伺服器是由你的 AI 用戶端啟動的本機程序；照片絕不會離開你的磁碟，也不會上傳任何東西。參考文件中的每個工具都是如此，包括這一個。
要呼叫它，你需要一個連上 imagic 的 MCP 用戶端。Claude Code、Cursor、VS Code、Codex、Gemini CLI 和其他十個用戶端的設定大約只要三分鐘。