macOS下如何通过Spotlight执行带命令行参数的shell脚本

核心问题梳理 #

• 现有 shell 脚本没有做参数透传：Windows 批处理里的%*作用是把所有传入的参数原样转发给后续程序，你当前的mclip.command完全没有对应逻辑，就算拿到参数也无法传递给 Python 程序。
• 原生 Spotlight 的设计限制：macOS 自带 Cmd+空格唤起的 Spotlight，只会直接执行搜索到的可执行文件/脚本，不支持在搜索框内追加参数运行，这是系统交互逻辑和 Win-R 的本质区别。

第一步：修复脚本的参数透传逻辑 #

把你现有的mclip.command内容替换为：

#!/usr/bin/env bash
# 不需要保留终端输出/弹窗的话，可在下行末尾追加 > /dev/null 2>&1
python3 /Users/Andrea_5K/mclip.py "$@"
# 跑完自动关闭终端窗口的配置
exit 0

说明：bash 里的"$@"和 Windows 批处理的%*作用完全一致，会把所有传入当前脚本的参数完整、无差错地转发给后续的 Python 程序，就算参数带空格也能正常解析。

第二步：给脚本补执行权限 #

打开终端运行以下命令（替换为你实际存放mclip.command的路径）：

chmod +x /实际/路径/到/mclip.command

没有执行权限的脚本无论双击还是被 Spotlight 调用都会直接报错。

对应两种使用需求的实现方案 #

需求1：想要和 Win-R 完全一致的「输命令带参数运行」体验 #

把脚本做成系统全局可调用的命令，放到系统 PATH 目录下：

1. 执行命令创建软链接（替换为你实际的脚本路径）：

   sudo ln -s /实际/路径/到/mclip.command /usr/local/bin/mclip
   

2. 之后打开任意终端，直接输入mclip agree就能正常运行，和 Windows 的 Win-R 运行逻辑完全一致。

需求2：不想开终端、直接靠 Spotlight 快速唤起 #

原生 Spotlight 不支持传参，可按现有预置的关键词拆分脚本：
比如你现在内置了agree/busy/upsell三个关键词，就分别创建三个对应的脚本：

• mclip_agree.command 内容写死参数：

  #!/usr/bin/env bash
  python3 /Users/Andrea_5K/mclip.py agree
  exit 0
  

• 同理创建mclip_busy.command、mclip_upsell.command

给三个脚本都加完执行权限后，你在 Spotlight 输入mclip agree就能直接匹配到对应脚本，回车就会直接把对应文本复制到剪贴板，不需要手动开终端输参数。
如果需要支持任意输入关键词的场景，可以换用支持命令带参数运行的第三方启动器（比如 Alfred、Raycast），这类工具的唤起框完全支持输入mclip 关键词的运行逻辑，和 Win-R 的体验几乎没有差别。

内容的提问来源于stack exchange，提问作者aurumpurum