> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# JSON 数据匹配与更新工具

[JSON 数据匹配工具](https://tools.newzone.top/zh/json-match-update) 通过 ID 字段把来源数据集的值同步到目标数据集对应字段中——常用于把外部更新的计数、评分等单条属性批量回填到主数据集。

![JSON 数据匹配与更新工具界面](/img/json-match-update-zh.webp "JSON 数据匹配与更新工具使用界面")

## 使用步骤

1. **准备数据**：
   - **原始数据**：包含需要更新的完整 JSON 数据集
   - **目标数据**：包含计数值的 JSON 数据集

2. **输入数据**：
   - 在左侧文本框中粘贴或上传原始 JSON 数据
   - 在右侧文本框中粘贴目标 JSON 数据（含计数值）
   - 支持拖拽上传`.txt`或`.json`文件

3. **配置匹配字段**：
   - **匹配字段 · 源**（`源数据匹配字段`）：原始数据中的唯一标识字段（默认 `id`）
   - **匹配字段 · 目标**（`目标数据匹配字段`）：目标数据中的对应 ID 字段（默认 `card_id`）
   - **更新字段 · 源**（`源数据更新字段`）：原始数据中需要被更新的字段（默认 `weight`）
   - **更新字段 · 目标**（`目标数据更新字段`）：目标数据中包含新值的字段（默认 `count`）

4. **处理数据**：
   - 点击"开始处理"按钮执行数据匹配与更新

5. **处理结果**：
   - 更新后的数据会显示在下方结果区域
   - 可以复制完整结果、仅复制 JSON 节点内容或下载更新后的文件

## 特殊规则

- 若原始数据中某条目的中文标题 (`zh.title`) 包含"失效"字样，该条目的权重会被自动设为 0
- 若目标数据中找不到原始数据某 ID 的对应项，该条目保持不变

## 额外功能

- **大文件友好**：处理较大数据集时改用文件上传，不要粘贴进文本框
- **重置上传**：清除已上传的文件和文本框内容

## 数据格式示例

原始数据格式：

```json
[
  {
    "id": 12345,
    "weight": 10,
    "zh": {
      "title": "示例标题"
    }
    // 其他字段...
  }
]
```

目标数据格式：

```json
[
  {
    "card_id": 12345,
    "count": 25
  }
]
```

结果数据：

```json
[
  {
    "id": 12345,
    "weight": 25, // 从 count 值更新
    "zh": {
      "title": "示例标题"
    }
    // 其他字段保持不变...
  }
]
```