捷径的 URL Schemes 与使用建议

我们在索引里已经给出了捷径的中文官方文档，在这个文档里，捷径有一部分内容是专门讲自己的 URL Schemes 的。

而我们这篇文章，会按照一份 URL Schemes 文档的方式，重新组织一下捷径的这些 URL Schemes，查起来会更加方便。

按照 URL 的结构重新整理捷径的 URL Schemes 文档

首先是启动用的基本 URL：shortcuts://，毫无悬念。而如果想要使用 x-callback-URL 的话，要以 shortcuts://x-callback-URL/ 开头。

接下来我们来看动作（Action），以及动作配套的参数（Parameter）。

新建 /create-shortcut

这是用于制作新捷径的 Action，完整的 URL 示例是 shortcuts://create-shortcut。

这个动作没有后续的参数，通过它可以直接开始创建一个新捷径，但我们不能指定这个捷径的标题等细节。

因为太常做新捷径了，所以我很常用这个动作。我会在 Launch Center Pro 里放一个 shortcuts://create-shortcut，每次要做新捷径的时候，直接点一下 Launch Center Pro 中的按钮，就会打开捷径并且进入创建新捷径的界面。

打开 /open-shortcut

这是用于打开某个捷径的 URL，所以它需要参数，而且要和参数结合在一起使用。这唯一的一个参数就是 name，它指的是捷径的名称。

示例：

shortcuts://open-shortcut?name=收集素材

注：

• name 后的 收集素材 是上周《18 利用捷径在 Ulysses 中收集资料》中的示例捷径，在使用的时候这里需要编码，因为它是中文。在链接里的中文和空格等都需要编码才能正常使用。
• 「打开」和下面「运行」的区别是，打开只是打开这个捷径的编辑界面，并不会运行它。

运行 /run-shortcut

这是用于运行某个捷径的 URL，所以它肯定有参数，而且一定要和参数结合在一起使用。这个动作之下的两个参数是：

• name：必填，它后面的值是捷径名称，比如我们之前的「获取 App Store 图标」。
• input：选填，它后面的值是输入内容，比如我们可以在这里填应用的链接。

示例：

shortcuts://run-shortcut?name=收集素材&input=https://sspai.com/post/31500

注：input 后的 https://sspai.com/post/31500 是《URL Schemes 使用详解》这篇文章

导入 /import-shortcut

这个动作比较鸡肋，一般不会用到。它是用于导入他人捷径的 URL，所以它也需要参数，而且也要和参数结合在一起使用。这个动作之下的 3 个参数是：

• URL：必填，它后面的值不是我们分享捷径的那个 URL，而是 .shortcut 文件的 URL。
• name：选填，它后面的值是导入的捷径的名称，这个名称你可以自定义，如果没有填，导入的捷径就会是原来的名称。
• silent：选填，如果不填的话，会在导入捷径之后打开被导入的捷径。如果添加进去后不想打开被导入的捷径，需要在结尾加上 &silent=true

示例：

shortcuts://import-shortcut?url=https://cdn-std.dprcdn.net/files/acc397233/CDMKy5?download&name=网易云音乐2Spotify&silent=true

注：这歌捷径是之前捷径群中的朋友搞不定的网易云音乐播放列表导出到 Spotify 播放列表的捷径。

/gallery 和 /gallery/search

这是捷径中心相关的两个动作，直接开启捷径中心的 URL 是 shortcuts://gallery。

如果想要在捷径中心搜索，就要用到 search 这个动作，随后参数，唯一的参数是 query。

示例：shortcuts://gallery/search?query=地图

在捷径中使用 x-callback-URL

使用 x-callback-URL 的时候有两个思路：

1. 在我这里运行完之后，去下一个应用
2. 先在下一个应用做一件事，再返回来

在捷径里，第一个操作完全用不着用 URL Schemes，它直接跳转就行了。

所以在 URL Schemes 一般都是用第二种。而第二种，它的本质就是在一个可以运行的 URL 后接一个 &x-success=目标应用 URL，任何应用都一样，捷径里也没有什么特殊的处理。

如果非说特殊的处理的话，我们在《专栏：x-callback-URL 的使用方法》中已经提到，我们可以直接用「打开 X-Callback URL」这个操作来实现跳转。

这个部分适合用图片来说明：

我们先用一个「URL」，里面放上 Drafts 5 创建新笔记的 URL drafts5:///create?text=A。接下来再接「打开 X-Callback URL」。

这样在 Drafts 添加完一条内容为「A」的笔记之后，就会返回到捷径，返回捷径之后我们会看到这条 Drafts 的唯一识别符。

另外在《专栏：x-callback-URL 的使用方法》最后我也提到，捷径里的 x-callback-URL 意义特别大，因为它可以连续重复地运用 x-callback-URL。

捷径能用到 URL Schemes 的场合

在捷径里，如果我们需要使用一些本地应用来完成自动化，但发现自己使用的应用虽然支持 URL Schemes，但捷径里没有内置这些操作，或者这些操作做得很不够，那就可以把这些应用的 URL Schemes 放到「URL」这个操作里，然后在其后接一个「打开 URL」，来实现自己想要的自动化。

另外，有一种情况，是在其它应用里调用捷径的 URL，这时候就需要用到我们这个文档了。

我个人比较常用的操作首先是只做新捷径：shortcuts://create-shortcut。前面说过我在 Launch Center Pro 里放一个这个动作，每次想做新捷径的时候直接点一下就看见创建捷径的空白界面了。

另外还有一种使用 URL Schemes 的场景，是根据一些条件，比如时间、地点或者什么其它的条件来触发捷径。

在有这种需求的时候，我们需要用其它能根据条件触发的应用，比如 Launch Center Pro 和 IFTTT。

Launch Center Pro 可以通过时间和地点来触发：

而使用 IFTTT 的话，我们要用到的是它 Rich Notification 的功能。当我们设定好 IFTTT 中的 trigger 部分，也就是「This」后，我们要把「That」的操作设为「Rich Notification from IFTT app」。

随后在里面主要设置「Link URL」这一项：

我们要把它设为我们想运行的捷径的 URL Schemes，用的应该是 shortcuts://run-shortcut?name=捷径名称&input=捷径输入 这个捷径。