Apple Shortcuts 是 macOS 与 iOS 上的自动化平台,快捷指令可通过图形界面创建、用 Cherri 代码编写或导入。
命令行运行:使用 shortcuts 工具,例如 shortcuts list 列出全部快捷指令,shortcuts run "My Shortcut" 运行指定指令,shortcuts run "My Shortcut" <<< "input text" 传入文本,也可用 URL scheme:open "shortcuts://run-shortcut?name=My%20Shortcut&input=text&text=Hello",其参数包括 name(URL 编码的指令名)、input(text 或 clipboard)、text(实际输入字符串)。
发现动作:macOS 将动作存于 ToolKit 数据库 ~/Library/Shortcuts/ToolKit/Tools-prod.*.sqlite,可用 dotfiles 脚本探查,如 ./analyze-shortcuts-actions.fish stats、vendors、actions raycast、search clipboard、doc。存储位置为 ~/Library/Shortcuts/Shortcuts.sqlite(指令定义)和 ~/Library/Shortcuts/ToolKit/(动作库),指令以二进制 plist 形式存于 SQLite,不建议直接编辑,代码化请用 Cherri。
持久化配置:建议在 iCloud Drive 用 JSON 而非扩展应用存配置,位置 ~/Library/Mobile Documents/com~apple~CloudDocs/dotfiles/shortcuts/config.json,配套 CLI 命令有 shortcuts-config get、set、get <key>;在快捷指令中使用指向该文件的 Get File/Save File。此方式便于 CLI(jq、shortcuts-config)访问、可版本控制、无应用依赖、跨平台,并可由 Claude Code 直接读写。
扩展应用:可添加动作的应用包括 Toolbox Pro(iOS 及 M1+ Mac,全局变量、OCR、设备信息)、Actions(iOS/macOS,180+ 额外动作,免费)、Menu Box、Logger、FocusCuts(仅 macOS)、Charty。原生 macOS 应用可用 mas install 1586435171 安装 Actions;包装的 iOS 应用需手动从 App Store 安装。安装后打开 Shortcuts 应用刷新 ToolKit 数据库,再查询动作与参数。
限制:macOS 不导入未签名快捷指令,cherri myshortcut.cherri --skip-sign 仅做语法检查,默认签名或 --hubsign 通过 RoutineHub 签名;签名文件含 AppleIDValidationRecord 与 SigningPublicKey,采用 AEA1 格式,codesign -dv 无法识别。部分 iOS 应用经兼容模式在 Apple Silicon Mac 运行,无法用 mas CLI 安装。Cherri 相关细节见 cherri 技能,此处未提供更多。