Почти все обращения сводятся к пяти сюжетам: система ругается на установщик, приложение не видит старых данных, нужны логи, нужно перенести или сбросить базу, не поднимается MCP-сервер. Ниже — что делать в каждом случае и что приложить, если проблема осталась.
Windows: предупреждение SmartScreen#
Установщик для Windows пока не подписан. SmartScreen показывает синее окно «Система Windows защитила ваш компьютер»: нажмите Подробнее, затем Выполнить в любом случае. Компонент WebView2, если его нет в системе, установщик поставит сам. Берите файл только по ссылкам с сайта — откуда именно, написано на странице Установка.
macOS: Gatekeeper и карантин#
Сборка для macOS подписана Developer ID и нотаризована Apple, поэтому обычный сценарий — открыть DMG, перетащить Tetiva в «Программы» и запустить без единого предупреждения.
Если система всё же говорит, что приложение повреждено или его нельзя проверить, дело почти всегда в файле, а не в подписи: недокачанный DMG, распаковка сторонним архиватором, корпоративный прокси, подменивший содержимое. Скачайте файл заново. Снимать атрибут карантина вручную (xattr -d com.apple.quarantine /Applications/Tetiva.app) стоит только если вы уверены в источнике файла — это отключает проверку, а не чинит её.
Как получить логи#
Tetiva пишет логи в стандартный вывод в формате JSON, файла логов нет. Значит, приложение нужно запустить из терминала и смотреть вывод там.
macOS:
/Applications/Tetiva.app/Contents/MacOS/clientWindows, PowerShell:
& "C:\Program Files\Saveliy Ludin\Tetiva\client.exe"Воспроизведите проблему при запущенном терминале и сохраните вывод — именно он больше всего помогает разобраться.
Приложение не видит прежних данных#
При первом запуске после переименования приложения каталог ~/.gophercourier переименовывается в ~/.tetiva. Есть один случай, когда этого не происходит: если ~/.tetiva уже создан. Тогда приложение работает с новым, пустым каталогом, а старый остаётся нетронутым рядом. Закройте Tetiva, переименуйте пустой ~/.tetiva, верните на его место старый каталог и запустите приложение снова.
Перенос и сброс данных#
Всё локальное лежит в одном каталоге: ~/.tetiva на macOS, %USERPROFILE%\.tetiva на Windows. Внутри — data.db и файлы WAL рядом с ним.
- Перенести на другую машину. Закройте приложение (иначе WAL не будет дописан в базу) и скопируйте каталог целиком.
- Сбросить до чистого состояния. Закройте приложение и удалите каталог. Локальные коллекции, история и куки пропадут навсегда; воркспейсы, которые были в Tetiva Cloud, вернутся после следующего входа в аккаунт.
- Хранить базу в другом месте. Задайте
TETIVA_DATA_DIRперед запуском. Учтите: приложение, запущенное двойным кликом из Finder или меню «Пуск», переменных из профиля оболочки не видит — запускайте из терминала теми же командами, что выше.
Тема, размер шрифта и перенос строк в этом каталоге не хранятся и при переносе не поедут — их придётся выставить заново, см. Настройки.
MCP-сервер не поднимается#
Если в настройках стоит Enable, а статус остался ○ Stopped, чаще всего порт занят другой программой или вторым экземпляром Tetiva. В логе при старте будет строка MCP port unavailable — приложение продолжает работать, отключается только MCP. Смените порт в настройках и перезапустите приложение. Подробности — на странице MCP-сервер.
Синхронизация не включается#
Жёлтая иконка облака с точкой означает, что почта не подтверждена: перейдите по ссылке из письма или отправьте его заново из окна Sync. Красная иконка и надпись «Session expired» означают, что сессия закончилась и нужно войти заново. Разбор всех состояний — на странице Синхронизация.
Куда сообщать о проблеме#
Баги и предложения — в issues репозитория github.com/tetiva-app/client. Короткие вопросы и обратная связь — в Telegram.
Приложите: версию из секции About в настройках, операционную систему, шаги воспроизведения и вывод из терминала. Проверьте перед отправкой, что в выводе не осталось токенов и адресов ваших внутренних сервисов.