Частые проблемы при работе с Докой и как их починить — ошибки запуска, модели, TLS, чёрный экран, системные требования.

Здесь собраны решения самых частых проблем при работе с Докой.

◆

Если твоей проблемы нет в списке — напиши на ilya.babikov@gmail.com и приложи файл логов ~/.doka/server.log (см. Как найти файл логов).

Не установлен Visual C++ Redistributable (Windows)

Симптомы: приложение открывается, модель скачивается, но на любой вопрос — «Попробуй ещё раз» или «Не удалось запустить языковую модель».

Решение:

Скачай Visual C++ Redistributable 2022
Установи его
Перезапусти Доку

Процессор не поддерживает AVX2

Симптомы: то же сообщение об ошибке. Встречается на процессорах примерно до 2013 года выпуска (Intel до Haswell, AMD до Excavator).

Как проверить: открой «Диспетчер задач» → «Производительность» → «ЦП». Если в характеристиках нет упоминания AVX2 — твой процессор не поддерживается.

Решение: пока Дока требует поддержку AVX2. Мы работаем над совместимостью со старыми процессорами.

Приложение зависает — загрузка без ответа

Симптомы: после отправки вопроса крутится индикатор загрузки, но ответа нет. Через 2 минуты появляется сообщение об ошибке.

Возможные причины и решения:

Не хватает оперативной памяти. Закрой другие приложения и попробуй снова. Если не помогает — переключись на модель меньшего размера (низкое качество).
Модель слишком большая для твоего компьютера. Переключи качество на «низкое» в настройках. Это загрузит модель на 1.7B параметров, которая требует заметно меньше ресурсов.
Первый запуск после скачивания. Первый вопрос может обрабатываться дольше обычного — модели нужно загрузиться в память. Подожди. Если через 2 минуты появилась ошибка — перезапусти приложение.

«Не хватает места в контексте модели»

Причина: диалог стал слишком длинным и превысил размер контекстного окна модели.

Решение: начни новый чат. Длинные диалоги с большим количеством сообщений расходуют контекст модели. Если задача сложная — разбей её на несколько отдельных чатов.

Ошибка TLS при скачивании модели

Симптомы: при первом запуске модель не скачивается. Сообщение об ошибке упоминает TLS, SSL или сертификаты.

Причина: антивирус перехватывает HTTPS-трафик для проверки (Kaspersky, ESET, Avast и другие).

Решение:

Открой настройки антивируса
Найди раздел «Проверка защищённых соединений» или «HTTPS-инспекция»
Отключи эту функцию или добавь huggingface.co в исключения
Нажми «Попробовать снова» в Доке

Приложение не запускается / чёрный экран

Windows

Убедись, что установлен Visual C++ Redistributable 2022
Попробуй запустить от имени администратора
Проверь, что антивирус не заблокировал файлы приложения

macOS

Mac на процессоре Intel не поддерживается. Дока работает только на Mac с процессором Apple Silicon (M1, M2, M3, M4).
Минимальная поддерживаемая версия — macOS 13 (Ventura). На macOS 12 и ниже приложение может не работать.
При первом запуске macOS может запросить разрешение — нажми «Открыть» в диалоге безопасности («Системные настройки» → «Конфиденциальность и безопасность»).

macOS: «файл повреждён»

Симптомы: при открытии macOS пишет, что приложение повреждено и его нельзя открыть.

Причина: это защита macOS от неподписанных приложений — Дока безопасна.

Решение:

Открой Терминал (Spotlight → «Terminal»).
Вставь команду и нажми Enter:
```
xattr -cr /Applications/Doka.app
```
Открой Доку как обычно.

Вчера работало, сегодня — нет

Симптомы: Дока работала нормально, но при следующем запуске на любой вопрос — ошибка.

Решения (по порядку):

Перезапусти приложение — полностью закрой Доку и открой заново.
Проверь свободное место на диске — модели занимают от 1 до 5 ГБ. Если диск заполнился, модель может не загрузиться.
Переключи качество модели — выбери другой уровень качества, затем вернись на прежний. Это заново инициализирует модель.
Сбрось модель — удали папку с моделями и перезапусти приложение:
- Windows: удали C:\Users\<твой_пользователь>\.doka\models\
- macOS: удали ~/.doka/models/
Дока автоматически скачает модель заново при запуске.
Сбрось браузер — если не работают задачи с поиском или открытием сайтов, удали кеш Chromium:
- Windows: удали %LOCALAPPDATA%\ms-playwright\
- macOS: удали ~/Library/Caches/ms-playwright/
Дока скачает браузер заново при следующем запуске.

Как найти файл логов

Файл логов содержит техническую информацию об ошибках и помогает нам разобраться в проблеме.

Windows: C:\Users\<твой_пользователь>\.doka\server.log
macOS: ~/.doka/server.log

Если пишешь в поддержку — приложи этот файл к письму.

Минимальные системные требования

	Windows	macOS
ОС	Windows 10+	macOS 13 (Ventura)+
Процессор	x64 с поддержкой AVX2 (Intel Haswell+ / AMD Excavator+)	Apple Silicon (M1–M4). Intel Mac не поддерживается
ОЗУ	8 ГБ (минимум), 16 ГБ (рекомендуется)	8 ГБ (минимум), 16 ГБ (рекомендуется)
Диск	6 ГБ свободного места	6 ГБ свободного места
Интернет	Нужен при первом запуске (модель ~5 ГБ + браузер ~160 МБ)	То же
Дополнительно	Visual C++ Redistributable 2022	—

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