指南 ›

AI 代理程式與 MCP

更新於 2026 年 11 月 4 日

在 Mac 上，RAF Film Lab 可以由 Claude 或 Codex 等 AI 代理程式操作。代理程式能搜尋你的圖庫、查看相片、更改風格、配方與編輯、篩選相片、將相片歸入相簿並輸出，走的都是與 App 本身相同的途徑。每項更改都會即時顯示在 App 中，像你自己的更改一樣同步，而且可以還原。

你可以要求什麼

代理程式擅長處理在編輯器中很繁瑣的工作：任何依規則進行、套用到大量相片，或需要反覆觀察與調整的事情。

用你自己的話提出要求即可，不需要指名 App。RAF Film Lab 會告訴已連接的代理程式它保管著你的相片圖庫，因此任何關於你的相片、匯入、評分、相簿、風格或配方的要求都會交給它。

提示範例

尋找與查看

• 「給我看我最近匯入的 5 張相片。」
• 「我這週匯入了幾張 X-T5 的相片？它們分別用了哪些風格？」
• 「我的相片 DSCF1234 是用哪個配方拍的？」

風格與編輯

• 「找出上次匯入中的四星相片，把它們設為 Classic Chrome，再稍微調暖一點。給我看其中一張的前後對照。」
• 「把這個配方套用到我的京都相簿中的相片：」後面接著從論壇貼文貼上的配方、分享連結，或你已儲存的配方名稱。
• 「讓這三十張畫面和我的相片 DSCF1234 保持一致。」
• 「把昨天匯入的所有相片拉直並自動調整影調。」
• 「把我星期六拍的風景照天空稍微壓暗，再加上一條柔和的 S 曲線。」
• 「提亮 DSCF1234 的主體，並在周圍加上柔和的暈影。」
• 「把 DSCF1234 現在的樣子存成快照，然後試試 Acros。也用 Classic Negative 建立一個虛擬拷貝，讓我比較。」

篩選與整理

• 「篩選星期六匯入的相片：排除所有失焦的，留用最好的五張並給它們五顆星。」
• 「找出上次匯入中的連拍，每組保留最清晰、且每個人都睜著眼睛的那一張。」
• 「婚禮的相片中，有哪些嚴重過曝？」
• 「把匯入檔案夾中的新 RAF 匯入到名為 Lisbon 的相簿。」
• 「把上次匯入中留用的相片放進新的相簿 Lisbon。」

相機與配方

• 「我用過哪些相機拍攝？我的 X-T3 缺少哪些底片模擬？」
• 「把我的相片 DSCF1234 的配方存成 Golden Hour，顆粒再多一點。」
• 「我的相機自訂設定裡有什麼？把我還沒有的都存起來。」
• 「把我的 Golden Hour 配方放到相機的 C4。」
• 「給我一個分享 Kodachrome 配方的連結。」
• 「讀取匯入檔案夾裡這張截圖中的配方並儲存。」
• 「把我的 Golden Hour 配方輸出為適用於 X-T5 的 X RAW Studio 描述檔。」

輸出與還原

• 「把 Blog 相簿中所有留用的相片以 2048 像素輸出到 blog 檔案夾。」
• 「到目前為止你改了我相片的哪些地方？還原最後一項。」

如果代理程式找錯地方

Codex 和 Claude Code 等程式設計代理程式也能讀取它們正在工作的檔案夾中的檔案。只給一個像「DSCF1234」這樣的檔名時，Codex 可能會改為搜尋那個檔案夾。加上相片（「我的相片 DSCF1234」）通常就足夠；直接指名 RAF Film Lab 則一定有效。

若要一勞永逸，可以在代理程式 App 中設定一次。將這一行加入它的常駐指示：Codex 為 ~/.codex/AGENTS.md，Claude Code 為 ~/.claude/CLAUDE.md，Claude Desktop 則是你的個人或專案指示：

My photos are in RAF Film Lab. For anything about my photos, use its tools, not files on disk.

代理程式透過 App 為它渲染的預覽來看每張相片，因此它判斷的是相片看起來的樣子，而不只是設定值。

代理程式透過 Model Context Protocol（MCP）連接，這是 Claude Desktop、Claude Code、Codex 以及許多其他 AI App 支援的開放標準。MCP 伺服器是 Mac App 的一部分。在 iPhone 與 iPad 上，相同的動作可在「捷徑」中使用。

