JSON 变换器与 AI Transform 工具

如何用脚本和 AI Transform 重组 JSON

1. 01

   教程步骤

   步骤 1 – 导入一份可解析的原始 JSON

   开始变换前，先确保输入的是一份能正常解析的 JSON。Transformer 不是修复器，它更适合在“数据合法但结构不理想”的阶段接手。

   • 把原始 JSON 直接粘贴到左侧输入区，适合处理接口响应、配置对象、数据导出或日志载荷。
   • 如果数据已经保存在文件里，可以用导入功能加载本地 JSON，而不用先手工复制粘贴。
   • 面对较大的数组或深层对象时，建议先明确你最终想得到的输出结构，再开始写或选择脚本。
   • 如果一粘贴就发现语法错误，先转去 validator 或 repair，把 JSON 修到可解析状态后再回来。
   • 把 Transformer 放在 formatter 后面也很常见，因为先格式化 JSON，通常更容易看清要改哪些字段。
2. 02

   教程步骤

   步骤 2 – 选择配方模板，或让 AI Transform 起草脚本

   这一步决定你是用现成配方快速起步，还是让 AI 先帮你搭出脚手架。对于重复性结构调整，模板通常够快；对于业务规则更复杂的变换，AI 草稿会更省时间。

   • 先浏览内置 Recipes，常见的过滤、映射、保留字段、扁平化、去重、改键名等操作都可以直接套用。
   • 如果你知道目标结构但不想从零写脚本，可以打开 AI Transform，用自然语言描述需求，让它先生成一个草稿。
   • 描述需求时尽量写清楚保留哪些字段、删除哪些字段、是否要分组、排序或补默认值，AI 草稿会更接近目标。
   • 拿到 AI 草稿后不要直接应用，先把它当成“第一版脚本”，再根据你的字段名和业务规则做小幅调整。
   • 无论是模板还是 AI 草稿，都建议保留输入 JSON 的一个原始副本，方便随时比对变换前后的差异。
3. 03

   教程步骤

   步骤 3 – 在预览区验证输出形态，而不是盲目覆盖原文

   Transformer 最关键的不是“能改”，而是“改之前能先预览”。这能显著降低一次脚本误写就把整份 JSON 改坏的风险。

   • 运行 Preview 后，右侧会显示变换结果，你可以先确认数组长度、字段名、值类型和嵌套层级是否符合预期。
   • 如果脚本返回了 undefined、不可序列化对象或运行时报错，页面会直接提示错误，方便你回到脚本区调整。
   • 对于批量映射或过滤，先抽查几条代表性记录，确认没有把重要字段删掉或改成错误类型。
   • 如果你在做扁平化、分组或重命名，建议重点检查输出里的键名是否统一、层级是否真的变浅、数组是否被意外打散。
   • AI Transform 生成的脚本尤其要看 preview，因为它更像是一个高质量起点，而不是不经检查就能上线的最终答案。
4. 04

   教程步骤

   步骤 4 – 应用结果并继续后续 JSON 工作流

   当预览结果确认无误后，再把输出应用回输入，或直接复制、下载，并继续流转到其他工具。这样整条数据处理链会更稳。

   • 点击 Apply 后，可把当前预览结果回写成新的输入，方便继续叠加下一轮变换脚本。
   • 如果结果已经符合目标，可以直接复制或下载导出的 JSON，用于接口测试、数据交付或留档。
   • 如果你接下来要人工抽查或逐项修改字段，继续进入 JSON Table Editor 会更直观。
   • 如果你想把变换后的结果变得更好读、更适合分享，可以再交给 Formatter 做美化、排序或压缩。
   • 当输出结构已经稳定后，再去生成 Schema、类型定义或做版本比较，通常会得到更干净、更可复用的结果。

把 JSON Transformer 放在格式化和可视化编辑之间，通常最能发挥价值：它既比手工改 JSON 更高效，也比一次性写完整数据处理程序更轻量。