fixes

FAQ.md

@@ -0,0 +1,227 @@
+# 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.