telegram-tui/FAQ.md

# FAQ — Часто задаваемые вопросы

## Установка и запуск

### Где получить API credentials?

1. Перейдите на https://my.telegram.org/apps
2. Войдите с вашим номером телефона
3. Создайте новое приложение
4. Скопируйте `api_id` и `api_hash`

### Где хранить credentials?

**Рекомендуется** (приоритет 1):
```bash
~/.config/tele-tui/credentials
```

**Альтернатива** (приоритет 2):
```bash
.env  # в корне проекта
```

### Ошибка "Telegram API credentials not found!"

Убедитесь, что вы создали файл credentials (см. выше) с правильным форматом:
```
API_ID=12345678
API_HASH=abcdef1234567890abcdef1234567890
```

### Где хранится сессия Telegram?

В папке `./tdlib_data/` в директории запуска приложения. Эта папка содержит:
- Токены авторизации
- Кеш сообщений
- Другие данные TDLib

**Важно**: Не удаляйте эту папку, иначе придётся заново авторизоваться.

## Использование

### Как переключаться между папками?

Нажмите клавиши `1-9` для переключения между первыми 9 папками Telegram.

### Как искать сообщения в чате?

1. Откройте чат
2. Нажмите `Ctrl+F`
3. Введите поисковый запрос
4. Используйте `n` / `N` для навигации по результатам

### Как скопировать текст сообщения?

1. При пустом поле ввода нажмите `↑` для выбора сообщения
2. Нажмите `y` (или `н` на русской раскладке)
3. Текст скопирован в системный буфер обмена

### Как ответить на сообщение?

1. Выберите сообщение (`↑` при пустом инпуте)
2. Нажмите `r` (или `к` на русской раскладке)
3. Введите ответ
4. Нажмите `Enter`

### Как удалить сообщение?

1. Выберите сообщение
2. Нажмите `d` / `в` / `Delete`
3. Подтвердите удаление: `y` / `Enter`

### Как добавить реакцию?

1. Выберите сообщение
2. Нажмите `e` (или `у` на русской раскладке)
3. Выберите emoji стрелками
4. Нажмите `Enter`

### Почему не работают хоткеи на русской раскладке?

Убедитесь, что вы используете **русскую раскладку**, а не транслит. Поддерживаемые комбинации:
- `р о л д` → `h j k l` (навигация)
- `к` → `r` (reply)
- `а` → `f` (forward)
- `в` → `d` (delete)
- `н` → `y` (copy)
- `у` → `e` (react)

## Конфигурация

### Где находится конфигурационный файл?

```bash
~/.config/tele-tui/config.toml
```

Создаётся автоматически при первом запуске.

### Как изменить часовой пояс?

Отредактируйте `~/.config/tele-tui/config.toml`:

```toml
[general]
timezone = "+05:00"  # Ваш часовой пояс
```

### Как изменить цветовую схему?

Отредактируйте секцию `[colors]` в конфиге:

```toml
[colors]
incoming_message = "cyan"
outgoing_message = "lightgreen"
selected_message = "lightyellow"
```

Поддерживаемые цвета: black, red, green, yellow, blue, magenta, cyan, gray, white, darkgray, lightred, lightgreen, lightyellow, lightblue, lightmagenta, lightcyan.

### Нужно ли перезапускать приложение после изменения конфига?

Да, изменения в `config.toml` применяются только при запуске приложения.

## Проблемы

### Приложение зависает при запуске

Возможные причины:
1. **Нет интернета**: проверьте подключение
2. **TDLib не может подключиться**: проверьте firewall/прокси
3. **Неверные credentials**: проверьте API_ID и API_HASH

### Сообщения не загружаются

1. Проверьте статус сети в футере (внизу экрана)
2. Попробуйте обновить: `Ctrl+R`
3. Перезапустите приложение

### "Deleted Account" в списке чатов

Это пользователи, которые удалили свой аккаунт Telegram. Они автоматически фильтруются и не отображаются в списке.

### Не отображаются медиафайлы

Медиафайлы (фото, видео, голосовые, стикеры) отображаются как заглушки: [Фото], [Видео], [Голосовое], [Стикер]. Полная поддержка медиа может быть добавлена в будущем.

### Ошибка компиляции при сборке

**TDLib download failed**:
- Проверьте интернет-соединение
- Убедитесь, что у вас достаточно места на диске

**Linking with cc failed**:
- macOS: `xcode-select --install`
- Linux: `sudo apt-get install build-essential`
- Windows: установите Visual Studio Build Tools

### Как сбросить сессию?

Удалите папку `tdlib_data/`:
```bash
rm -rf tdlib_data/
```

При следующем запуске потребуется заново авторизоваться.

## Производительность

### Приложение тормозит

Проверьте:
1. Количество открытых чатов (лимит 200)
2. Количество сообщений в открытом чате (лимит 500)
3. Размер терминала (минимум 80x20)

Приложение автоматически очищает старые данные при достижении лимитов.

### Высокое использование памяти

Это нормально при большом количестве чатов и сообщений. Приложение использует LRU кеши с ограничениями:
- 500 пользователей в кеше
- 500 сообщений на чат
- 200 чатов

## Разработка

### Как внести вклад в проект?

См. [CONTRIBUTING.md](CONTRIBUTING.md)

### Где найти план развития?

См. [ROADMAP.md](ROADMAP.md)

### Как сообщить о баге?

Создайте issue на GitHub с описанием:
- Шаги для воспроизведения
- Ожидаемое и фактическое поведение
- Версия ОС и Rust
- Логи (если есть)

## Безопасность

### Безопасно ли хранить credentials в файле?

Да, если вы:
1. Используете `~/.config/tele-tui/credentials`
2. Установили права доступа: `chmod 600 ~/.config/tele-tui/credentials`
3. Не коммитите этот файл в git (уже в `.gitignore`)

### Что делать при компрометации credentials?

1. Удалите приложение на https://my.telegram.org/apps
2. Создайте новое приложение с новыми credentials
3. Обновите файл `credentials`
4. Удалите папку `tdlib_data/` и авторизуйтесь заново

### Включена ли двухфакторная аутентификация?

Если вы включили 2FA в Telegram, приложение запросит пароль при первой авторизации.

## Ещё вопросы?

Создайте issue на GitHub или свяжитесь с maintainers.