DisplayDictionary 字典可视化监看与调试检视节点
节点核心功能 (What is it?)
DisplayDictionary 是一个实用的可视化检视构件，专门用于在工作流画布中直观呈现字典对象的键值结构与内容。它通过多行自适应文本框将字典数据格式化展开，极大便利了复杂工作流运行期间的数据结构排查、状态监视与在线调试。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 实时检视工作流中流转的字典字段、属性值与嵌套状态；
- 将复杂的多层嵌套数据结构以人类可读的高亮格式直观呈现；
- 监视上游数据字典在经过一系列过滤或合并运算后的动态变化；
- 处理类似 JSON 的异构响应数据时，清晰核对键名拼写与数据类型。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 DisplayDictionary 节点。
- 将任何输出字典工件的上游节点连接至本节点的
dictionary输入插槽。 - 节点面板内的显示区域将立刻以格式化排版呈现该字典的完整内容。
参数输入插槽 (Parameters)
- dictionary：待检视的目标字典输入对象（具备输入透传特性）。
- dictionary_display：在前端属性面板中内嵌展示的可视化多行格式化字符串（只读属性视图）。
输出引脚 (Outputs)
- dictionary：原样穿透传递的字典对象（与输入端完全一致，保持数据引用不变）。
典型工作流示例 (Example)
假设您正在调试一个解析用户档案的工作流：
- 在画布中添加一个 DisplayDictionary 节点。
- 将产生用户数据的节点（例如数据库查询结果或外部 API 调用）的输出连入该节点的
dictionary输入端。 - 节点面板立即展开易读、带缩进排版的用户属性明细。
- 您可以从该节点的
dictionary输出端继续引出连线至下游节点，调试监视两不误。
关键技术特性 (Important Notes)
- 非破坏性零开销透传 (Pass-through)：该节点仅在画布 UI 上渲染展示数据，绝不对原始字典的键值对进行任何修改或深拷贝开销。
- 多行自适应文本框 (Multiline UI)：针对深度嵌套的列表与子字典提供自适应换行与结构缩进，告别单行字符串拥挤。
- 全链路无感挂载 (In-line Debugging)：可直接串入已有连线中间充当探针（Probe），对上下游数据流无任何侵入性影响。
常见问题与排查 (Common Issues)
- 该节点为纯展示透传构件，无需复杂配置，一般无特定错误状态。