找答案，也应该和找文件一样快

快速上手：从安装到第一次搜索

四步走完，约三分钟。如果你只记住一件事，那就是 ⌥Space。

1. 从 Mac App Store 安装打开 Locseek 的 App Store 页面 点击获取，这是唯一的官方下载渠道。要求 macOS 12 或更高，Intel 与 Apple Silicon 均原生支持。
2. 启动并选择要索引的位置首次启动的引导会请你授权文件夹：免费版在桌面 / 文稿 / 下载中任意组合（先选一个也行，另外两个随时能加），Pro 可选整个启动盘、任意文件夹、外置盘或 NAS。你选哪里，它搜哪里。
3. 顺手勾上「登录时启动」（可选）引导里这个复选框默认是关闭的，只有你亲手打开才会注册。建议开：不常驻的话全局快捷键按下去没反应，而且进程不运行期间的文件变化会累积，下次打开可能要多扫一会儿。不想开也完全没问题。
4. 按下 ⌥Space，输入文件名结果随输入即时出现——扫描期间就能边扫边搜，不用等。
5. Space 预览，Return 打开先用 Quick Look 确认，再打开；或 ⌘Return 在 Finder 中显示。

授权与权限

macOS 对 App 能访问哪些文件有严格限制：你能搜哪里，取决于你授权了哪里。这也是最高发问题「权限弹框反复出现」的解法所在。

为什么必须选择文件夹？

从 Mac App Store 安装的应用，只能访问你通过系统文件选择器明确授予的位置——授权一次，系统就会记住，不用每次都选。这项机制恰恰是保护你的：范围之外的一个字节，它在系统层面就碰不到。授权位置可随时在 Locseek「设置 → 位置」中增删，也可在「系统设置 → 隐私与安全性 → 文件与文件夹」中撤销。

「Locseek 想访问其他 App 的数据」弹框反复出现？按顺序试这四步

macOS 14+ 中，访问受保护位置或其他 App 创建的文件时系统会弹出此确认框。这是系统行为，不是 Locseek 在索取额外权限。已经点了「允许」还是反复弹，依次尝试：

1. 重新开关「App 管理」权限系统设置 → 隐私与安全性 → App 管理，关闭再打开 Locseek 的开关，然后重启 Locseek。
2. 重启 Mac刷新系统权限缓存，多数反复弹框在这一步解决。
3. 删除并重新安装 Locseek从 App Store 重装后重新完成位置授权（索引会自动重建）。
4. 授予「完全磁盘访问」系统设置 → 隐私与安全性 → 完全磁盘访问权限，打开 Locseek 并重启 App，弹框不再出现。

完全磁盘访问（FDA）：何时需要

Locseek 没有申请 FDA 相关的 entitlement，设计上也不依赖它——免费版的范围只有桌面 / 文稿 / 下载，应用里根本不会向你提起 FDA。

它只在两种情况下有意义，都属 Pro：想索引整个启动盘里受系统额外保护的位置；或者想放开「云盘文件名」与「App 私有数据」这两类默认排除。授予路径：系统设置 → 隐私与安全性 → 完全磁盘访问权限。不授予，其余功能完全不受影响。

要说清楚的是：FDA 放开的只是「能看到哪些名字」。产品承诺一个字不变——不读文件内容、不联网、不上传。

如何撤销授权与清除数据

• 撤销单个位置：Locseek 设置 → 位置，移除即可。移除只影响索引范围，不动磁盘上的文件。
• 撤销系统权限：系统设置 → 隐私与安全性 → 文件与文件夹 / 完全磁盘访问权限。
• 只想丢掉索引：设置 → 关于 →「删除索引…」，应用会退出，下次启动重建。
• 彻底清除：设置 → 关于 →「重置所有本地数据…」。它会删掉 Locseek 在这台 Mac 上写下的一切——设置、搜索与打开历史、索引、学习排序数据、已保存的文件夹授权、登录启动登记、缓存、窗口状态与崩溃报告，然后立即退出。不会触碰你的文件。
• 应用自己删不掉的两样：把 Locseek 拖进废纸篓，再在「前往文件夹」输入 ~/Library/Containers/ 删掉 Locseek 对应的那一项（App Store 版的数据都在沙盒容器里）。系统隐私授权需要你自己去系统设置里撤销。

搜索语法

关键词之外，用操作符一行收窄全部结果。输入时按 Tab 补全操作符（ex → ext:），操作符自动着色并显示为可视化标签。忘了写法？清空搜索框，空状态里的「高效用法」是同一份速查表（可折叠）。

• 关键词不区分大小写；多个关键词是 AND 关系：invoice 2026
• 排序规则：完全匹配 > 前缀 > 词首 > 包含，稳定可预期

常用配方

快捷键

从唤起到 Finder，全程不碰鼠标。唤起热键默认 ⌥Space，可在设置中自定义为任意含 ⌘ ⌥ ⌃ ⇧ 的组合。

搜不到某个文件？先看这四条

这是最高频的问题，而且绝大多数不是故障。按顺序对一遍，通常第一条或第二条就命中了。

① 它在你授权的位置里吗

Locseek 只索引你通过系统面板明确授权的位置。免费版是桌面 / 文稿 / 下载中你选中的那些；Pro 是你添加的任意位置。不在范围内的文件不是「搜不到」，是「本来就没被收录」。
去 设置 → 位置 看一眼清单和每行的状态点：绿色可读，灰色表示离线或授权失效（点「重新授权」即可）。

