📖 Руководство — Дополнение «Транскрибатор метрических книг»

Дополнение помогает расшифровывать изображения метрических книг (акты рождения, брака, смерти) с помощью Google™ AI (Gemini™). Вы можете импортировать снимки из Google Drive™ (файлы, которые явно выбираете), добавить блок Context, затем расшифровать выбранные изображения; текст вставляется сразу под соответствующим изображением.

📊 Схема работы

Создание документа и импорт

flowchart LR
  A[📄 Новый Doc] --> B[📁 Импорт из Drive]
  B --> C[✅ Проверка Context и изображений]

Расшифровка (боковая панель — рекомендуется)

flowchart LR
  D[📁 Импорт из Drive] --> E[🔑 Настройка ИИ]
  E --> F[🧾 Извлечь контекст]
  F --> G[☑️ Выбрать изображения]
  G --> H[✍️ Расшифровать выбранные]
  H --> I[✅ Проверка результата]

🔄 Краткий сценарий

1. Подготовьте документ — Import Book from Drive Files (рекомендуется) или вручную добавьте Context и изображения.
2. Шаблон — если источник не греко-католические метрические книги Галиции, откройте Select Template и выберите профиль (например, Российская православная метрическая книга).
3. Расшифровка — боковая панель для пакета или одно изображение через меню Transcribe Image.
4. Настройки — Extensions → GeneaScript → Setup AI или кнопка на панели.
5. Контекст с обложки — Extract Context from Cover Image (меню) или Обложка → Контекст (боковая панель, ровно одно встроенное изображение).

Язык интерфейса

Доступны английский, украинский, русский. По умолчанию — язык аккаунта Google. Переопределение: Setup AI или Settings → Interface language (Auto, English, Українська, Русский). Заголовок Context в документе не переводится — так работает автоопределение контекста.

Меню Extensions → GeneaScript: Open Sidebar, Transcribe Image, Import Book from Drive Files, Extract Context from Cover Image, Select Template, Setup AI, Help / User Guide, Report an issue.

📁 Импорт из Google Drive (рекомендуется)

1. Откройте Google Doc.
2. Extensions → GeneaScript → Import Book from Drive Files.
3. Google Picker открывается в родительской папке документа (если документ в Drive).
4. Вкладки Images / Folders, поиск, до 50 изображений (JPEG, PNG, WebP; или до 500 в режиме «Только ссылки»), Select.
5. Добавляется раздел Context (шаблон с жирными метками — отредактируйте), для каждого файла: Heading 2, Source Image Link, изображение, разрыв страницы.
   • Если изображение не удаётся встроить (формат отклонён Google Docs), оно автоматически добавляется как запись-ссылка — заголовок и ссылка на Drive сохраняются, но встроенного изображения нет. Такие записи можно транскрибировать как обычные.
6. 🔗 Режим «Только ссылки» (необязательно): поставьте галочку 🔗 рядом с кнопкой «Импорт», чтобы импортировать все файлы как записи-ссылки (без встроенных изображений). Быстрый импорт, меньший документ, поддержка до 500 файлов за раз — идеально для больших книг (300+ сканов). Настройка сохраняется для каждого документа.

После импорта — сводка (сколько добавлено встроенных / ссылок / пропущено). Доступ только к выбранным файлам (drive.file).

📄 Структура документа (вручную)

1. Context — под заголовком укажите архив, описание, даты, деревни, фамилии. Весь текст под «Context» уходит в модель.
2. Изображения — вставьте сканы под Context.

📂 Боковая панель (пакет)

1. Open Sidebar или значок дополнения.
2. Порядок: Импорт из Drive Files (с необязательным переключателем 🔗), Setup AI, Обложка → Контекст, список изображений, Transcribe Selected. Наведите курсор на любую кнопку, чтобы увидеть подсказку.
3. Зелёная галочка — расшифровка уже есть; выберите одно или несколько. Записи-ссылки отображаются полупрозрачными с иконкой 🔗.
4. Stop останавливает пакет после текущего изображения.
5. Ошибки — красный крест (наведите для текста); предупреждение — возможна обрезка MAX_TOKENS.

