Shortcuts

Shortcuts 是 iOS、iPadOS 和 macOS 上的强大自动化工具，让你轻松完成更多任务。使用 Shortcuts，只需说几个字或轻点按钮，即可快速执行日常任务。你可以创建自定义快捷指令，将不同应用的多个步骤合并为一个流畅的操作，或者从图库中选择数百个预制的快捷指令。Protocol Launcher 允许你生成深度链接，以便打开 Shortcuts 并与你的工作流进行交互。

使用

提供两种使用方式：

• 按需加载（通过子路径导入），支持 Tree Shaking，体积更小。
• 全量导入（从根包导入），使用简单，但会包含所有应用模块。

生产环境建议使用按需加载以减小体积；快速脚本或演示可选择全量导入。

选择安装方式

按需加载

推荐使用。生产环境优化。

全量导入

使用便捷。适合快速脚本。

打开 Shortcuts

On-Demand

import { open } from 'protocol-launcher/shortcuts'

const url = open()

打开 Shortcuts

创建快捷指令

在 Shortcuts 中创建新的快捷指令。

On-Demand

import { create } from 'protocol-launcher/shortcuts'

const url = create()

创建快捷指令

打开图库

打开 Shortcuts 图库以浏览和发现快捷指令。

On-Demand

import { openGallery } from 'protocol-launcher/shortcuts'

// 打开不带搜索的图库
const url = openGallery()

// 打开带搜索查询的图库
const url = openGallery({
  query: 'photos',
})

打开图库 打开带搜索的图库

打开快捷指令

在图库中打开特定的快捷指令。

On-Demand

import { openShortcut } from 'protocol-launcher/shortcuts'

const url = openShortcut({
  name: 'Kaleidoscope Compare',
})

打开快捷指令

运行快捷指令

运行特定的快捷指令，可选择带输入。

On-Demand

import { runShortcut } from 'protocol-launcher/shortcuts'

// 不带输入运行快捷指令
const url = runShortcut({
  name: 'Kaleidoscope Compare',
})

// 带文本输入运行快捷指令
const url = runShortcut({
  name: '将文本转为音频',
  input: 'text',
  text: '测试将文本转为音频',
})

// 带剪贴板输入运行快捷指令
const url = runShortcut({
  name: 'Add to Notes',
  input: 'clipboard',
})

运行快捷指令 运行带文本输入的快捷指令 运行带剪贴板输入的快捷指令

使用 X-Callback-URL 运行快捷指令

使用 x-callback-url 协议运行快捷指令，以实现高级回调处理。

On-Demand

import { xCallbackRunShortcut } from 'protocol-launcher/shortcuts'

// 不带回调运行快捷指令
const url = xCallbackRunShortcut({
  name: '计算小费',
  input: 'text',
  text: '24.99',
})

// 带成功和取消回调运行快捷指令
const url = xCallbackRunShortcut({
  name: '计算小费',
  input: 'text',
  text: '24.99',
  xSuccess: 'myapp://success',
  xCancel: 'myapp://cancel',
})

使用 X-Callback-URL 运行快捷指令 运行带回调的快捷指令