Update README.md

README.md

@@ -1,10 +1,45 @@
 ---
-title: Tgapitest7
-emoji: 💻
-colorFrom: indigo
-colorTo: purple
+title: TgAPIToolsTunnel
+emoji: 🛠️
+colorFrom: green
+colorTo: blue
 sdk: docker
+app_port: 7860 # Основной порт Telegram Bot API
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## Telegram Bot API с расширенными инструментами и туннелем
+
+Этот Space запускает локальный сервер Telegram Bot API и предоставляет дополнительные инструменты через Node.js Express приложение, доступное по туннелю `localhost.run`:
+
+1.  **Статистика по файлам**: Количество файлов и общий размер в директории данных Telegram Bot API.
+2.  **Скачивание файлов**: Возможность скачивать файлы (например, аватарки пользователей), пути к которым возвращает локальный Telegram Bot API.
+3.  **Очистка старых файлов (TTL)**: Автоматическое удаление старых файлов из кэша Telegram Bot API.
+4.  **Обновление Gist**: Информация о Space и URL туннеля к инструментам сохраняется в GitHub Gist.
+
+### Необходимые секреты
+
+Добавьте следующие секреты в настройках вашего Space (`Settings -> Secrets`):
+
+*   `TELEGRAM_API_ID`: Ваш API ID от Telegram.
+*   `TELEGRAM_API_HASH`: Ваш API Hash от Telegram.
+*   `GITHUB_USERNAME`: Ваш логин на GitHub (для обновления Gist).
+*   `GITHUB_TOKEN`: Ваш Personal Access Token от GitHub с правом `gist` (для обновления Gist).
+*   `ENV_GIST_ID`: ID вашего GitHub Gist, куда будет сохраняться информация о Space и URL туннеля. Создайте пустой Gist и скопируйте его ID из URL.
+
+### Переменные окружения (можно переопределить через секреты)
+
+*   `EXPRESS_PORT`: Внутренний порт для Node.js Express приложения (по умолчанию `3001`).
+*   `TELEGRAM_DATA_DIR`: Директория данных для `telegram-bot-api` (по умолчанию `/var/lib/telegram-bot-api`).
+*   `FILES_TTL`: Время жизни файлов в часах. Старые файлы будут удаляться. Установите `-1` для отключения (по умолчанию `-1`).
+
+### Как использовать
+
+1.  **Основной API**: Доступен через стандартный URL вашего Space на порту `7860`.
+2.  **Инструменты (статистика, файлы)**:
+    *   URL туннеля будет выведен в логах Space при запуске и сохранен в указанный `ENV_GIST_ID`.
+    *   **Статистика**: `[URL_туннеля]/stats`
+    *   **Скачивание файла**:
+        Если `telegram-bot-api` (например, в ответе `getMe` для поля `photo.small_file_id`) вернул локальный путь типа `/var/lib/telegram-bot-api/photos/12345/file_0.jpg`, то для его скачивания используйте:
+        `[URL_туннеля]/file/photos/12345/file_0.jpg`
+        **Важно**: Часть `/var/lib/telegram-bot-api/` из пути отбрасывается, используется только относительный путь внутри этой директории.