#JSON 键值映射工具

#功能概述

JSON 键值映射工具 用于在 JSON 数据结构间执行值映射和转换操作。该工具允许用户定义键映射关系，将源 JSON 中特定路径的值复制到目标路径，同时保持 JSON 结构的完整性。

#主要应用场景

• 多语言内容转换：将源语言内容复制到多个目标语言字段
• 数据结构重组：在复杂 JSON 结构间迁移数据
• 大规模 JSON 数据处理：支持处理大型 JSON 文件
• JSON 路径映射：使用 JSONPath 语法进行精确数据定位

#使用指南

#基本操作流程

1. 选择映射模式

   • 在配置卡片顶部的分段控件上选择"自定义映射"或"预设映射 · AIShort"
   • 预设映射针对 AIShort 多语言处理进行了优化，选中后会直接列出所有 11 个目标键名

2. 设置键映射关系

   • 自定义映射模式：添加输入键和输出键对
   • 预设映射模式：自动加载默认的多语言映射配置（en.prompt 到多种语言）

3. 提供源 JSON 数据

   • 在文本区域粘贴 JSON 内容
   • 或通过拖放区域上传 .json 或 .txt 文件

4. 执行转换

   • 点击"开始处理"按钮启动转换过程
   • 系统会验证输入和输出键是否存在于 JSON 中

5. 处理结果

   • 转换后的 JSON 将显示在结果区域
   • 可以复制完整结果、复制特定节点或下载结果文件

#高级功能

• 大文件友好：超大 JSON 走文件上传处理
• 文件上传：支持拖放或选择文件上传
• 结果管理：
  • 复制完整 JSON 结果
  • 复制特定 JSON 节点
  • 下载处理后的 JSON 文件

#键映射详解

#映射语法

工具使用 JSONPath 语法定位 JSON 中的元素：

• 使用点符号表示路径，如 en.prompt
• 系统将查找指定路径的值，并将其复制到目标路径

#预设映射配置

预设模式自动配置以下映射关系：

• en.prompt → ar.prompt (阿拉伯语)
• en.prompt → bn.prompt (孟加拉语)
• en.prompt → de.prompt (德语)
• en.prompt → es.prompt (西班牙语)
• en.prompt → fr.prompt (法语)
• en.prompt → hi.prompt (印地语)
• en.prompt → it.prompt (意大利语)
• en.prompt → ja.prompt (日语)
• en.prompt → ko.prompt (韩语)
• en.prompt → pt.prompt (葡萄牙语)
• en.prompt → ru.prompt (俄语)

#注意事项

1. JSON 格式验证

   • 输入必须是有效的 JSON 格式
   • 转换前会进行预处理和验证

2. 键路径验证

   • 确保输入和输出键都存在于 JSON 中
   • 系统会检查并提示无效键路径

3. 错误处理机制

   • 输入为空时会显示错误提示
   • JSON 格式无效时会提示错误
   • 键不存在时会显示具体错误信息

4. 性能考虑

   • 处理大型 JSON 时建议用文件上传代替粘贴
   • 复杂的嵌套结构可能需要更长处理时间

使用此工具可显著提高 JSON 数据结构间值转换的效率，特别适合多语言内容处理和复杂 JSON 重构场景。