快捷指令与自动化
Courier 向快捷指令 App 暴露四个动作。它们与 App 同进程运行——同一份数据、 同一批订户、同一本台账。
前置条件
批注/语音类动作要发往批注订户——先配一个(编辑部 → 订户,类型选 批注)。
动作
批注
批注(文本?, 订户?) → 结果发送一条文字批注。不带参数时会弹输入框;有多个批注订户时,可用订户名指定 去向。
*例子:*Action 按钮绑一个「记一笔」快捷指令——一按、对 Siri 口述、完事。
立即发行
立即发行(日期区间?) → 发行条数与打开 App 等效的完整管线:读取新健康数据、发给所有开了自动发行的订户、 返回发出条数。可选日期区间用于补发。
*例子:*每天 08:00 的自动化——咖啡端上桌时,昨晚睡眠已经躺在你的笔记里。
读取数据
读取数据(日期, 类型) → JSON返回某天运动或睡眠的 canonical JSON,不发行任何东西——自己画图表、喂给 别的 App、或存进「文件」。
语音想法
语音想法(音频) → 结果接收一个音频文件,用你配置的转写方式转成文字,并作为批注发行。
*例子:*Apple Watch 上录段语音备忘,分享给这个快捷指令。
备注
- 动作有规范的输出值,可以串接(如
读取数据→ 获取词典值 → 通知)。 - 快捷指令发起的发行进同一本台账、遵守同一套幂等键——自动化不会制造重复。