Keyboard Maestro

Keyboard Maestro 是一款用于创建和运行宏的 macOS 自动化应用。Protocol Launcher 会根据官方 URL Schemes 页面生成 Keyboard Maestro 链接：使用 keyboardmaestro scheme 的编辑器 URL，以及使用 kmtrigger scheme 的宏触发 URL。

用法

有两种使用此库的方式：

• 按需导入（On-Demand）从子路径导入，支持 tree-shaking，保持打包体积小。
• 完整导入（Full Import）从根包导入，使用方便但包含所有应用模块。

生产构建请选择按需导入；完整导入适合快速脚本或演示。

选择安装方式

按需加载

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

全量导入

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

输入用户名和序列号

生成官方文档中用于输入 Keyboard Maestro 用户名和序列号的编辑器 URL。

On-Demand

import { enterUserAndSerial } from 'protocol-launcher/keyboard-maestro'

const url = enterUserAndSerial({
  user: 'support@stairways.com',
  serial: 'ABCDEFGH0123456789',
})

编辑宏或宏组

生成官方文档中用于按名称或 UUID 编辑宏或宏组的编辑器 URL。

On-Demand

import { editMacroOrGroup } from 'protocol-launcher/keyboard-maestro'

const url = editMacroOrGroup({
  macroOrGroup: 'Activate Application Switcher',
})

const uuidUrl = editMacroOrGroup({
  macroOrGroup: 'D2F427A1-51E3-4719-820B-4C25B6FF7329',
})

编辑宏 通过 UUID 编辑宏

筛选宏

生成官方文档中用于筛选宏的编辑器 URL，也可以先选择宏组再筛选。

On-Demand

import { filterMacros } from 'protocol-launcher/keyboard-maestro'

const url = filterMacros({
  keyword: 'Activate',
})

const groupUrl = filterMacros({
  group: 'All Macros',
  keyword: 'Activate',
})

筛选宏 选择宏组并筛选宏

筛选动作

生成官方文档中用于筛选动作的编辑器 URL，也可以先选择动作分类再筛选。

On-Demand

import { filterActions } from 'protocol-launcher/keyboard-maestro'

const url = filterActions({
  keyword: 'Execute',
})

const categoryUrl = filterActions({
  category: 'All Actions',
  keyword: 'Execute',
})

筛选动作 选择分类并筛选动作

触发宏

生成官方文档中的 kmtrigger URL，用于按名称或 UUID 触发一个处于 Active 且 Enabled 状态的宏，也可以带上触发值。

On-Demand

import { triggerMacro } from 'protocol-launcher/keyboard-maestro'

const url = triggerMacro({
  macro: 'Your Macro Name',
})

const uuidUrl = triggerMacro({
  macro: '224AA8CB-07EB-4C92-8201-68FED82B6E9F',
})

const valueUrl = triggerMacro({
  macro: 'Your Macro Name',
  value: 'Your Trigger Value',
})

const uuidValueUrl = triggerMacro({
  macro: '224AA8CB-07EB-4C92-8201-68FED82B6E9F',
  value: 'Your Trigger Value',
})

官方文档

• Keyboard Maestro URL Schemes