② 它是不是落在默认排除里

为了让日常结果干净，Locseek 默认排除四类范围。这四个开关需要 Pro 才能修改，免费版看得到说明但改不了（因为免费版的范围本来就只有那三个日常目录）。

放开路径：设置 → 排除，取消勾选对应类别。取消勾选后只影响查询展示，不重扫、不重写索引，结果立刻变多。云盘那两类取消勾选后仍然只索引文件名，永不读取或下载内容。

③ 首次扫描跑完了吗

看状态栏：「正在建立索引 · 已可搜 N 项」表示还在扫，结果会持续增加；变成「N 项」就是已经收敛。首次全盘建库需要时间，取决于磁盘和文件数量——期间常用位置已经可以边扫边搜，不用干等。

④ 是不是查询条件太窄了

• 多个关键词是「都要命中」。少打一个词试试。
• under: 的边界是精确目录，而且必须写绝对路径；写成 ~/… 这个条件会被丢掉。
• 只写了排除条件（比如只有 !草稿）不会返回任何结果，还需要一个要找的词。
• hidden: / package: 是「只看这一类」，不是「也看这一类」——隐藏项与包内部默认已经在范围内，一般不需要写。

还是没有？

确认以上四条都不是之后，再考虑 设置 → 索引 → 维护 → 「重建索引…」。重建期间搜索仍然可用（旧索引继续服务），完成后状态栏恢复正常计数。只有在「结果与磁盘明显不一致、且等自动更新也没恢复」时才需要这一步。

其他故障排查

「搜不到某个文件」请先看上一节。这里是其余症状。

刚新建 / 改名的文件搜不到

• 正常情况下，文件变化到能被搜到大约 1 秒（内部基准 120 分钟持续增删改样本的 p95 约 1.0 秒）。先等一下再试。
• 检查是不是勾了 设置 → 索引 → 维护 → 「暂停自动更新」。暂停期间现有索引和搜索都还能用，但新增、改名、删除不会自动反映。
• 确认文件在已授权位置内，且不在默认排除范围里。
• 仍不行：设置 → 索引 → 维护 → 「重建索引…」。

权限弹框反复出现

见上文 授权与权限 的四步解法：重开关 App 管理 → 重启 → 重装 → 完全磁盘访问。

云盘里的文件（iCloud / OneDrive / Dropbox / Google Drive）

• 默认搜不到，这是设计而非故障。「云盘文件名」属于四类默认排除之一，放开方式见上一节（需 Pro + 完全磁盘访问）。
• 放开之后，「仅云端」的占位文件只记录名字与路径，不触发下载——能搜到，打开时才由系统真正下载。不跑流量，也不占磁盘。
• 在 Finder 里直接添加「iCloud 云盘」也可以：系统面板返回的是兼容子目录，Locseek 会映射到完整的 iCloud 名称空间，不会只扫到几十项。

某次搜索变慢了

• 全盘正则是重查询，秒级属预期；配合关键词、ext: 或 under: 收窄即可。
• 普通搜索持续变慢：看索引点是否黄色忙碌（扫描或整理期间会短暂变慢，完成即恢复）。

其他高频情况

• 批量操作被截断在 10 项：免费版的边界，不是故障；分批操作或升级 Pro。
• 结果数停在上限：状态栏会说明「匹配项超过上限，只保留最相关的 N 条」。此时点列头是在这批结果内排序，不会回到全部匹配项里重新取——缩小关键词更有效。免费版上限 1,000 条，Pro 可在设置里调到 30,000。
• ⌥Space 唤不出来：确认 App 在运行（菜单栏有图标）；热键与其他 App 冲突时在 设置 → 快捷键 换一组；单击菜单栏图标同样可显示窗口。
• 彻底重建：设置 → 关于 → 「删除索引…」，应用退出后下次启动会重新建立。不需要你手工去删任何目录。
• 要给反馈但不想暴露文件名：设置 → 关于 → 「拷贝诊断信息」。里面只有版本、索引计数和最近一次重建原因，没有路径、没有文件名。

购买与订阅

所有交易通过 Mac App Store 完成，由 Apple 处理——Locseek 不接触你的付款信息。

• 两种 Pro，功能完全相同：$9.99/年自动续订，或 $24.99 一次性买断（美国区参考价，实际以 App Store 各地区显示为准）。
• 14 天免费试用：符合资格的新订阅用户订阅年度版时自动获得，到期前取消不收费。是否符合资格由 App Store 判定，并在应用内购买页购买前显示——以那里为准。
• 恢复购买（换机 / 重装）：同一 Apple 账户登录 → App Store 下载 Locseek → 应用内购买页点「恢复购买」。
• 取消订阅：App Store → 头像 → 账户设置 → 订阅 → 取消。当前周期内 Pro 仍可用，到期自动回到免费版，索引与设置保留。
• 退款：前往 reportaproblem.apple.com 按 Apple 标准政策申请。
• 年付换买断：先取消订阅（当前周期仍可用），到期后在应用内购买终身版。
• 发票 / 收据：由 Apple 提供，见购买确认邮件或 reportaproblem.apple.com。
• 降回免费版会怎样：订阅到期后回到免费档——索引、设置与已授权的位置都保留，只是结果上限回到 1,000 条、高级查询与排除设置不再可用。已经授予的文件夹授权不会被撤销。

完整的档位对比见 价格页。

常见问题

最高频的问题，每条尽量三句话说清。