使用指南

Memtrove 在你的 Mac 上为文件和浏览器书签建立索引，让你按文件名、按内容、按意思找到它们，也让 Claude 能帮你找。 索引只存在本机，不上传任何内容。

系统要求：macOS 13 或更高版本，Apple 芯片（M 系列）的 Mac。

安装

1. 下载 Memtrove 的 DMG，双击打开，把 Memtrove 拖到右边的「应用程序」文件夹。

2. 打开 Memtrove。第一次打开有五步引导，除了第一步都可以跳过，之后在设置里也能做：

   步骤	做什么
   欢迎	简单介绍
   完全磁盘访问权限	在「系统设置 › 隐私与安全性 › 完全磁盘访问权限」里打开 Memtrove。打开后引导会自动检测到并显示「已授权」。不打开也能用，但「文稿」「桌面」「下载」等受保护的文件夹会被跳过，系统还可能反复弹出授权提示
   下载语义模型	进到这一步就开始下载约 130 MB 的标准模型，之后完全离线运行。可以直接继续，下载在后台完成
   接入 Claude	可选。卡片上写明要修改的配置文件，点「接入」才会写入，并备份原文件
   完成	提示 ⌥ + 空格，显示索引进度

搜索

随处唤出

在任何 App 里按 ⌥ Space，屏幕上方会出现快速搜索浮层，直接输入即可。浮层里的快捷键：

点到浮层外面也会收起。

搜索写法

这些写法可以组合，例如 上个月 下载里的 "净 30 天"。

结果和预览

• 每条结果旁写着为什么出现：正文匹配、文件名匹配 或 按意思匹配；命中的词会高亮。
• 刚加进来、还没读完正文的文件会标「正文索引中」，这时只能按文件名找到它。
• 搜索框下面可以按类型（全部 / 文件 / 文件夹 / 书签，快捷键 ⌘ ⌥ 1–4）和时间筛选。「文件」不含文件夹。
• 文件夹按名字搜索。选中后右侧列出里面的第一层内容；双击或按 ↵ 在 Finder 中打开。时间线不显示文件夹。
• Pages、Numbers、Keynote 文档（.pages / .numbers / .key）只按文件名索引，打开文件查看内容。
• 文件夹改名或移动后，原来给这个文件夹加的标签会丢失。
• 右侧是预览：类型、页数、修改日期，以及文档目录。和查询相关的那一节会自动展开；底部列出相似文件和标签。
• 在主窗口里：单击结果在右侧预览，双击、点预览里的「打开」或按 ↵ 打开；时间线和「最近打开」也一样；⌘ ↵ 在 Finder 中显示，⌘ Y 快速查看，→ 把焦点移进预览，← 回到列表。
• 窗口很窄时只显示列表，「打开 / 在 Finder 中显示 / 预览」固定在底部；⌘ Y 或 → 打开覆盖列表的预览，← 或 Esc 返回。
• 用「增强」模型时可以跨语言搜：用中文问英文文档，或者反过来。「标准」模型下，用文档本身的语言搜效果最好。

其他页面

• 时间线：最近新建和修改过的文件，按天分组。可选今天、7 天、30 天、90 天，可按类型和「新建 / 修改」筛选；⌘ F 按名称过滤。
• 状态：
  • 后台服务是否在运行、已索引多少文件和书签、用的哪个语义模型、资源占用模式；
  • 每个目录和书签文件的三层进度（文件名 → 全文 → 语义）；
  • 书签的死链和重复收藏，点开能看到每一条；
  • 可以随时「暂停」建索引，点「立即继续」恢复。索引放慢时（比如正在用电池），这里会写明原因。
• 目录：选择要索引的范围：整个主目录，或主目录下勾选的几个文件夹；还可以添加外接硬盘等其他位置。页面右侧列出总会跳过的位置。改动后点「保存并重启服务」生效，已索引的内容会保留。

点主窗口的红色按钮关闭后，Memtrove 仍在运行，点程序坞里的图标即可调回窗口，回到关之前的页面和搜索词；按 ⌘ Q 才会退出。

设置

按 ⌘ , 或点右上角的齿轮，打开独立的设置窗口（主窗口全屏时，设置作为主窗口里的一页显示，点其他标签即可返回）。左侧有六组：

• 许可证：试用剩余天数、输入密钥激活、在这台 Mac 上停用。
• 通用：开机时自动启动、界面语言、资源占用（尽快 / 均衡 / 节能）。
• 语义检索模型：标准或增强，以及下载和重建的进度。
• 接入 Claude：接入 Claude Desktop，以及在 Claude Code 里接入用的命令。
• 隐私：敏感目录、Claude 对敏感目录能看到多少、是否抓取书签网页。
• 更新：当前版本，检查更新。

改动会自动保存。

语义模型

• 标准（默认）：约 130 MB，建索引快；跨语言基本搜不到。
• 增强：效果最好，支持中英互搜。约 600 MB，建索引要慢好几倍。

在「设置 › 语义检索模型」里选增强时，Memtrove 会先说明接下来会发生什么，确认后自动下载模型，并在后台重建语义索引。进度在设置里和「状态」页都能看到；建好之前，搜索照常使用当前模型。

