人人都能做扩展:Raycast脚本命令(Script Commands)入门指南
你是否曾有过这样的瞬间:“要是我能一键清空‘下载’文件夹里所有的 .zip 文件就好了”、“要是我能输入一个项目代号,就直接在浏览器里打开对应的Jira页面就好了”……这些微小但重复的需求,在Raycast的扩展商店里找不到现成的,自己动手开发一个功能齐全的扩展又似乎遥不可及。 如果你曾因此感到遗憾,那么本文将为你推开一扇全新的大门。我们将为你揭示Raycast自定义扩展最神秘、也最简单的一面——
脚本命令 (Script Commands) 。我们将手把手地教你,哪怕你几乎没有编程基础,也能通过几行简单的代码,为你自己量身定做一个独一无二的Raycast命令,让你真正成为工具的主人。
什么是脚本命令?——你的第一个“Hello, World”扩展 忘掉复杂的开发环境、编译和打包吧。要创建一个脚本命令,你只需要一个工具:
文本编辑器 。
核心概念解析 脚本命令本质就是一个你编写的简单脚本文件(如Shell脚本、Python脚本、AppleScript等)。你只需把它放在Raycast指定的文件夹里,并按照特定格式在文件开头写上几行“说明书”(我们称之为元数据注释),Raycast就能自动把它识别成一个可以执行的命令。
准备工作 一个代码编辑器: 强烈推荐免费且强大的 Visual Studio Code ,当然,系统自带的“文本编辑”App也可以。
一种脚本语言: 你不需要特地去学。对于所有Mac用户,
Shell/Bash 脚本都是系统内置的,我们今天就以它为例。
零到一:创建你的第一个命令 让我们通过一个具体的例子,体验从无到有的完整过程。
打开脚本目录: 唤出Raycast ( Command+Space ),输入 Create Script Command 并回车。这是Raycast提供的官方向导。
选择模板: 在向导中,Raycast会让你选择模板。在“Template”处选择 Bash ,然后为你的命令(文件名)命名,例如 hello-kejiciwei 。点击“Next”,为它选择一个存放的子目录(可以直接存放在根目录),最后点击“Create Script Command”。
理解模板文件: Raycast会自动用你设置好的代码编辑器(如VSCode)打开一个名为 hello-kejiciwei.sh 的模板文件。你会看到文件内容分为两部分:
顶部以 # 开头的注释: 这就是我们说的“说明书”,即元数据…