快捷指令不支持递归，仅能通过“重复”和“重复每一项”两种循环实现迭代：前者按固定次数执行，后者遍历列表元素；嵌套循环可处理二维逻辑，变量+条件可模拟动态终止，但需规避空输入、修改原列表等常见误区。

macos 快捷指令本身不支持递归——它没有函数调用栈、无法自我调用，也没有原生的“调用自身”机制。所谓“递归逻辑”在快捷指令中只能模拟，本质仍是循环结构或条件跳转。真正可用、稳定、符合设计规范的是循环操作：包括“重复”和“重复每一项”，它们是构建迭代行为的唯一可靠方式。

两种核心循环操作的区别与适用场景

快捷指令提供两类循环，逻辑和数据流完全不同：

• “重复 N 次”：按固定次数执行同一组操作，不依赖输入列表。适合需要机械重复的动作，比如连续播放提示音 5 次、批量重命名文件时添加统一前缀、反复尝试网络请求直到成功（配合“如果”判断）。
• “重复每一项”：接收一个列表（如照片、文件、JSON 数组），对其中每个元素单独运行一次循环体。适合处理集合数据，例如遍历下载的 PDF 文件并逐个转成文本、读取 API 返回的多个用户信息并提取邮箱、为相册里每张图添加水印。

嵌套循环实现多层迭代

快捷指令允许将“重复”操作拖入另一个“重复”内部，形成缩进嵌套结构。这能表达二维逻辑，比如：

• 外层“重复 3 次”控制天数，内层“重复每一项”处理当天的待办事项列表；
• 外层遍历文件夹列表，内层遍历每个文件夹下的图片文件；
• 生成乘法表：外层控制行号（1–9），内层控制列号（1–当前行号），每次拼接“i×j=i*j”文本。

注意：嵌套过深会显著降低可读性，建议超过两层时拆分为多个快捷指令并用“运行快捷指令”调用。

macOS Local Voice

利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。

下载

用变量+条件跳出模拟“类递归”流程

虽然不能递归，但可通过变量控制循环提前终止，模拟某些递归终止条件：

• 添加一个数字变量（如“计数器”），初始设为 0；
• 在“重复”循环内，每次执行后用“增加变量”操作 +1；
• 插入“如果”操作，判断“计数器 ≥ 目标值”或“某结果符合条件”，满足则用“停止快捷指令”退出；
• 也可结合“获取 URL 内容”失败时的错误分支，实现“重试直到成功”的逻辑。

这种写法不是递归，但能达成类似效果：动态决定迭代终点，而非硬编码次数。

常见误区与避坑提醒

实际搭建时容易踩几个关键坑：

• 误把“重复每一项”的输入留空——它必须连接一个明确的列表，否则循环不会执行（连 0 次都不会）；
• 在“重复”循环里修改被循环的原始列表——快捷指令中列表是只读快照，循环体内增删元素不影响当前迭代次数；
• 期望“重复”输出单个值，却得到列表——每次迭代的最后一个操作输出会被自动聚合成列表，需用“从列表中获取项目”或“求和”等操作再处理；
• 在循环中调用需用户交互的操作（如“要求输入”），会导致每次迭代都弹窗——应提前获取输入，或改用“每次均询问”变量设定循环次数。