跳转至

JSON Input 输入解析与畸形语法修复节点

从各类输入数据创建标准 JSON 节点，并具备基于算法的自动化语法修复能力。

节点核心功能 (Description)

JSON Input 节点接收多种上游数据类型并将其安全规整为标准的 JSON 数据结构。它内置了强大的 json-repair 语法纠错引擎，能智能化修复各种常见语法畸形（如键名缺少双引号、单引号包覆、尾随多余逗号等），为整个工作流管线提供健壮的数据接入保障。

配置与参数规范 (Parameters)

输入插槽 (Input Parameters)

参数名称 (Parameter) 数据类型 (Type) 语义说明 (Description) 默认值 (Default)
json json, str, dict 待录入并转换规整的源数据（可接收字典、文本或原生 JSON）。 {}

输出引脚 (Output Parameters)

输出名称 (Parameter) 数据类型 (Type) 语义说明 (Description)
json json 解析、语法修复并序列化后的标准化 JSON 数据工件。

核心特性解析 (Features)

  • 语法自动修复 (Automatic JSON Repair)：依托 json-repair 库，自动修复格式残缺、引号缺失的非标 JSON 字符串；
  • 多类型弹性兼容 (Multiple Input Types)：直接接收原生字典、纯文本字符串及其他异构数据类型；
  • 完善的容错回退机制 (Error Handling)：当遇到极端乱码无法解析时，平滑降级处理，避免引发整条工作流异常中断；
  • 毫秒级实时响应 (Real-time Processing)：上游输入数据或属性面板内容变动瞬间即刻触发重新解析。

使用代码示例 (Examples)

基础字典输入 (Basic Usage)

# 输入: {"name": "John", "age": 30}
# 输出: {"name": "John", "age": 30}

畸形字符串自愈修复 (Malformed JSON Repair)

# 输入: '{"name": "John", age: 30}'  # age 键缺失双引号
# 输出: {"name": "John", "age": 30}  # 自动修补引号并解析为合法对象

字符串向 JSON 对象转换 (String to JSON Conversion)

# 输入: '{"user": {"name": "Alice", "active": true}}'
# 输出: {"user": {"name": "Alice", "active": true}}

字典透传保护 (Dictionary Input)

# 输入: {"status": "active", "count": 5}
# 输出: {"status": "active", "count": 5}  # 原样保留原生类型并输出

典型适用场景 (Use Cases)

  • 数据合规校验 (Data Validation)：确保接入下游管线的数据 100% 符合标准 JSON 语法；
  • 第三方 API 响应规整：清洗和标准化来自外部 Webhook 或 RESTful API 的非标返回体；
  • LLM 响应文本自愈 (Data Cleaning)：专治大语言模型吐出的格式瑕疵与残缺 JSON；
  • 工作流统一数据入口：在工作流开头作为全局参数配置的录入与分发中枢。