指南 ›

AI 智能体与 MCP

更新于 2026-11-04

在 Mac 上，RAF Film Lab 可以由 Claude 或 Codex 等 AI 智能体操控。智能体会搜索你的图库、查看照片、更改它们的效果、配方和编辑、进行筛选、归入相簿并导出，走的都是与应用本身相同的路径。每项更改都会在应用中实时显示，像你自己的更改一样同步，并且可以撤销。

你可以提出的要求

智能体擅长处理编辑器里那些繁琐的工作：任何基于规则的操作、要对大量照片执行的操作，或需要反复查看和调整的操作。

用你自己的话提出要求即可，不必说出应用的名称。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 则一定可以。

要一劳永逸地解决，只需告诉你的智能体应用一次。把这一行加入它的常驻指令：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.

智能体通过应用为它渲染的预览来查看每张照片，因此它判断的是照片的实际样子，而不仅仅是设置。

智能体通过 Model Context Protocol（MCP）连接，这是 Claude Desktop、Claude Code、Codex 及许多其他 AI 应用都支持的开放标准。MCP 服务器是 Mac 应用的一部分。在 iPhone 和 iPad 上，同样的操作可以在快捷指令中使用。

开启智能体

智能体默认处于关闭状态，需要你手动开启。打开设置（⌘,），找到智能体：

• 允许 AI 智能体使用图库用于开启服务器。
• 智能体可以用于设定它们的权限范围：
  • 仅查看（默认）：搜索、读取设置和查看预览。
  • 查看和编辑：还可以更改效果、配方和编辑，添加蒙版和曲线，保留快照和虚拟副本，评分、标记、添加标签，创建和重新命名相簿，存储和更改配方，将配方存储到已连接的相机，以及从你选择的文件夹导入 RAF。
  • 查看、编辑和导出：还可以将照片和配方文件导出到你选择的文件夹。
  • 查看、编辑、导出和删除：还可以删除相簿、配方和快照，以及从图库中移除照片。
  已连接的智能体会立即看到新的权限级别；不允许的操作根本不会提供给它。
• 状态显示服务器是否就绪，以及连接的是哪个智能体。

连接 Claude、Codex 和其他客户端

RAF Film Lab 在应用内附带了一个小程序 raffilmlab-mcp。AI 应用会启动它来访问图库；如果 RAF Film Lab 未在运行，它会在后台打开应用。“设置”›“智能体”中有按钮，可按应用的实际安装位置拷贝准确的配置；请使用这些按钮，而不要手动输入路径。选择你的智能体应用：

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 文件，也只会从你选择的导入文件夹读取文件。它们无法绘制画笔蒙版或修复污点：这些需要你亲手在照片上操作。

效果与配方

新的效果或配方会像“用 Film Lab 显影”那样在你的 Mac 后台重新显影，让图库和导出呈现出变化。在显影完成之前，预览就会立即显示更改。如果想获得相机自己的渲染，请连接拍摄这些照片的相机，将 CONNECTION MODE 设为 USB RAW CONV./BACKUP RESTORE，然后让智能体在相机中显影：更改可以直接在相机中显影，也可以之后用 develop_photos 在相机中显影照片。显影进度会显示在“显影”面板中，你也可以在那里暂停或停止。

撤销与安全

• 更改实时显示。在编辑器中打开的照片会在你眼前更新，图库的缩略图也会随之更新。
• 对照片和配方的更改可以撤销。让智能体撤销，或者对于在编辑器中打开的照片，按下 ⌘Z：智能体的编辑和你自己的一样，都是一个撤销步骤。如果之后你又更改了该照片或配方，撤销不会影响你的更改。
• 新建的相簿、导入、虚拟副本和删除也可以撤销。撤销会删除智能体创建的相簿或虚拟副本，把导入的照片移出图库，并恢复被删除的相簿、配方或快照。
• 撤销不涵盖的三件事。从图库中移除照片：因此只有在你允许删除后智能体才能执行，并且每次都必须确认。新建的配方会一直保留，直到你在“配方”中删除它。存储到相机的配方会替换槽位原有的内容；原有内容会先在你的 Mac 上备份，如果相机没有保留某项设置，智能体会告诉你。
• 撤销在应用打开期间有效。它会记住智能体所做的最近 50 项更改。
• 智能体可以先做检查。每项更改都可以先试运行，告诉你会改变什么而不实际更改。一次涉及超过 100 张照片的更改会被拒绝，除非智能体予以确认。
• 更改会同步到你的其他设备，与你自己的编辑一样（需开启 iCloud 同步）。

导出

智能体只会导出到你选择的文件夹：将智能体可以设为查看、编辑和导出，然后点按导出文件夹旁边的选取…。智能体可以在其中创建文件夹，但不能写入其他任何位置。

• 导出绝不会替换文件。如果 DSCF1234.jpg 已存在，新文件将命名为 DSCF1234 2.jpg。
• 导出在后台运行。智能体可以跟踪和停止导出；已写入的文件会保留。
• 智能体的导出和其他导出一样计入免费导出次数；如果导出数量超过剩余次数，会在开始前被拒绝。

导入

智能体只会从你选择的文件夹导入：将智能体可以设为查看和编辑或更高级别，然后点按导入文件夹旁边的选取…。存储卡或相机照片的存放文件夹都很合适。

• 导入与你用“导入”按钮进行的导入相同：已在图库中的 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 使用，例如“在 RAF Film Lab 中查找照片”。

快捷指令不受“智能体”设置的影响，由你自己创建。它们的更改同样可以撤销。

隐私

• 该服务器不在网络上。它只接受你 Mac 上程序的连接，并且仅在智能体开启时运行。
• 智能体读取的内容，包括它请求的预览，会发送到你的智能体应用所使用的 AI 服务（例如 Claude 对应 Anthropic，Codex 对应 OpenAI），并受该服务条款约束。RAF Film Lab 不会向我们发送任何内容，智能体也绝不会收到你的 RAF 文件。
• 测量照片、查找连拍以及从图片中读取配方，都在你的 Mac 上借助 Apple 的 Vision 完成。
• “仅查看”让智能体能看到你的图库，但无法更改。

请参阅隐私政策。

故障排除

“RAF Film Lab 未接受智能体”

智能体无法连接到应用。请检查“设置”›“智能体”中的允许 AI 智能体使用图库是否已开启，然后在你的智能体应用中重新连接服务器（在 Claude Code 或 Codex 中使用 /mcp；在 Claude Desktop 中重新启动它）。

智能体说它无法更改、导出或删除

在“设置”›“智能体”中提高智能体可以的级别。智能体会收到通知，并看到新的工具。

“未设置导出文件夹”或“未设置导入文件夹”

在“设置”›“智能体”中，在导出文件夹或导入文件夹旁边选取一个。

预览已显示配方更改，但图库中尚未显示

照片仍在后台显影。在显影完成前，get_photo 中的显影状态会显示developing，导出也会等待显影完成。

移动过应用？

助手程序的路径会随之改变。请从“设置”›“智能体”重新拷贝命令或配置，并更新你的智能体应用。