shortcuts_run

macOS

用途

按名称或标识符运行用户的某个 macOS 快捷指令：Mac 用户已经用它来自动化 HomeKit、专注模式以及目录未覆盖的第三方应用操作。它以快捷指令自身的权限运行该快捷指令自己的操作，而不是沙盒化的子集：与在“快捷指令”应用中点按“运行”相同。这是一项写入操作：第一次调用（confirm=false）会返回预览，列出快捷指令的名称、标识符和所在文件夹，但不会运行任何内容；设置 confirm=true 才会真正运行。若名称匹配多个快捷指令，则会连同两个标识符一并拒绝：请用其中一个重新调用，切勿猜测。若快捷指令在等待对话框或运行时间过长，会在有限的超时后被停止并给出明确提示，而不会让此调用一直挂起。

必填输入

• name_or_identifier

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构声明了明确的确认参数。请检查预览，并按此平台的契约授权实际操作。

• 仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

{
  "properties": {
    "confirm": {
      "description": "Must be true to actually run the shortcut. Without it, returns a preview.",
      "type": "boolean"
    },
    "input_text": {
      "description": "Optional text input for the shortcut, passed via a temp file — omit if the shortcut takes no input.",
      "type": "string"
    },
    "name_or_identifier": {
      "description": "Shortcut name or identifier, from shortcuts_list. An ambiguous name is refused — pass the identifier instead.",
      "type": "string"
    }
  },
  "required": [
    "name_or_identifier"
  ],
  "type": "object"
}

文档示例

shortcuts_run 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{
  "confirm": false,
  "name_or_identifier": "Demo morning brief"
}