核心用法
Spotlight 技能通过封装 mdfind 命令，调用 macOS 系统级 Spotlight 索引实现本地文件搜索。主要命令格式为 scripts/spotlight-search.sh <目录> <查询词> [--limit N]，支持关键词匹配、精确短语、布尔运算（AND/OR）及元数据过滤等高级语法。
显著优点
1. 极速检索：依赖预构建索引，无需逐文件扫描，百万级文件瞬间返回结果
2. 深度内容感知：原生支持 PDF、Word、Pages、Markdown、代码文件等格式的全文检索
3. 多语言支持：对中文、日文等非英语内容检索效果优于 grep
4. 低资源占用：几乎零 CPU 开销，对比 grep/ripgrep 的大规模目录遍历
5. 隐私合规：自动尊重系统隐私设置，被排除目录不会出现在结果中
潜在缺点与局限性
1. 平台锁定：仅限 macOS，Linux/Windows 用户无法使用
2. 索引依赖：外部硬盘或新添加文件可能未被索引，需手动开启 mdutil -i on
3. 非语义搜索：基于关键词匹配，无法理解查询意图（需配合向量检索）
4. 结果模糊性：默认启用同义词和模糊匹配，精确搜索需手动加引号
5. 黑盒机制：无法自定义分词规则或索引策略
适合人群
- macOS 重度用户，拥有大量本地文档需快速定位
- 科研人员、律师、分析师等需要频繁检索 PDF/Word 报告的专业人士
- 开发者需要在海量代码库中查找特定文本片段
- 对检索速度敏感、无法容忍 grep 遍历延迟的场景
常规风险
- 结果不完整风险：隐私设置或索引延迟导致遗漏文件，重要场景建议二次验证
- 敏感信息暴露：检索结果可能包含被 Spotlight 索引的私密文档路径，分享屏幕时需注意
- 路径注入风险：若脚本未对用户输入的目录路径做校验，可能存在路径遍历隐患
- 外部驱动依赖：依赖外部卷索引状态，关键工作流应预先检查
mdutil -s状态