# Руководство пользователя — Дельфин

Источник: https://dolphin.polygraph.moscow/docs/

Дельфин — программа для компьютерных полиграфов КРИС и РИФ. Работает на macOS, Windows и Linux. Версия документации — 0.0.3.

## Начало работы

Программа передаётся и устанавливается через менеджера — он же поможет подключить прибор, микрофоны и перенести ваши шаблоны тестов. Телефон: +7 499 398-54-76.

Для распознавания речи нужен файл модели Whisper (около 575 МБ). Его ставит специалист при установке; программа сама находит модель в папке `models` домашнего каталога (`~/models` на macOS и Linux, `%USERPROFILE%\models` на Windows). Распознавание идёт на компьютере, интернет не нужен.

## Подключение прибора

1. Подключите КРИС или РИФ к компьютеру по USB. На macOS и Linux отдельный драйвер не нужен; на Windows, если система не установит его сама, драйвер поставит специалист при установке.
2. Слева вверху выберите порт прибора (отмечен ★). Если прибор вставили после запуска, список обновится сам через несколько секунд или по кнопке «⟳ Порты».
3. Нажмите «Подключить». Программа опознаёт прибор; если порт неизвестен — «Найти прибор» проверит все порты.
4. Выберите частоту (по умолчанию 50 Гц) и нажмите «▶ Старт» — графики пойдут сразу.

## Лампы состояния

Строка ламп над графиком показывает, готово ли всё к тесту. Наведите на лампу — подсказка объяснит цвет.

| Лампа | Зелёная | Жёлтая | Красная / серая |
|---|---|---|---|
| Прибор | идёт поток | подключён, поток не запущен | не подключён |
| Запись | сигналы пишутся в файл (мигает) | — | серая: запись не идёт |
| Микрофоны | выбраны и подключены; мигает — идёт захват | у обоих один канал | не выбраны или отключены |
| Модель | загружена | загружается | нет файла модели |
| Распознавание | всё распознано | идёт, в очереди N | ошибка; серая — тест не идёт |

## Каналы и графики

Справа — панель каналов (скрывается кнопкой «☰ Каналы» или ⌘ B). Для каждого канала:

- **вкл** — канал включён в приборе (поток перезапустится); **вид** — показывать на графике;
- **Усиление** 0…7 — каждый шаг вдвое; **Смещение** 0…255 — больше значение, ниже линия; кнопка **A** — авто-смещение канала. Оба параметра меняются в приборе сразу;
- **Масштаб** и **Позиция** — только отображение на экране;
- **Инверсия**, **ФНЧ** (убирает медленный дрейф линии), цвет и толщина линии.

На графике подпись канала можно тащить мышью вверх-вниз, колесо мыши над каналом меняет масштаб. Окно — от 5 до 120 секунд, «Заморозить» останавливает картинку, запись при этом продолжается. Порядок каналов в панели — по номеру, включённые сверху или видимые сверху.

## Авто-смещение и авто-усиление

**Авто-смещение** ставит линии каналов к их подписям (среднее значение около нуля), примерно за 4 секунды. **Авто-усиление** подбирает усиление по размаху сигнала за 4 секунды и затем делает авто-смещение — запускайте его после того, как надели датчики.

> **Важно.** Экранный «Масштаб» не исправит сигнал, упёршийся в предел прибора: если линия плоская сверху или снизу — нужно смещение или усиление. На канале без датчика авто-усиление поднимет шум — такие каналы лучше выключить.

## Запись сигналов

Кнопка «● Записать» пишет сигналы в `Документы/Дельфин/запись_дата_время.csv`. Файл открывается в Excel: разделитель «;», первый столбец — время в миллисекундах, далее каналы. Рядом — `.json` с настройками каналов и всеми их изменениями по ходу записи.

## Проведение теста

1. «Тест…» — откройте шаблон «Шериф 7-М» (`.inq`) или список вопросов (`.qst`); если в файле несколько тестов, выберите нужный.
2. «▶ Начать тест» — программа сама запустит поток и запись. Первым идёт «Фон».
3. Пробел — следующий вопрос: жмите прямо перед тем, как зачитать вопрос — это точка отсчёта реакции.
4. Д / Н — отметка «да» / «нет» вручную (на любой раскладке); ручная отметка главнее автоматической.
5. «■ Закончить тест» после последнего вопроса. «Стоп» во время теста тоже аккуратно закончит тест.

Каждый вопрос отмечается на графике вертикальной линией с меткой (З₁, К₂, Н₃…) и ответом. Цвета как в Шерифе: значимые — красные, контрольные — синие.

## Микрофоны

Голос полиграфолога и тестируемого пишется раздельно, двумя микрофонами. Рекомендуем **DJI Mic Mini**:

1. Оба передатчика (TX1, TX2) связаны с приёмником; приёмник — в компьютер по USB-C.
2. Приёмник в режиме «стерео»: TX1 — левый канал, TX2 — правый.
3. В программе «🎙 Микрофоны»: полиграфолог — DJI, канал 1 (TX1); тестируемый — DJI, канал 2 (TX2).
4. «Проверить микрофоны»: пусть каждый скажет пару слов — должен двигаться только его индикатор (П или Т).

> Не подключайте передатчики к компьютеру по Bluetooth напрямую — так получается один канал в «телефонном» качестве.

Без микрофонов — галочка «Тест без звука»: пишутся сигналы и протокол, отметки ставятся вручную.

## Распознавание и протокол

Когда вы переходите к следующему вопросу, запись закрытого вопроса распознаётся (около 2 секунд). В протоколе под графиком появляется, что спросил полиграфолог и что ответил тестируемый; «да» / «нет» ставится по ответу. «Не знаю», «не помню» отметкой не считаются. Тишина в распознавание не отправляется, перетекание голоса между микрофонами подавляется.

Протокол сохраняется сам после каждого результата — в `protocol.txt` и `protocol.json`.

## Эмулятор

Для обучения и отработки без прибора выберите в списке портов «Эмулятор КРИС». Появится панель эмулятора:

- **Испытуемый**: «Лжёт на значимых», «Правдивый», «Спокойный», «Случайные реакции»;
- **Ключевой вопрос** — самая сильная реакция на выбранном вопросе (для поисковых тестов);
- **Реакции** и **Шум** — сила реакций и уровень помех;
- кнопки **Реакция, Кашель, Движение, Глубокий вдох** — событие прямо сейчас.

Во время теста виртуальный испытуемый реагирует на каждый вопрос через 2–3,5 секунды.

## Файлы и папки

Каждая проверка — отдельная папка в `Документы/Дельфин`, например `2026-10-25_22-34_ПОВАР 6`:

| Файл | Что внутри |
|---|---|
| `signals.csv`, `signals.json` | сигналы всех каналов и их настройки |
| `examiner.wav`, `subject.wav` | голос полиграфолога и тестируемого, 16 кГц |
| `protocol.txt`, `protocol.json` | вопросы, время, распознанная речь, отметки |

> Голос тестируемого — персональные данные: согласие на проверку должно включать аудиозапись.

## Частые вопросы

### Прибор не находится

Проверьте кабель, нажмите «⟳ Порты» и выберите порт со ★, затем «Подключить». Не помогло — «Найти прибор».

### Лампа «Микрофоны» красная

Микрофоны не выбраны или приёмник отключён. Откройте «🎙 Микрофоны» и выберите источники заново.

### Оба индикатора П и Т двигаются одинаково

Приёмник DJI в режиме «моно» — переключите в «стерео».

### Нужна поддержка другого полиграфа

Мы адаптируем программу под ваш аппарат — свяжитесь с менеджером: +7 499 398-54-76.