让 AI 审阅 Mac 清理，执行前批准，执行后核对记录
Mint Direct 让 AI Agent 查看 Mac 存储，并按审阅过的扫描计划清理符合条件的项目，留下处理记录。请在 Agent 客户端中要求 mint_execute 执行前批准；连接 Mint 本身不会为每次调用强制确认，也不限制其他 shell 工具。MCP 将适合的项目移到废纸篓，会话优化和文件夹编辑仍在应用中单独审阅。
要点
- 简单说： Mint 显示是什么占了磁盘，并分成 Optimizable、Safe to clean、Yours 和 Keep，每一步都按数据的性质来。
- 给你的 Agent： Mint Direct 的 CLI 和 MCP 能让你的 Agent 读取本机存储数据，并执行受支持、有记录的清理。
- 值得知道： Mac App Store 版和 Setapp 版不包含 CLI 和 MCP 服务器。
让 Agent 在修改文件前请求批准
连接 Mint 不会给每一次 MCP 调用自动加上强制人工确认。有效的 mint_execute 请求可以进入原生清理流程，而不再弹出一个 Mint 确认框。请在 Agent 客户端中为 mint_execute 设置执行前询问，不要为整个服务器一概放行。Mint 也无法限制 Agent 的其他 shell 工具。
- 先用 mint_status、mint_agents 或 mint_scan 查看。要求解释选择的项目 ID、范围、预计大小、哪些能重新生成和哪些会保留。
- 审阅具体选择，并在 Agent 中设置执行前询问。Claude Code 可用 /permissions，按客户端实际显示的完整 MCP 工具名匹配；插件安装的名称可能不同。
- 只批准审阅过的计划与项目；计划变更或过期后重新扫描和审阅。Needs Review 项目仍在 Mint 应用里确认。
- 执行后核对返回的批次 ID、失败项、移到废纸篓的字节及 mint_recent 记录；丢弃废纸篓或所需历史前先确认恢复能力。
批准、记录和恢复是三件不同的事
Agent 权限决定工具能否运行，Mint 的计划限制本次 MCP 能处理哪些项目，日志记录结果。这些都不等于整台 Mac 的文件备份。
Claude Code 的 checkpoint 不是所有 shell 清理的通用撤销：只由 Bash 修改的文件不在追踪范围。Mint 中符合条件的废纸篓移动，也只有在所需文件和历史仍在时才能恢复；日志最多保留 90 天或 5,000 批。
MCP 执行工具不包含会话图片优化、媒体移除、重复文件存储共享或文件夹规则编辑。这些在应用中审阅。MCP 清理把适合的项目移到废纸篓，这一步本身不会增加磁盘可用空间。
Agent 接口验证到了哪一层
10 月 27 日，我们用测试原生响应运行了生产 MCP 协议，确认它拒绝原始路径与永久操作、保留所选项目 ID，并如实传递响应中的日志 ID 和字节字段，不编造已释放空间。
这是开发团队进行的协议测试，没有执行真实清理、测试 Agent 审批对话框，也不能证明完整文件操作的安全性。证据记录将它与真实 Codex 会话测量和外部评测分别列出。
先看清数据，再选择处理结果。
Mint 会看数据是什么、从哪里来、是否正在使用，再区分可以优化存储的内容、可清理项目、需要你决定的个人内容，以及应该保留的文件。
可优化: 文件保留，占用更少。
符合条件的相同副本共享存储，每份文件仍在原位。受支持的闲置文件和 Codex 截图也可减少占用，保留工作流需要的内容。
可清理: 有依据地选择清理。
结合原因和当前使用状态，复核已识别的缓存、构建产物、旧日志和应用残留。部分内容在下次使用时需要重新生成或下载。
你的内容: 留什么，由你决定。
你的文件、应用、对话和媒体需要你判断。选择具体项目，看清每个操作会移除什么；个人内容不会仅仅因为大或旧就被当成垃圾。
保留: 必要数据保持原样。
必要、正在使用、受保护和无法确认的数据保持不变。没有充分依据可处理的系统与应用数据，不会被算作可回收空间。
跟随工作流，持续照料
Auto Care 在 Mint 运行时，按你启用的范围和计划执行受支持的磁盘、文件夹和内存例行任务。
按来源、类型、日期或主题整理文件，先预览，并保留移动记录。内存管理单独查看应用占用、释放内存，与磁盘清理分开。
Direct 1.0.92 起，免费版就包含 Auto Care。从 Direct 1.0.96 起，它移除的内容和整理的文件大小都计入每周免费的 1 GB，手动清理和整理也用这同一份额度，Mint Unlimited 取消这个限制。Direct 的内存释放始终免费不限量。Setapp 也有内存管理，Mac App Store 版没有。
Agent 也能参与，操作范围清楚
Mint Direct 的 CLI 和 MCP 让 Agent 查看存储、理解增长来源、复核受支持的清理。当前 MCP 执行工具会把符合条件的扫描计划项目移到废纸篓，并返回操作记录。对话优化、媒体移除、存储共享、文件夹设置和内存管理由你在应用里复核，不应全部描述为 MCP 可执行的操作。
直销版里有什么
Mint 直销版每次启动时，会把 mint-cli 链接到 /opt/homebrew/bin 或 /usr/local/bin 中它有写入权限的那个目录，所以在任何终端里都能直接用。mint-cli status 能看到最近几次扫描之间磁盘占用的变化，mint-cli why 告诉你什么在变大，mint-cli scan 会列出能清掉的缓存和垃圾文件。想知道 Codex、Claude Code 和 Cursor 在磁盘上存了多少东西，就用 mint-cli agents。
Mac App Store 版和 Setapp 版都没有 CLI 和 MCP 服务。Agent 通过 Mint 做的清理，和你在应用里做的清理共用一份清理额度。
通过 MCP 连接你的 Agent
运行 mint-cli mcp 会在你的 Mac 本地启动一个 MCP 服务，通过标准输入输出和 Agent 通信。扫描和清理交给 Mint 应用来做，其他工具读的是 Mint 已经存在本地的数据。
- 从 Mint 官网下载直销版，先打开一次。
- 在终端运行 mint-cli status，确认能看到磁盘摘要。
- 在 Agent 的 MCP 设置里加一个服务，命令填 mint-cli，参数填 mcp。
- 重启 Agent，问问它你的 Mac 空间都用在了哪里。
Agent 能看到什么
这个服务一共有八个工具。mint_status 和 mint_why 负责磁盘趋势和增长来源。mint_scan 调用 Mint 自己的只读清理扫描，每一项都会附上原因，并标明 Agent 能不能处理。
mint_recent 和 mint_activity 读取操作日志和活动记录，mint_agents 读取 Mint 最近一次 AI Agent 扫描的结果，mint_rules 会列出你的清理规则，也能试运行其中一条。这些工具都不会改动磁盘。
Agent 动手清理时会发生什么
会改动文件的只有 mint_execute。它要用到最近一次 mint_scan 返回的计划 ID、Agent 挑出的项目 ID，外加一句说明原因的话，而且不接受文件路径。计划 15 分钟后失效，只能用一次。动每个文件之前，Mint 还会再确认一遍，确保还是同一个文件、没有程序在用，而且仍然允许清理。
所有文件都会移到废纸篓，就算应用里设置了永久删除也一样。返回结果里有日志批次 ID，只要文件和所需的记录还在，符合条件的移动就能撤销。历史最多保留 90 天或 5,000 批。文件在废纸篓里照样占空间，清空后才会腾出来，所以结果会把这部分单独列出。
忽略列表对 Agent 同样有效
你在 Mint 忽略列表里给路径设的级别，Agent 来问时也照样生效。设为“受保护”的路径，Agent 的扫描里根本看不到。设为“需要确认”的路径可能出现在结果里，但 Agent 删不了，得你回到应用里确认。
有了日志，Agent 做过什么都查得到，大多数时候也能撤回，可它没法保证 Agent 每次都判断对。重要的工作请继续用版本控制和备份保护好。
常见问题
哪些 Mint 版本有 CLI 和 MCP 服务？
只有从 Mint 官网下载的直销版有。Mac App Store 版和 Setapp 版都没有。
Agent 能通过 Mint 永久删除文件吗？
通过 MCP 工具不行。mint_execute 只会把文件移到废纸篓，需要永久删除的项目会留在 Mint 应用里等你处理。
连上 Mint 以后，Agent 就不会再用 rm 了吗？
不一定。MCP 服务会让 Agent 用 mint_execute 来清理，但它拦不住 shell，所以 Agent 自己的权限设置请照常保留。
先问一个关于存储的问题
把 Mint Direct 接到 Agent，问问哪些在增长、哪些可以优化、哪些需要你来定。然后在 Mint 里复核相应操作，或者走受支持的 MCP 清理流程。