核心用法
Spotlight Search 是调用 macOS 系统级 Spotlight 索引（mdfind）的本地文件搜索技能，通过封装脚本 spotlight-search.sh 实现快速检索。用户指定目录路径与关键词即可在毫秒级返回结果，无需遍历文件系统。
基础命令结构：
scripts/spotlight-search.sh <目录> <查询词> [--limit N]
支持布尔运算（AND/OR）、精确短语（引号包裹）及元数据过滤（如按文件类型 kMDItemContentType）。
显著优点
1. 极速性能：基于系统预建索引，百万级文件秒级响应，远胜 grep/ripgrep 的全盘扫描
2. 深度内容感知：自动解析 PDF、Word、Pages、代码文件、邮件等格式的内部文本，无需手动提取
3. 原生多语言：对中文、日文等 CJK 字符无额外配置支持，解决传统工具编码痛点
4. 低资源占用：查询过程几乎不消耗 CPU，适合后台持续集成
5. 隐私合规：严格遵循系统「聚焦隐私」设置，自动排除用户标记的敏感目录
潜在缺点与局限性
- 平台锁定：仅运行于 macOS，Linux/Windows 需切换至 grep/ripgrep/Everything
- 索引依赖：外接硬盘、网络卷宗若未启用索引则无法搜索；新文件需等待系统完成索引（通常数分钟）
- 非语义搜索：基于关键词匹配，无法理解概念相似性（如搜索"AI"不会返回"深度学习"相关结果，除非文档同时包含关键词）
- 模糊匹配干扰：系统内置同义词扩展可能导致误报，精确场景需手动加引号限制
- 权限门槛：启用/禁用索引需管理员密码，普通用户无法自助排查索引状态
适合人群
- macOS 开发者、研究人员、知识管理者——需要在大规模本地文档库（论文、代码、笔记）中快速定位信息
- 对命令行效率敏感的用户——厌倦 grep 的 IO 瓶颈
- 多语言内容工作者——依赖原生中文检索准确性
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 索引盲区 | 隐私设置或外部磁盘未索引导致漏检 | 查询前执行 `mdutil -s` 验证索引状态 |
| 结果过泛 | 模糊匹配返回大量无关文件 | 使用 `"精确短语"` 或 `--limit` 限制 |
| 权限提升误用 | 脚本可能被诱导执行 `sudo mdutil` 修改系统设置 | 确认技能仅调用只读查询，不涉及自动提权操作 |
| 元数据泄露 | 返回结果包含敏感文件路径 | 依赖系统级隐私设置，建议定期审查「聚焦」排除列表 |
集成建议
典型 LLM 工作流：Spotlight 定位候选文件 → read 工具提取内容 → 摘要或问答生成。该模式充分发挥「快搜+精读」的分工优势。