核心用法
Spotlight 技能通过 mdfind 命令行工具调用 macOS 系统级 Spotlight 索引，实现本地文件的快速内容搜索。用户指定目标目录和搜索关键词后，脚本返回匹配的文件路径、类型及大小信息，支持通过 --limit 参数控制结果数量。
显著优点
1. 极速搜索：基于预构建的系统索引，无需逐文件扫描，响应时间近乎即时，特别适合百万级文件量的文档库
2. 深度内容检索：原生支持 PDF、Word（docx）、Pages、Markdown、纯文本等格式的全文搜索，自动提取文档内部文字
3. 多语言支持：对中文、日文等 CJK 字符无额外配置需求，直接支持
4. 元数据丰富：返回文件类型、大小等结构化信息，便于后续自动化处理
5. 低资源占用：相比 grep/ripgrep 的实时计算，Spotlight 查询几乎不消耗 CPU
潜在缺点与局限性
1. 平台锁定：仅限 macOS，Linux/Windows 用户需改用 ripgrep 或 Everything
2. 索引依赖：外部驱动器或新加入的目录可能未被索引，需手动启用 mdutil -i on
3. 语义局限：基于关键词匹配，无法理解同义词或概念关联（如"AI"与"artificial intelligence"需显式 OR 连接）
4. 隐私盲区：用户排除的目录（System Preferences > Spotlight Privacy）不可搜索
5. 同步延迟：新建文件可能需要数分钟才能完成索引
适合人群
- macOS 用户需要频繁在大量文档中定位特定内容
- 研究人员管理 PDF 论文库、法律从业者检索合同文档
- 开发者快速查找代码注释或技术文档
- 多语言文档工作者（中/日/英混合场景）
常规风险
- 隐私泄露：搜索历史可能被系统记录；共享设备上其他用户若拥有文件权限可能间接推断搜索范围
- 索引外泄：企业环境中，Spotlight 可能索引到不应被全局搜索的敏感目录（需配置排除规则）
- 结果误判：模糊匹配机制可能导致无关文件混入，重要决策前建议人工复核