Цель и границы задачи
Зафиксируйте вход JSON или JSONL, сравните его с базовой версией или конфигурацией среды, исследуйте сигналы качества и передайте документированный нормализованный результат.
Это руководство превращает заявленную задачу в проверяемый результат. Сохраняйте исходник, промежуточные результаты и решения, чтобы следующий участник понимал, что было проверено и почему.
Подготовьте данные и примите решения
Сохраните неизменную очищенную копию входящего JSON или JSONL и укажите его ответственного.
Предоставьте утверждённую базовую версию или именованные пакеты сред для сравнения.
Заранее определите, какие поля можно стандартизовать, а какие значения должны остаться дословными.
Решение: Главный вопрос связан с конфигурацией или качеством записей?. Используйте сравнение базовой версии и сред для отсутствующих, изменённых или неожиданных ключей; анализируйте логи и набор данных, если записи некорректны, неполны, повторяются или дрейфуют.
Решение: Можно ли выразить правило очистки детерминированно?. Используйте нормализацию по правилам, когда известны соответствия, регистр, даты и обработка null. Подключайте ИИ только для неоднородного текста или форматов и проверяйте выборочно каждое предложенное преобразование.
Выполните рабочий процесс
1. Зафиксировать и отформатировать доказательства
Отформатируйте очищенный источник без изменения значений, чтобы проверить вложенность, массивы, null и подозрительные ключи по сохранённой сырой копии. Используйте json-formatter.
2. Показать различия базовой версии и среды
Сравните отформатированный payload с утверждённой базовой версией и отделите отсутствующие ключи, изменённые значения и добавления конкретной среды, прежде чем считать их дефектами данных. Используйте pretty-json-diff, environment-config-diff-visualizer.
3. Объяснить сигналы качества на уровне записей
Преобразуйте JSONL или структурированные события в поля и профилируйте полноту, дубликаты строк, выведенные типы, дрейф формата и выбросы, чтобы отделить реальный паттерн от единичного diff. Используйте structured-log-analyzer, dataset-quality-profiler.
4. Нормализовать по подотчётной политике
Применяйте детерминированные правила, когда они заданы; используйте ассистированную нормализацию только для неоднозначных грязных полей, сравните выборку с сохранённым источником и зафиксируйте нерешённые исключения. Используйте data-normalizer, ai-data-normalizer.
Проверьте результат перед передачей
- В передаче указаны исходный вход, базовая версия для сравнения и границы проверки.
- Каждое принятое различие классифицировано как намеренное, исправленное документированным правилом или оставленное исключение.
- Нормализованный вывод сохраняет валидную структуру JSON, а выборочная проверка не показывает непреднамеренную потерю полей.
- Примечания к передаче указывают путь нормализации и записи, которые нужно проверить ответственному.
Частые вопросы
- Доказывает ли JSON diff, что изменение ошибочно? Нет. Он показывает различия структуры и значений. Ответственный за базовую версию решает, является ли каждое различие одобренной вариацией среды, нужным исправлением или исключением.
- Когда нужно анализировать логи вместо одного документа JSON? Используйте анализ структурированных логов, если доказательства представлены JSONL или повторяющимися событиями и нужно извлекать поля между записями. Один payload сначала проверяется по базовой версии.
- Когда уместна нормализация с поддержкой ИИ? Когда непоследовательный свободный текст или смешанные форматы источников нельзя безопасно описать детерминированными правилами. Сохраните оригинал, проверьте выборку и задокументируйте политику перед принятием результата.