добавил ридми

2025-08-13 18:43:01 +02:00
parent 2717b24806
commit 9a4f305853
1 changed files with 96 additions and 0 deletions
@@ -0,0 +1,96 @@
+## Пример .env
+
+Создайте файл `.env` в корне проекта и заполните:
+
+```env
+TELEGRAM_TOKEN=your_telegram_token
+DISCORD_TOKEN=your_discord_token
+VK_TOKEN=your_vk_token
+TELEGRAM_CHAT_ID=-1001234567890
+DISCORD_CHANNEL_ID=123456789012345678
+VK_PEER_ID=2000000001
+VK_GROUP_ID=2000000001
+```
+
+docker-compose автоматически подхватит эти переменные.
+
+# Go Chat Bridge
+
+Мультичат-бот для объединения Telegram, Discord и VK.
+
+## Возможности
+- Пересылка сообщений между Telegram, Discord и VK
+- Отображение имени отправителя в пересылаемых сообщениях
+- Поддержка работы с группами VK через LongPoll
+
+## Быстрый старт
+
+1. Клонируйте репозиторий:
+   ```bash
+   git clone <repo_url>
+   cd turn-bridge
+   ```
+2. Установите зависимости:
+   ```bash
+   go mod tidy
+   ```
+3. Создайте и настройте ботов/токены для всех платформ:
+   - Telegram: получите токен у @BotFather
+   - Discord: создайте приложение и получите токен
+   - VK: получите токен группы с правами messages, groups (см. инструкцию ниже)
+4. Укажите переменные окружения:
+   ```bash
+   export TELEGRAM_TOKEN=...         # токен Telegram-бота
+   export DISCORD_TOKEN=...          # токен Discord-бота
+   export VK_TOKEN=...               # токен группы VK
+   export TELEGRAM_CHAT_ID=...       # id чата/канала Telegram
+   export DISCORD_CHANNEL_ID=...     # id канала Discord
+   export VK_PEER_ID=...             # peer_id беседы VK
+   export VK_GROUP_ID=...            # id группы VK
+   ```
+5. Запустите приложение:
+   ```bash
+   go run .
+   ```
+
+## Получение токена VK с нужными правами
+
+1. В настройках группы VK включите Long Poll API и разрешите сообщения.
+2. Получите токен через интерфейс группы или через OAuth:
+   - Создайте Standalone-приложение VK
+   - Перейдите по ссылке:
+     ```
+     https://oauth.vk.com/authorize?client_id=ВАШ_CLIENT_ID&display=page&redirect_uri=https://oauth.vk.com/blank.html&scope=messages,groups&response_type=token&v=5.131
+     ```
+   - Авторизуйтесь, скопируйте access_token из адресной строки.
+
+## Формат пересылаемых сообщений
+
+- `[TG] user: текст` — из Telegram
+- `[DS] user: текст` — из Discord
+- `[VK] user: текст` — из VK (имя пользователя VK)
+
+## Пример .env
+
+Создайте файл `.env` в корне проекта и заполните:
+
+```env
+TELEGRAM_TOKEN=your_telegram_token
+DISCORD_TOKEN=your_discord_token
+VK_TOKEN=your_vk_token
+TELEGRAM_CHAT_ID=-1001234567890
+DISCORD_CHANNEL_ID=123456789012345678
+VK_PEER_ID=2000000001
+VK_GROUP_ID=2000000001
+```
+
+docker-compose автоматически подхватит эти переменные.
+## TODO
+- Поддержка вложений и файлов
+- Админ-команды
+- Логирование событий
+
+## Лицензия
+MIT
+
+