benya
3ed5bba9af
- Исправлена ошибка ImportError: QtWebEngineCore путем перехода на PyInstaller. - Добавлен скрипт build.py для автоматической сборки, очистки DLL и создания ZIP-архива. - Реализована поддержка бессрочного доступа (offline_access) для VK Access Token. - Обновлен README.md: добавлены разделы для разработчиков и описание структуры данных. - Оптимизирован размер билда за счет удаления неиспользуемых библиотек Qt и папок локализации.
104 lines
5.4 KiB
Markdown
104 lines
5.4 KiB
Markdown
# 🚀 Anabasis VK Chat Manager
|
||
|
||
**Anabasis VK Chat Manager** — специализированное десктопное приложение для HR-менеджеров и администраторов сообществ, предназначенное для автоматизации управления участниками в чатах ВКонтакте. Избавьтесь от рутины и управляйте всеми беседами из одного удобного интерфейса.
|
||
|
||
---
|
||
|
||
## ✨ Основные возможности
|
||
|
||
* **🔐 Безопасная авторизация:** Вход через официальный VK OAuth во встроенном защищенном браузере.
|
||
* **💾 Умное сохранение сессий:** Поддержка Persistent Cookies — не нужно вводить пароль при каждом запуске.
|
||
* **⏳ Таймер токена:** Наглядное отображение времени действия сессии прямо в интерфейсе.
|
||
* **📊 Массовые операции:**
|
||
* Моментальная загрузка всех доступных чатов пользователя.
|
||
* Групповой выбор чатов («Выбрать все» / «Снять выбор»).
|
||
* Быстрое обновление списка бесед.
|
||
* **👤 Интеллектуальный поиск ID:** Автоматическое распознавание ID пользователя из ссылок любого формата (например, `vk.com/id123`, `vk.com/durov` или просто `durov`).
|
||
* **🛠 Управление в один клик:** Кнопки для мгновенного исключения или приглашения пользователя во все выбранные чаты одновременно.
|
||
* **🛡 Стабильность:** Улучшенная обработка ошибок VK API и автоматическая реакция на смену IP-адреса.
|
||
|
||
---
|
||
|
||
## 📦 Установка и запуск
|
||
|
||
### Вариант 1: Готовый билд (Windows)
|
||
1. Перейдите в раздел **Releases** на GitHub.
|
||
2. Скачайте архив формата `AnabasisManager-1.x.zip`.
|
||
3. Распакуйте архив в удобную папку.
|
||
4. Запустите файл **AnabasisManager.exe**.
|
||
|
||
### Вариант 2: Запуск из исходного кода
|
||
Вам потребуется **Python 3.10** или выше.
|
||
|
||
1. **Клонируйте репозиторий:**
|
||
```bash
|
||
git clone [https://github.com/your-username/AnabasisVKChatManager.git](https://github.com/your-username/AnabasisVKChatManager.git)
|
||
cd AnabasisVKChatManager
|
||
```
|
||
|
||
2. **Настройте виртуальное окружение:**
|
||
```bash
|
||
python -m venv venv
|
||
# Для Windows:
|
||
.\venv\Scripts\activate
|
||
# Для macOS/Linux:
|
||
source venv/bin/activate
|
||
```
|
||
|
||
3. **Установите зависимости:**
|
||
```bash
|
||
pip install PySide6 vk_api
|
||
```
|
||
|
||
4. **Запустите приложение:**
|
||
```bash
|
||
python main.py
|
||
```
|
||
|
||
---
|
||
|
||
## 🕹 Инструкция по использованию
|
||
|
||
1. **Вход:** Нажмите кнопку «Авторизоваться через VK». Введите данные в открывшемся окне браузера.
|
||
2. **Выбор целей:** Отметьте галочками чаты, в которых нужно произвести изменения.
|
||
3. **Данные пользователя:** Вставьте ссылку на профиль VK человека, которого нужно добавить или удалить.
|
||
4. **Действие:** Нажмите кнопку нужной операции. Следите за прогрессом в окне системных сообщений.
|
||
|
||
---
|
||
|
||
## 📂 Техническая информация
|
||
|
||
### Сборка проекта (для разработчиков)
|
||
Проект использует кастомный скрипт автоматизации `build.py`, который оптимизирует зависимости `PySide6` и корректно упаковывает `QtWebEngineCore`.
|
||
|
||
**Команда для сборки:**
|
||
```bash
|
||
python build.py
|
||
```
|
||
|
||
Скрипт автоматически:
|
||
|
||
Собирает .exe через PyInstaller с использованием --collect-all для модулей WebEngine.
|
||
|
||
Удаляет лишние библиотеки (PDF, Multimedia, Designer) и папки переводов, сокращая размер сборки на ~100 МБ.
|
||
|
||
Создает готовый ZIP-архив с актуальной версией в названии.
|
||
|
||
Хранение данных
|
||
|
||
Приложение использует системные папки AppData для изоляции пользовательских данных:
|
||
|
||
Windows: %APPDATA%/AnabasisVKChatManager
|
||
|
||
macOS: ~/Library/Application Support/AnabasisVKChatManager
|
||
|
||
В этих папках хранятся token.json (доступ к API) и web_engine_cache/ (сессия браузера).
|
||
|
||
---
|
||
|
||
## 📜 Лицензия
|
||
|
||
---
|
||
Проект распространяется под лицензией MIT.
|
||
|
||
Сэкономьте часы ручного труда с Anabasis VK Chat Manager. |