Skip to content

Latest commit

 

History

History
130 lines (78 loc) · 7.58 KB

File metadata and controls

130 lines (78 loc) · 7.58 KB

JsonLines Editor - Руководство пользователя

Версия 0.1.2

Краткое руководство

Базовый рабочий процесс

  1. Открыть файл: Файл > Открыть (Ctrl+O) или попробуйте example.jsonl
  2. Выбрать строку в таблице для редактирования
  3. Изменить поля в панели редактора справа
  4. Нажать "Сохранить элемент" для применения изменений к таблице
  5. Сохранить файл: Файл > Сохранить (Ctrl+S)

Добавление новых записей

  1. Нажмите кнопку "Добавить строку" или оставьте строку невыбранной
  2. Заполните все пять полей в панели редактора
  3. Нажмите "Сохранить элемент"
  4. Сохраните файл через Ctrl+S

Формат файла

Каждая строка - это JSON объект с пятью обязательными полями:

{"term":"Локальный термин","original_term":"Оригинальный термин","definition":"Локальное определение","original_definition":"Оригинальное определение","source":"Источник"}

Введение

JsonLines Editor - это инструмент для редактирования JSONL файлов, содержащих многоязычные определения терминов, предназначен для подготовки обучающих датасетов для языковых моделей. Формат JSON Lines хранит по одному JSON объекту на строку, что делает его эффективным для построчной обработки в процессах машинного обучения.

Интерфейс пользователя

Основные компоненты

Табличное представление (центр): Отображает все записи в колонках: Термин, Оригинальный термин, Определение, Оригинальное определение и Источник.

Панель редактора (справа): Поля ввода для редактирования отдельных записей. Изменения активируют кнопку "Сохранить элемент".

Панель инструментов:

  • Добавить строку - Вставить новую пустую строку
  • Удалить строку - Удалить выбранную строку
  • Сохранить элемент - Применить изменения редактора к таблице
  • Кнопки поиска - Открыть поиск Google для терминов

Меню: Файл (Создать/Открыть/Сохранить/Закрыть), Правка (Очистить кэш), Справка (О программе)

Вкладка журнала: Журнал операций текущей сессии

Работа с файлами

Открытие файлов

Файл > Открыть (Ctrl+O) - Выбрать JSONL файл. Приложение проверяет структуру JSON и показывает ошибки с номерами строк, если они найдены.

Сохранение файлов

Файл > Сохранить (Ctrl+S) - Сохраняет в текущий файл с автоматическим созданием резервной копии.

Файл > Сохранить как - Сохранить с новым именем.

Создание новых файлов

Файл > Создать (Ctrl+N) - Создает пустой файл, помеченный как "несохраненный". Добавьте записи, затем используйте "Сохранить как".

Ошибки файлов

  • Недопустимый JSON: Проверьте номер строки в сообщении об ошибке
  • Не объект: Каждая строка должна быть JSON объектом, а не массивом/строкой
  • Невозможно сохранить: Проверьте права доступа к файлу и место на диске

Редактирование записей

Редактирование существующей записи

  1. Нажмите на строку таблицы для загрузки данных в редактор
  2. Измените поля (все пять обязательны)
  3. Нажмите "Сохранить элемент" когда кнопка активируется
  4. Файл > Сохранить для записи на диск

Удаление записи

Выберите строку, нажмите "Удалить строку", затем сохраните файл.

Требования

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

Дополнительные функции

Интеграция поиска

Нажмите значки поиска рядом с полями Термин или Оригинальный термин для открытия поиска Google с языковыми фильтрами (русский/английский).

Автоматические резервные копии

Перед каждым сохранением приложение создает резервную копию с меткой времени в: ~/.config/CenSync/JsonLinesEditor/backups/

Ежедневные журналы

Операции записываются в: ~/.config/CenSync/JsonLinesEditor/logs/YYYY-MM-DD.log

Просмотр журнала текущей сессии во вкладке "Журнал".

Решение проблем

Невозможно открыть файл: Проверьте кодировку UTF-8 и корректный формат JSONL (один JSON объект на строку).

Изменения не сохранены: Нажмите "Сохранить элемент" после редактирования, затем Файл > Сохранить.

Приложение не запускается: Убедитесь что установлены библиотеки Qt 6. Попробуйте очистить кэш: Правка > Очистить кэш.

Восстановление данных: Проверьте папку backups на наличие .bak файлов, переименуйте в .jsonl для восстановления.

Горячие клавиши

  • Ctrl+N - Создать новый файл
  • Ctrl+O - Открыть файл
  • Ctrl+S - Сохранить файл
  • Ctrl+Q - Выход

Лучшие практики

  1. Сохраняйте часто (Ctrl+S)
  2. Используйте описательные имена файлов (например, medical_terms_ru_en.jsonl)
  3. Периодически проверяйте создание резервных копий
  4. Храните файлы в системе контроля версий (Git)
  5. Поддерживайте последовательный формат ссылок на источники