控制台打印

📖 节点概述

在运行日志中输出自定义消息。支持从当前执行上下文中动态获取变量值（使用模板语法），可选择四种输出级别（普通、高亮、警告、错误），便于区分日志重要性。节点支持通过动态数据端口（最少1个）追加任意数量的连线数据，自动附加到消息末尾。同时新增 输出结果 端口，将最终生成的打印字符串输出给下游节点使用。该节点为执行节点，具有执行输入和执行输出端口，不改变数据流。

💡 使用场景：

• 调试变量：在关键位置打印变量实际值，快速定位逻辑错误。
• 流程状态监控：输出当前步骤的简要说明，便于跟踪流程运行情况。
• 上下文信息展示：打印当前激活的标签页 ID、用户选择项等上下文信息。
• 条件触发日志：根据条件使用不同输出级别，例如数据异常时使用“警告”或“错误”。
• 临时注释：在流程中留下文字备注，便于多人协作或后期维护。
• 数据管道检查：将中间结果通过“输出结果”端口输出，供后续节点使用（如记录日志文件）。

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

节点有一个执行输入 Exec，一组动态数据输入端口（默认 数据 A、数据 B…，可增减），一个执行输出 Exec，以及一个数据输出端口 输出结果。同时还包含两个控件：打印内容（支持模板）和 输出级别。

场景案例：打印当前激活标签页的标题并传递结果

1. 触发执行：上游节点触发 Exec。
2. 设置打印内容：在“打印内容”框中输入带有变量占位符的文本，例如 当前标签页标题: {{A}}。
3. 连接数据源：将激活标签页标题连接到 数据 A 端口。
4. 输出级别：选择 🔵 高亮提示。
5. 执行：运行时，{{A}} 会被替换为实际值，日志输出类似 ✨ [魔法打印] 当前标签页标题: 百度一下。
6. 继续流程：Exec 输出触发下游节点。
7. 使用打印结果：将 输出结果 端口连接到其他节点，获取完整的打印字符串（例如用于写入文件或发送通知）。

多数据源示例：

• 通过右键菜单添加更多数据端口（如 数据 C），模板中使用 {{C}} 引用。
• 数据端口数量无上限，满足复杂调试需求。

不同级别示例：

• 🟢 普通信息 → ℹ️ [魔法打印] 普通消息
• 🔵 高亮提示 → ✨ [魔法打印] 高亮消息
• 🟠 警告信息 → ⚠️ [魔法打印] 警告消息
• 🔴 错误信息 → ❌ [魔法打印] 错误消息

⚙️ 引脚与参数说明

📥 输入引脚

📤 输出引脚

⚙️ 控件参数

🔧 工作原理

1. 收到 Exec 信号后，读取“打印内容”控件的原始字符串。
2. 解析其中的变量占位符（双花括号语法），从对应数据端口获取实际值并替换。
3. 将所有数据端口的值（若模板中未使用占位符）按顺序附加到消息末尾（作为追加内容）。
4. 根据“输出级别”选择对应的前缀图标，通过 logger.emit() 输出到运行日志。
5. 将最终生成的完整字符串保存，并通过 输出结果 端口输出。
6. 触发 Exec 输出端口，继续后续流程。

⚠️ 注意事项

• 变量解析：模板变量严格区分大小写，占位符字母必须与数据端口名称一致（如 {{A}} 对应“数据 A”）。若变量不存在或路径错误，占位符可能原样保留。
• 动态端口：右键菜单可增加或减少数据端口，至少保留一个。
• 连线数据转换：对于复杂对象，节点会尝试提取可读信息（如标签页的标题、ID），而不是输出内存地址。
• 日志输出：所有打印信息显示在“运行日志”面板中。
• 性能：打印操作很快，但频繁使用会产生大量日志。
• 不影响数据流：节点不修改任何数据，但 输出结果 可作为中间结果传递。

💎 小贴士：

• 常用调试变量包括当前激活标签页对象、最近错误信息等，具体变量名请参考运行环境文档。
• 若要打印字典或列表，建议先使用【转为字符串】节点格式化为 JSON。
• 不同输出级别可帮助快速过滤日志。
• 该节点是执行节点，注意执行顺序。
• 使用 输出结果 端口可以将打印内容写入文件或发送到远程日志系统。