Alpha File Manager v3.2.1-beta

文件管理器可以被 AI 助手指挥了

Alpha File Manager 现在内置了一台 MCP 服务端。MCP（Model Context Protocol）是
Claude、Codex、Cursor 等助手本来就会说的一种通用接口。在「设置 → 实验性功能」里
打开开关并选好权限档位，这些助手就能通过一套标准接口读取你的盘符、浏览目录、
搜索文件 —— 走的是已经认识快捷方式、虚拟目录和网络共享的那个文件管理器，
而不是靠截图去猜你的文件摆在哪。

先说清楚它现在能做什么、不能做什么

6 个工具，全部只读：

• 列出盘符（含卷标与剩余空间）
• 列出可移动设备（U 盘、网络共享）
• 浏览你指定的目录
• 按文件名搜索（可搜整盘索引，也可限定在某个目录子树内）
• 计算目录大小（含子目录，最慢的情况封顶两分钟）
• 读取你的收藏分类与条目

移动、改名、复制、删除 —— 一个都做不到。写操作不是「默认关着」，是根本没实现，
代码里就没有。这个测试版的定位就是先把读取这条链路做扎实。

三道防护，一道都不能关

• 只监听本机。 服务只绑定 127.0.0.1，局域网里别的设备即使知道地址也连不上。
• 随机访问密钥。 第一次打开服务时生成一串四段式密钥，没有它的请求一律拒绝。
• 拒绝陌生网址发来的请求。 只接受来自本机地址的访问 —— 防止你浏览器里的某个
  网页偷偷去连这个服务。

四个权限档位（关闭 / 只读 / 可写 / 每次审批），默认是关闭，服务根本不启动。
而且不管你选哪一档，每次调用都会重新查一遍 —— 把档位调低，下一次请求立刻生效，
不用重连。

一键装进各家助手，不用手抄配置

过去要把 AI 助手接进来，得自己去翻它的配置文件、手抄一段 JSON —— 最容易出的错
就是少一个逗号，而助手的反应只是「没有配置任何服务」，什么线索都不给你。

现在设置页会列出本机上能识别到的助手，写明每一家的配置文件放在哪，一键写好；
同一个界面也能一键移除。已支持：Codex、Cursor、Claude Code、Claude Desktop、
OpenClaw、Minimax Code。

因为改的是你自己的配置文件，写入严格守三条规矩：

• 只合并，不重写。 先解析文件，只增删那一个条目，再写回 —— 文件里别处的设置，
  包括 Codex config.toml 里的注释，都保持原样。
• 读不懂就不写。 解析失败的文件原封不动并明确报错，而不是替换成一份看起来对、
  其实不是的内容。
• 每次写之前先备份，存成 <原文件名>.alpha-mcp.bak。

配置写完之后需要重启对应的助手才会生效，所以面板上会常驻一条提示，写明改了哪个
文件、备份放在哪里。

谁问过什么，都会记下来

每次调用都写进应用设置目录旁边的纯文本日志：调用的是哪个工具、时间、是放行还是
拒绝。想核对助手都干了什么，用记事本打开就行。

这是测试版，请注意

• 权限档位里的**「可写」目前是预留的**，选了也不会有写操作发生。
• 配置面板在正式版前仍可能调整；各语言的界面文案也未必都已定稿。
• 想回退？把「设置 → 实验性功能 → MCP 服务」关掉即可，服务端不留驻、不联网。

---

构建信息

• 版本号：3.2.1-beta
• 安装包：Alpha_File_Manager_3.2.1-beta_x64-setup.exe
• 大小：19158990 字节
• SHA-256：45a743b46a882f9fbfb9093e632ce47a7d1ebd867544e227c26fed383182f142