显示通知(Toast)

📖 节点概述

在桌面应用程序中弹出一个短暂停留的通知提示（Toast）。支持三种类型：Info（信息）、Warning（警告）、Error（错误），每种类型对应不同的图标和颜色。通知标题固定为“节点通知”，内容由用户自定义。该节点为执行节点，具有执行输入和执行输出端口，不改变数据流。

💡 使用场景：

• 关键步骤提示：在自动化流程的关键节点（如文件保存成功、任务完成）显示提示，提醒用户。
• 错误告警：当流程检测到异常（如网络请求失败、数据校验不通过）时，弹出错误通知。
• 用户引导：在需要用户手动干预前弹出提示信息，告知下一步操作。
• 调试反馈：在测试流程时，通过通知反馈当前执行状态，避免频繁查看日志。
• 任务进度通知：长任务完成后弹出通知，告知用户结果。

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

节点有一个执行输入 Exec，一个数据输入 Message（字符串），以及一个下拉选择 Type，输出执行信号 Exec。

场景案例：文件保存成功后弹出信息通知

1. 触发执行：在【写入文件】节点成功保存后，将 Exec 输出连接到【显示通知】的 Exec 输入。
2. 设置类型：选择 Info（信息）。
3. 设置消息：在“Message”文本框中输入 文件已成功保存！。
4. 继续流程：节点的 Exec 输出可连接到后续节点。
5. 运行样式：桌面右下角（或指定位置）弹出提示框，显示“节点通知 - 文件已成功保存！”。

错误通知示例：

• 类型选择 Error，消息为 无法连接到数据库，请检查网络。
• 弹出时通常带有红色背景或错误图标，引起用户注意。

警告通知示例：

• 类型选择 Warning，消息为 磁盘空间不足，请及时清理。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 工作机制

• 当 Exec 被触发时，读取 Type 和 Message 的值。
• 通过引擎的 toast_signal 发射信号，参数为类型字符串（转换为小写）、固定标题“节点通知”和消息内容。
• 信号发送后，应用程序会弹出对应的原生提示框（停留数秒自动消失）。
• 然后触发 Exec 输出端口，继续执行后续节点。

⚠️ 注意事项

• 应用程序依赖：该节点仅在桌面应用程序环境中可用（如基于 PyQt/PySide 的应用），在纯控制台或无 GUI 环境中不会显示弹窗，但不会报错。
• 停留时长：通知的显示时长由应用程序全局设置决定（通常为 3~5 秒），节点无法单独控制。
• 消息长度：建议保持消息简短（不超过 100 字符），过长可能被截断或影响显示。
• 类型区分：Info、Warning、Error 仅影响显示样式，不影响流程逻辑。
• 执行阻塞：通知弹窗是非阻塞的，显示的同时后续节点会立即执行，不会等待用户点击或关闭。

💎 小贴士：

• 在长时间运行的流程（如批量数据处理）中，可在关键步骤后弹出通知，让用户了解进度，无需一直盯着控制台。
• 结合【条件判断】节点，仅在满足特定条件（如成功率低于阈值）时弹出警告或错误通知。
• 通知内容支持动态拼接，可先使用【格式化字符串】节点生成消息，再连接到 Message 端口。
• 如果需要在流程中多次弹窗，注意不要过于频繁，以免打扰用户。