AI 智能体(Claude、ChatGPT、Gemini、Grok…)
让 Claude、ChatGPT、Gemini、Grok 和其他 AI 智能体通过 Folia Files 搜索、显示和整理你的文件,每项更改都由你确认,并且可以撤销。
Claude(Mac 版 App)、ChatGPT、Gemini、Grok、Claude Code、Codex、Cursor 或 VS Code 等 AI 智能体可以通过 MCP(Model Context Protocol,模型上下文协议)使用 Folia Files。智能体负责思考,Folia 负责显示和执行:
- 它像 Folia 一样搜索:按名称、按文稿中的文本、按图像中的内容、按你的标签,也能搜索你的云存储和服务器;
- 它会在 Folia 的标签页中向你显示找到的内容,使用你喜欢的显示方式(只含这些文件的列表,或选中了这些文件的所在文件夹);
- 它会整理你的窗口:存储场景和工作区,你可以随时再次打开;
- 它会在 Folia 的表单中提出更改(新建文件夹、移动、拷贝、重新命名、添加标签、移到废纸篓、压缩、转换图像…):在你确认之前什么都不会执行,你可以取消勾选任何一项更改或任何一个文件;
- 一切都可以撤销:任何内容都不会被覆盖(已被使用的名称会加上“2”),删除的内容会进入废纸篓,每项更改都是操作中的一项操作,带有智能体的名称,按 ⌘Z 即可撤销;
- iCloud 云盘或其他云存储中仅在线的文件,绝不会为智能体下载。
此功能在你打开之前一直关闭,可在欢迎导览中或在 设置 › AI 智能体 / MCP 中打开。
打开此功能
- 打开 设置 › AI 智能体 / MCP。
- 打开 允许 AI 智能体使用 Folia Files。
- 选择智能体可以做什么:
| 级别 | 智能体可以做什么 |
|---|---|
| 仅帮助 | 阅读 Folia 的文档;它看不到你的任何文件 |
| 读取和显示 | 搜索你的文件,读取它们的信息(名称、大小、日期、标签;不包括内容),在标签页中显示它们,存储场景和工作区 |
| 提出更改 | 以上全部,并且可以对文件提出更改,由你在 Folia 中确认 |
读取文稿内容 是一个单独的开关,默认关闭:打开后,智能体可以读取 PDF、文稿或图像中的文本(例如用来总结)。智能体读取的内容会发送给它的 AI 提供商。
允许的文件夹:智能体看不到其他任何位置。默认是你的个人文件夹(其中的资源库保持隐藏,iCloud 云盘和云存储除外;个人文件夹顶层的隐藏文件也同样隐藏)以及其他磁盘和服务器。你可以随意添加或移除文件夹。
智能体需要时打开 Folia Files:Folia 关闭时,智能体会在后台打开它。
连接智能体
在 设置 › AI 智能体 / MCP › 连接智能体 中,从列表里选择你的智能体:Folia 会一步一步说明如何连接,并给出完成这一步的按钮。Claude、ChatGPT、Gemini 和 Grok 排在最前面(欢迎页面中也是)。
| 智能体 | 方法 |
|---|---|
| Claude(Mac 版 App) | 安装…:Claude 会请求安装“Folia Files”扩展;接受后,开始一个新对话 |
| ChatGPT(Mac 版 App) | 添加到 ChatGPT:Folia 通过 ChatGPT 自带的工具把自己添加到它的 MCP 服务器;退出 ChatGPT 并重新打开 |
| Gemini(Mac 版 App) | 拷贝命令,然后在 Gemini 中:自定义 › 关联应用 › 自定义,本地 MCP 标签页:服务器名称“Folia Files”,服务器 ID“folia”,将命令粘贴到 命令 中,然后点按 关联。如果 Gemini 无法连接 Folia Files:高级设置 › 沙盒设置 › 完整访问权限。Google 正在逐步开放 本地 MCP 标签页:如果 Gemini 只要求输入链接,你的账号暂时还无法启动 Folia Files。 |
| Grok | Grok App 只接受在线连接器:请连接 xAI 的“终端”智能体 Grok Build。拷贝命令,粘贴到“终端”中,然后重新启动 Grok Build |
| Claude Code | 拷贝命令,粘贴到“终端”中,然后重新启动 Claude Code |
| Codex | 拷贝命令,粘贴到“终端”中,然后重新启动 Codex |
| Cursor | 添加到 Cursor,然后在 Cursor 中确认 |
| VS Code | 添加到 VS Code,然后在 VS Code 中确认 |
| 其他智能体 | 拷贝配置,然后粘贴到智能体的 MCP 设置中(“mcpServers”) |
所有智能体运行的都是同一个小程序 folia-mcp,它位于 Folia Files 内部(Folia Files.app/Contents/Helpers/folia-mcp)。它只在你的 Mac 上与 Folia 通信:不使用任何网络端口,其他电脑无法访问。
某个智能体 App 第一次使用 Folia 时,Folia 会询问你:允许 还是 拒绝。你可以在 设置 › AI 智能体 / MCP › 已允许的智能体 中忘记某个 App:它下次会再次询问。
你可以这样问
- “整理我的下载文件夹:每种类型一个文件夹,重复的文件移到废纸篓。”
- “给我看去年的发票。”
- “用我的照片文件夹做一个场景,用照片墙显示,再加上地图。”
- “我的外置磁盘上是什么占用了空间?”
- “在我删除旧文件夹之前,比较一下这两个文件夹。”
- “用日期和商店名称重新命名这些扫描件。”
更改提议表单
智能体提出更改时,Folia 会来到最前面并显示一个表单:智能体的名称、它的说明,然后是每项更改及其文件。取消勾选某项更改,或者展开它并取消勾选其中的部分文件;显示文件 会先在标签页中打开这些文件。应用 执行已勾选的内容;拒绝 则什么也不做。智能体会逐个文件得知执行了什么。
提议会等待你 15 分钟;超过这个时间,就会被放弃。
智能体执行的操作
设置 › AI 智能体 / MCP › 智能体执行的操作 列出智能体最近的请求(保存在内存中,直到 Folia 退出)。它们做出的更改也会和其他更改一样,带着智能体的名称出现在 操作 中。
智能体可以使用的工具
| 工具 | 级别 |
|---|---|
search_docs、read_doc、list_docs:文档 | 仅帮助 |
get_context(你正在看的内容)、list_folder、get_info、search_files、list_places、recent_items、recent_operations、get_shelf | 读取和显示 |
show_files、open_folder、open_scene、open_workspace、create_scene、create_workspace、add_to_shelf | 读取和显示 |
disk_usage、find_duplicates、compare_folders、mac_health、read_note、connect、open_tool | 读取和显示 |
propose_changes、undo_operation、add_note、run_saved_job | 提出更改 |
read_text | 读取文稿内容 |
open_tool 会为你填好 Folia 的某个工具(照片和视频的批量操作、PDF、批量重新命名、重复文件、比较),由你检查后运行。run_saved_job 会在你确认后运行你的某个备份、同步或规则。
隐私
- 智能体看到的有关你文件的内容(名称、文件夹、信息,以及在你允许时的文本)会发送给该智能体的 AI 提供商。Folia 本身不会向任何地方发送任何内容。
- 智能体只能看到允许的文件夹,绝不会看到资源库中的私人数据,也绝不会看到个人文件夹顶层的隐藏文件。
- 仅在线的云端文件绝不会为智能体下载。
不用 App:供任何助手使用的文档
Folia 的文档也是网络上的一个 MCP 服务器,无需账户:将 https://foliafiles.com/mcp 添加到你的助手(Claude:Settings › Connectors › Add custom connector),然后问它如何在 Folia Files 中完成某件事。它只读取这份文档。
如果无法使用
智能体会说明原因:
- “Access for AI agents is off”:在 设置 › AI 智能体 / MCP 中打开。
- “Folia Files is not open”:打开 Folia Files,或打开 智能体需要时打开 Folia Files。
- “The user did not allow this app”:该 App 已被拒绝;在 已允许的智能体 中忘记它,下次接受即可。
- “… is outside the folders Folia Files lets agents use”:在 允许的文件夹 中添加该文件夹。