休眠(Sleep)

📖 节点概述

使当前执行流暂停指定的秒数（支持小数），然后继续执行后续节点。常用于等待外部条件、控制流程速率或模拟耗时操作。等待期间可响应外部中断（如点击停止按钮），最多在 0.1 秒内退出休眠。该节点为执行节点，具有执行输入和执行输出端口。

💡 使用场景：

• 限流控制：在循环或批量请求中插入休眠，避免触发 API 频率限制。
• 等待外部资源：等待文件生成、网络服务就绪或用户操作等。
• 动画/效果模拟：在自动化演示或 UI 模拟中控制步骤间隔。
• 定时轮询：在循环中定期检查某个条件，两次检查之间休眠一定时间。
• 调试延迟：人为插入延迟，便于观察流程执行过程或调试异步问题。

🎮 实战连线指南：如何正确使用它？

节点有一个执行输入端口 Exec，一个数据输入端口 Seconds（浮点数），以及一个执行输出端口 Exec。

场景案例：在两次 API 请求之间等待 2 秒

1. 触发执行：上游节点（如【HTTP 请求】）触发 Exec。
2. 设置休眠时间：在“Seconds”输入框中填写 2.0（或连线提供动态值）。
3. 连接后续：将 Exec 输出连接到下一个【HTTP 请求】节点。
4. 效果：每次请求完成后，流程会暂停 2 秒再发起下一个请求。

动态休眠时间：

• 从【变量获取】节点读取 interval 变量（如 0.5），连接到 Seconds 端口。
• 可根据业务逻辑动态调整等待时间。

中断响应：

• 在休眠期间，如果用户停止流程（或调用取消机制），节点会在最多 0.1 秒内感知到并退出，不会阻塞关闭。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 工作机制

• 节点接收到 Exec 信号后，读取 Seconds 参数（转换为浮点数，无效则使用 1.0）。
• 内部采用高频切片休眠法：将总时间拆分为若干个 0.1 秒的片段，在每个片段结束后检查流程是否被取消（如用户停止）。
• 这样可以保证在取消信号发出后，最多 0.1 秒就能响应并退出，而不是等待完整时长。
• 休眠完成后，触发 Exec 输出端口，继续后续流程。

⚠️ 注意事项

• 精度：休眠时间受操作系统调度影响，实际等待时间可能略大于指定值（通常误差在几毫秒到几十毫秒）。
• 中断响应：取消信号触发后，节点不会继续等待剩余时间，而是立即退出，且不会触发输出 Exec。
• 极短休眠：如果 Seconds 小于 0.1 秒，节点仍会至少执行一次 0.1 秒的休眠（实际会补偿剩余时间，但最小单位是 0.1 秒）。如需更精确的高频等待，请考虑使用更小粒度的切片（如 0.01 秒），但会增加 CPU 开销。
• 大量调用：在循环中频繁使用短时间休眠（如 0.1 秒）可能会使流程整体变慢，建议根据需要调整。
• 无副作用：节点不改变任何数据，仅控制执行时序。

💎 小贴士：

• 在循环中使用休眠时，建议将休眠时间设置为略高于 API 或服务的限流阈值，避免触发限制。
• 调试时，可使用 1~3 秒的休眠放慢流程，便于观察每个步骤的输出。
• 若需要等待条件满足（如文件存在），建议将休眠放在循环中，每次检查条件，不满足则继续休眠。
• 由于支持中断响应，该节点在需要长时间等待的场景下依然可以安全停止流程。