開啟代理程式

代理程式在你開啟之前都是關閉的。打開設定（⌘,）並找到代理程式：

• 讓 AI 代理程式使用圖庫會開啟伺服器。
• 代理程式可以設定它們能做到什麼程度：
  • 僅檢視（預設）：搜尋、讀取設定與查看預覽。
  • 檢視和編輯：還能更改風格、配方與編輯、加入遮罩與曲線、保留快照與虛擬拷貝、評分、標示旗標、加上標籤、建立與重新命名相簿、儲存與更改配方、將配方儲存至連接的相機，以及從你選擇的檔案夾匯入 RAF。
  • 檢視、編輯和輸出：還能將相片與配方檔案輸出到你選擇的檔案夾。
  • 檢視、編輯、輸出和刪除：還能刪除相簿、配方與快照，以及從圖庫移除相片。
  已連接的代理程式會立即看到新的層級；它不會被提供不被允許的功能。
• 狀態會顯示伺服器是否就緒，以及哪個代理程式已連接。

連接 Claude、Codex 和其他用戶端

RAF Film Lab 的 App 內附一個小程式 raffilmlab-mcp。AI App 會啟動它來與圖庫溝通，如果 RAF Film Lab 尚未執行，它會在背景打開 RAF Film Lab。「設定」›「代理程式」中有按鈕，可依 App 的安裝位置拷貝正確的設定；請使用這些按鈕，而不要手動輸入路徑。選擇你的代理程式 App：

claude mcp add --scope user raf-film-lab -- "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"

{
    "mcpServers": {
      "raf-film-lab": {
        "command": "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"
      }
    }
  }

codex mcp add raf-film-lab -- "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"

[mcp_servers.raf-film-lab]
  command = "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"

{
    "mcpServers": {
      "raf-film-lab": {
        "type": "stdio",
        "command": "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"
      }
    }
  }

{
    "servers": {
      "raf-film-lab": {
        "type": "stdio",
        "command": "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"
      }
    }
  }

{
    "mcpServers": {
      "raf-film-lab": {
        "command": "/Applications/RAF Film Lab.app/Contents/Helpers/raffilmlab-mcp"
      }
    }
  }

代理程式能做什麼

代理程式能做什麼，取決於你在「設定」中允許的範圍。相片 ID 來自 search_photos，每次更改最多可處理 500 張相片。

代理程式絕不會更改你的原始 RAF 檔案，也只會從你選擇的匯入檔案夾讀取檔案。它們無法繪製筆刷遮罩或修復斑點：這些需要你親手在相片上操作。

風格與配方

新的風格或配方會在你的 Mac 上於背景重新顯影，方式與「以 Film Lab 顯影」相同，因此圖庫與輸出都會反映出來。預覽會在顯影完成前立即顯示更改。若想改用相機自身的渲染，請連接拍攝這些相片的相機，並將 CONNECTION MODE 設為 USB RAW CONV./BACKUP RESTORE，然後請代理程式在相機中顯影：更改可以直接在相機中顯影，或之後用 develop_photos 在相機中顯影相片。顯影進度會顯示在「顯影」面板中，你也可以在那裡暫停或停止。

還原與安全性

• 更改即時顯示。在編輯器中打開的相片會在你眼前更新，圖庫的縮圖也會跟著更新。
• 對相片與配方的更改可以還原。請代理程式還原，或者針對編輯器中打開的相片按下 ⌘Z：代理程式的編輯就和你自己的一樣，是一個還原步驟。如果你之後又更改了該相片或配方，還原不會影響你的更改。
• 新的相簿、匯入、虛擬拷貝與刪除也可以還原。還原會刪除代理程式建立的相簿或虛擬拷貝、將匯入的相片從圖庫中撤回，並找回已刪除的相簿、配方或快照。
• 還原不涵蓋三件事。從圖庫移除相片，因此代理程式只有在你允許刪除後才能這麼做，而且每次都必須確認。新配方會一直保留，直到你在「配方」中刪除它。儲存至相機的配方會取代該欄位原有的內容；原有內容會先備份到你的 Mac 上，如果相機沒有保留某項設定，代理程式也會告訴你。
• 還原在 App 開啟期間有效。它會記住代理程式最近的 50 項更改。
• 代理程式可以先檢查。每項更改都能以試執行方式進行，說明會更改什麼而不實際更改。一次更改超過 100 張相片時，除非代理程式確認，否則會被拒絕。
• 更改會同步到你的其他裝置，就像你自己的編輯一樣（需開啟 iCloud 同步）。

