Схема JSONL для тестирования Qwen и её назначение

Дата создания: 28 июня 2026 г.

Цель

Создавать фрагменты кода Godot с помощью Qwen, к каждому фрагменту прикреплять правильный JSONL и неправильный JSONL, а затем при проверке «да»/«нет» использовать указанный формат JSONL и описать назначение каждого JSONL.

Этот документ не является руководством по предоставлению образцовых данных. Он служит справочным материалом о том, какие JSONL‑файлы выполняют какие роли при тестировании и какие поля используются для оценки прямых доказательств.

Общие правила

JSONL записывается построчно: в каждой строке один JSON‑объект.

{...}
{...}
{...}

В тесте обёртка, охватывающая имя таблицы, не используется, а поле, соответствующее колонке целевой таблицы, размещается на верхнем уровне.

Хорошо:
{"chunk_id":"...","content":"...","code_blocks":[...]}

Избегать:
{"table":"docs_chunks","payload":{"chunk_id":"..."}}

Поля, которые автоматически создаются в базе данных или используются в поисковом индексе, не нужно заполнять вручную в тестовом JSONL.

В проверке прямых доказательств Qwen важно то, что «какое поле в JSONL непосредственно соответствует реальной строке/API/шаблону в SOURCE_CODE».

docs_chunks

Назначение

docs_chunks — это JSONL, в котором содержимое официальной документации, учебных материалов и текста справочника классов сохраняется по кускам (chunks).

Используется для запросов объяснения кода, проверки общего использования API, проверки описания общих синтаксических конструкций Godot 3/4. Это служит основанием для проверки того, связан ли данный код напрямую с конкретным описанием в официальной документации, а не просто с правилами миграции.

Формат JSONL

{
  "chunk_id": "text, required",
  "doc_version": "text, required",
  "source_url": "text, required",
  "source_file": "text, required",
  "source_sha256": "text, required",
  "doc_type": "text, required",
  "symbol": "text or null",
  "section_path": "array, required",
  "heading": "text or null",
  "content": "text, required",
  "code_blocks": "array, required",
  "language_tags": "array<string>",
  "godot_version_tags": "array<string>",
  "api_symbols": "array<string>",
  "token_count": "integer or null",
  "metadata": "object"
}

Прямые доказательства по полям

Роль в тестах

api_mapping

Назначение

api_mapping — это JSONL, в котором хранится информация о том, как изменились имена, названия классов, функции и символы при переходе от Godot 3 к Godot 4.

Используется для определения простых переименований, замен, устаревших/удалённых API. Примеры, где полностью меняется способ использования функции, относятся к разделу label_prototypes.

Формат JSONL

{
  "mapping_id": "text, required",
  "source_api": "text, required",
  "target_api": "text or null",
  "change_type": "text, required",
  "godot_from": "text, required",
  "godot_to": "text, required",
  "confidence": "text, required",
  "evidence_chunk_ids": "array<string>",
  "match_terms": "array<string>",
  "notes": "text",
  "negative_patterns": "array<string>"
}

Прямое доказательство по полям

Роль в тестах

label_prototypes

Назначение

label_prototypes — это JSONL, в котором сохраняются примеры, когда меняется не просто имя, а полностью меняется способ использования функции, состав аргументов и паттерн вызова.

Если api_mapping отвечает на вопрос «какое имя изменилось на какое», то label_prototypes отвечает на вопрос «каким паттерном следует писать код».

Формат JSONL

{
  "prototype_id": "text, required",
  "label": "text, required",
  "task_type": "text, required",
  "input_pattern": "text, required",
  "expected_finding": "text, required",
  "recommended_action": "text, required",
  "evidence_mapping_ids": "array<string>",
  "evidence_chunk_ids": "array<string>",
  "severity": "text",
  "validator_rules": "object"
}

validator_rules может иметь следующие подполя.

{
  "required_when_seen_in_code": "array<string>",
  "before_code": "text",
  "after_code": "text",
  "reject_when_seen_in_code": "array<string>"
}

Прямые доказательства по полям

Роль в тестах

Границы трёх JSONL

Обработка общих синтаксисов

Если синтаксис одинаков в Godot 3 и Godot 4, различия версий не учитываются.