增强模型建索引时约占 1.6 GB 内存，闲置 5 分钟后释放。在 8 GB 内存的 Mac 上，Memtrove 会建议继续用标准模型。

敏感目录

在「设置 › 隐私」里把放合同、病历之类文件的文件夹加为敏感目录。敏感目录只限制 Claude，你自己在 Memtrove 里照常搜索和预览。对 Claude 的可见程度可以选：

• 只给目录结构：只有文件夹、文件名和章节标题，不含正文和预览；
• 完全不给：这些目录不会出现在 Claude 的任何结果里。Memtrove 也不读取它们的正文，所以你自己只能按文件名找到这些文件。

~/.ssh 这类位置始终受保护。

在 Claude 里使用

接入是可选的。

• Claude Desktop：先退出 Claude Desktop（⌘Q），在「设置 › 接入 Claude」里点「接入」，然后重新打开 Claude Desktop。之后直接问 Claude，例如「帮我找上个月和 A 公司的合同，总结付款条款」。
• Claude Code：在同一页复制那条 claude mcp … memtrove … 命令，在终端里运行一次。它会替换旧的 Memtrove 条目，对所有项目生效。

Claude 可以通过 Memtrove 搜索、按需读取（先读目录再读某一节）、找相似文件、看时间线和状态、给文件加标签。结果里带文件大小，Claude 还能列出最大的文件、哪些文件夹最占空间、重复的文件和它们多占的空间——比如问「下载文件夹里什么最占地方？」。全部只读，Memtrove 不会修改或删除你的文件；Claude 只告诉你可以清理什么，删除和移动由你自己做。

大小来自索引：被排除不索引的文件夹（比如 node_modules）不计入；重复文件只覆盖已经索引过正文的文件。

注意：Claude 读到的内容会发送给 Anthropic 处理，适用 Claude 的条款。不想让 Claude 看到的文件夹，设为敏感目录「完全不给」，或者从索引目录里去掉。

开机自启

「设置 › 通用 › 开机时自动启动」打开后，登录 Mac 时索引服务在后台运行，新文件随时进入索引。 第一次打开时，macOS 可能要求你在「系统设置 › 通用 › 登录项」里允许 Memtrove，设置里会给出提示和「打开系统设置」按钮。关闭后，只有打开 Memtrove 或 Claude 用到时才会运行索引服务。

许可证与试用

• 安装后 14 天内全部功能可用。
• 许可证一次买断，可在你的 3 台 Mac 上使用，含所属大版本（如 1.x）的全部更新。下一个大版本（如 2.0）需要升级许可证；不升级，已安装的版本可以一直使用。
• 试用结束且没有许可证时，索引照常维护，但只能按文件名和书签标题搜索；正文和语义搜索、预览、Claude 接入暂停，激活许可证后立即恢复。
• 在「设置 › 许可证」输入购买邮件里的密钥并激活。激活需要联网一次，之后离线也能正常使用。
• 换电脑：先在旧 Mac 上「在这台 Mac 上停用」，再到新 Mac 上激活。

更新

「设置 › 更新 › 检查更新」。如果新版本是许可证不包含的大版本，安装前会先提醒你；你也可以一直使用当前版本。

资源占用

• 首次索引整个主目录需要一段时间：几万到几十万个文件，从几分钟到一两个小时。之后只处理变化的文件。
• 资源占用可选：
  • 尽快：一直用满所有核心；
  • 均衡：你用电脑时放慢，空闲时全速；
  • 节能：空闲时只用一半核心，用电池时不做语义索引。
• 后台服务空闲时约占 80 MB 内存，语义模型加载时约 500 MB，闲置 5 分钟后释放。

卸载

1. 在「设置 › 通用」里关闭开机时自动启动。如果接入过 Claude，从 Claude Desktop 的配置里删掉 memtrove 这一项。
2. 退出 Memtrove，把它从「应用程序」移到废纸篓。
3. 如果还要删除数据（索引、配置、日志、许可证状态），删掉这两个文件夹：~/Library/Application Support/Memtrove 和 ~/Library/Application Support/app.memtrove.desktop。

常见问题

搜不到某个文件？ 在「状态」页看它所在的目录是否在索引中、进度是否完成；再确认 Memtrove 有完全磁盘访问权限。下面这些默认不索引：

• 主目录第一层的隐藏文件夹；
• node_modules 等依赖目录；
• 项目里的构建产物和工具环境，如 .build、.conda、package.json 旁的 dist；
• .DS_Store 等系统生成的文件、压缩过的脚本；
• .env 和私钥文件；
• 超大文件。

系统反复弹出「Memtrove 想要访问…」？ 打开完全磁盘访问权限，一次解决。

索引服务没有运行？ 主窗口会显示「后台索引服务没有运行」，点「启动服务」即可。如果反复停止，点「查看日志」，把日志发给 support@memtrove.app。

语义模型下载失败？ 检查网络后在「设置 › 语义检索模型」里重试。下载支持断点续传，文件会校验完整性。