輸出

代理程式只會輸出到你選擇的檔案夾：將代理程式可以設為檢視、編輯和輸出，然後按一下輸出檔案夾旁的選擇…。代理程式可以在其中建立檔案夾，但無法寫入其他任何地方。

• 輸出絕不會取代檔案。如果 DSCF1234.jpg 已經存在，新檔案會命名為 DSCF1234 2.jpg。
• 輸出會在背景執行。代理程式可以追蹤並停止輸出；已寫入的檔案會保留。
• 代理程式的輸出和其他輸出一樣計入免費輸出次數，超過剩餘次數的輸出會在開始前被拒絕。

匯入

代理程式只會從你選擇的檔案夾匯入：將代理程式可以設為檢視和編輯或更高，然後按一下匯入檔案夾旁的選擇…。記憶卡或相機相片存放的檔案夾都很適合。

• 匯入就和你用「匯入」按鈕進行的一樣：已在圖庫中的 RAF 會略過，新的 RAF 則成為「上次匯入」。在 Mac 上，它們會留在原來的位置。
• 代理程式可以匯入整個檔案夾、其中的子檔案夾或單一檔案，但無法存取檔案夾以外的任何內容。
• 檔案夾中的配方檔案與配方圖片可以用 read_recipe 讀取。

提示與資源

有些用戶端會將 MCP 提示提供為現成的任務，通常在選單或 / 指令中：

• Match a Look：讓相片看起來像參考相片，再逐張微調。
• Cull Photos：依你提供的條件評分、留用與排除，從連拍以及測得的對焦、曝光與臉孔開始。
• Apply a Recipe from Text：讀取貼文或筆記中以文字寫出的配方，檢查後加以套用。

支援資源的用戶端可以將相片與列表附加到對話中：photo://{id} 為相片的詳細資訊，photo://{id}/preview 為其預覽，另有 library://looks、library://albums 與 library://recipes。

捷徑與 Siri

在 iPhone、iPad 與 Mac 上，RAF Film Lab 會在「捷徑」App 中加入動作：尋找相片、設定風格、套用配方、為相片評分、標示相片、將相片加入相簿、輸出相片與還原上一次圖庫更改。將它們串連起來：找出上次匯入中留用的相片、設定風格、輸出，再把檔案存到下一個動作指定的位置。有些動作也能搭配 Siri 使用，例如「Find photos in RAF Film Lab」。

「捷徑」不受「代理程式」設定影響；它們由你自己建立。它們的更改也能以相同方式還原。

隱私權

• 伺服器不在網路上。它只接收你 Mac 上的程式，而且只在代理程式開啟時運作。
• 代理程式讀取的內容，包括它要求的預覽，會依照該服務的條款傳送到你的代理程式 App 所使用的 AI 服務，例如 Claude 的 Anthropic 或 Codex 的 OpenAI。RAF Film Lab 不會傳送任何資料給我們，代理程式也絕不會收到你的 RAF 檔案。
• 測量相片、找出連拍以及從圖片讀取配方，都是以 Apple 的 Vision 在你的 Mac 上進行。
• 「僅檢視」讓代理程式能查看你的圖庫，但無法更改。

請參閱隱私權政策。

疑難排解

「RAF Film Lab 不接受代理程式」

代理程式無法連到 App。請確認「設定」›「代理程式」中的讓 AI 代理程式使用圖庫已開啟，然後在代理程式 App 中重新連接伺服器（在 Claude Code 或 Codex 中使用 /mcp；在 Claude Desktop 中請重新啟動）。

代理程式表示它無法更改、輸出或刪除

在「設定」›「代理程式」中提高代理程式可以的層級。代理程式會收到通知，並看到新的工具。

「未設定輸出檔案夾」或「未設定匯入檔案夾」

在「設定」›「代理程式」中，於輸出檔案夾或匯入檔案夾旁選擇一個。

預覽已顯示配方更改，但圖庫中尚未顯示

相片仍在背景顯影中。在 get_photo 中，它的顯影狀態會顯示 developing，直到完成為止，輸出也會等待它完成。

搬移了 App？

輔助程式的路徑也會隨之改變。請再次從「設定」›「代理程式」拷貝指令或設定，並更新你的代理程式 App。