🧾 Контекст с титульного листа

После импорта: меню Extract Context from Cover Image или кнопка Обложка → Контекст на боковой панели с одним выбранным встроенным изображением → Extract → проверка полей → Apply Context. Записи-ссылки не поддерживаются для извлечения контекста.

📋 Галерея шаблонов

Select Template (меню или кнопка на панели). Профили, в том числе Galician Greek Catholic и Russian Imperial Orthodox. Review Template — вкладки Context (живой текст из документа), Role, Columns, Output, Instructions. Шаблон хранится на документ. Новые расшифровки используют выбранный шаблон.

Пользовательские шаблоны (v1.4+)

Вы можете создавать персональные шаблоны транскрибирования на основе официальных или с нуля. Каждый шаблон содержит секции: Роль, Входная структура, Формат вывода, Инструкции и Контекст по умолчанию.

Создание:

1. Откройте Галерею шаблонов → прокрутите до Мои шаблоны.
2. Создать из шаблона — клонирует официальный шаблон. Создать пустой — пустой шаблон со стартовыми заготовками.
3. В редакторе заполните Название, Описание и настройте секции через вкладки.
4. Для шаблонов на основе родительского есть кнопка Сбросить для возврата к оригиналу.
5. Сохранить → шаблон появится в галерее.

Управление: кнопки Редактировать, Дублировать, Экспортировать в документ, Удалить на карточке шаблона. Экспорт делает шаблон доступным коллегам в этом документе (метка «Shared»). До 5 шаблонов на аккаунт.

✍️ Одно изображение (меню)

1. Щёлкните по изображению (рамка выделения).
2. Transcribe Image.
3. Первый запуск — диалог ключа API и модели (Google AI Studio), Save & Continue.
4. Дождитесь окончания; текст появится под изображением.
5. Проверьте Quality Metrics (синие) и Assessment (красные).

Setup AI — смена ключа, модели, строгости, длины вывода, режима рассуждения. Внизу диалога есть чекбокс Показывать статистику в боковой панели для включения панели статистики (см. ниже).

📊 Статистика использования (v1.6.1+)

Боковая панель может отображать сворачиваемую секцию Статистика, которая показывает потребление токенов и ориентировочную стоимость ваших транскрипций. Полезно для контроля расходов на API и понимания влияния шаблона и размера изображения на стоимость.

Включение

Статистика выключена по умолчанию. Чтобы включить:

1. Откройте Setup AI (кнопка на панели или меню).
2. Поставьте галочку Показывать статистику в боковой панели.
3. Нажмите Сохранить. Панель появится через несколько секунд.

Что показывает панель

Панель содержит две секции: Всего по документу (накопление за все пакеты) и Последний запуск (только последний пакет).

Ссылки в подвале

• Тарифы — открывает страницу цен Gemini API
• Мои расходы — открывает дашборд расходов AI Studio
• Сбросить — обнуляет всю статистику документа (с подтверждением)

Как работает статистика

• Статистика накапливается между пакетами в одном документе.
• Данные сохраняются для каждого документа (привязаны к вашему аккаунту и ID документа). Перезагрузка панели или повторное открытие документа восстанавливает статистику.
• Секция Последний запуск появляется после первого пакета.
• Сбросить очищает все данные (общие и последний запуск).
• Неудачные изображения не учитываются — только успешные транскрипции.

📝 Формат результата

Заголовок страницы, записи абзацами (адрес, имена, заметки), метрики качества, оценка, затем языковые резюме (русский, украинский, латиница, английский) списком.

💡 Советы

• Чем точнее Context, тем лучше нормализация имён.
• Чёткие сканы и обрезка лишнего улучшают результат.
• Для нескольких страниц удобнее боковая панель.

🔧 Устранение неполадок

Установка и ключ: INSTALLATION.html.