Memtrove 使用指南

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

系统要求：macOS 12 或更新，Apple Silicon（M 系列芯片）的 Mac。

安装

1. 下载 Memtrove_x.y.z_aarch64.dmg，双击打开，把 Memtrove 拖进「应用程序」。

2. 打开 Memtrove。第一次打开会有一个简短的引导：

   步骤	做什么	能跳过吗
   允许访问你的文件	在「系统设置 → 隐私与安全性 → 完全磁盘访问权限」里打开 Memtrove	可以，但「文稿」「桌面」「下载」等受保护的文件夹会被跳过，期间系统可能反复弹出授权提示
   语义检索	下载约 130 MB 的本地模型，之后完全离线运行（以后可以在设置里换成增强模型）	可以，之后在「设置 → 语义检索模型」里下载；没有模型时仍可按文件名和全文搜索
   接入 Claude	把 Memtrove 加到 Claude Desktop 的配置里（会先给你看要改的文件，确认后才改，并备份原文件）	可以，之后在「设置 → 接入 Claude」里做

搜索

• 在任何地方按 ⌥Space 唤出 Memtrove，直接输入。
• 结果按文件名 → 全文 → 语义合并排序。文件名和正文都能搜中文。
• 可以写时间和位置：「上个月的合同」「下载文件夹里的发票」。
• ↵ 打开，⌘↵ 在 Finder 中显示。右侧是预览：先看目录，点标题看那一节；底部「相似文件」找内容相近的文件。
• 用「增强」模型时可以跨语言搜：用中文问英文文档，或者反过来。「标准」模型下，用文档本身的语言搜效果最好。

结果旁的标记说明索引进度：刚加进来的文件可能只有文件名（L0），全文（L1）和语义（L2）稍后补上。

其他页面

• 时间线：最近新建 / 修改过的文件，可选今天、7 天、30 天、90 天。
• 状态：每个索引目录、每个书签文件的进度；嵌入模型；书签的死链与重复（点「重复 N 组」查看每一处）。
• 目录：选择要索引的范围。默认整个主目录（~/Library、应用、照片图库等除外），也可以只选几个文件夹，或加外接硬盘上的文件夹。
• 设置：语言、许可证、开机自启、语义检索模型、接入 Claude、书签网页抓取、敏感目录、资源占用、语义模型（增强 / 标准）、检查更新。

语义模型

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

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

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

语言

界面默认跟随 Mac 的首选语言（中文或英文），可以在「设置 → 语言」里改。

敏感目录

把放合同、病历之类的文件夹设为「敏感目录」后，里面的文件仍能被搜到，但：

• 「只给目录结构」：预览和 Claude 只能看到章节标题；
• 「完全不给」：预览和 Claude 都看不到内容。

在 Claude 里使用

接入后（重启 Claude Desktop 生效），直接问 Claude，例如「帮我找上个月和 A 公司的合同，总结付款条款」。 Claude 能用的工具：搜索、读取（先读目录再按需读某一节）、相似文件、时间线、状态、给文件加标签。全部只读，Memtrove 不会修改或删除你的文件。

在 Claude Code 里使用：在「设置 → 接入 Claude」复制那条 claude mcp add … 命令，在终端运行。

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

开机自启

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

许可证与试用

• 安装后 14 天内全部功能可用。
• 购买许可证（一次买断）后永久可用，并包含一年的更新。一年后软件继续能用，只是之后发布的新版本需要续费更新（每次续费再得一年）。
• 试用结束且没有许可证时：索引照常维护，桌面端只能按文件名搜索；全文和语义搜索、预览、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 想要访问…」？ 打开完全磁盘访问权限即可一次解决。

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