From 23b73bd2902778503cd76f7eb9f9b272c700415a Mon Sep 17 00:00:00 2001
From: RarDog <playfirty954@gmail.com>
Date: Fri, 4 Sep 2026 16:11:46 +0300
Subject: [PATCH] docs: overhaul README with Lunaris 3.0 and add GitHub Actions
 release workflow

---
 .github/workflows/release.yml |  70 ++++++++++++++
 README.md                     | 169 +++++++++++++++++-----------------
 2 files changed, 155 insertions(+), 84 deletions(-)
 create mode 100644 .github/workflows/release.yml

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..6ffb097
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,70 @@
+name: Build and Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build-windows:
+    name: Build Windows x64
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.27.4'
+          channel: 'stable'
+          cache: true
+
+      - name: Install Dependencies
+        run: flutter pub get
+
+      - name: Build Windows Release
+        run: flutter build windows --release
+
+      - name: Package Windows Zip
+        shell: pwsh
+        run: |
+          $tag = "${{ github.ref_name }}"
+          if (-not $tag) { $tag = "v3.0.0" }
+          $zipName = "Lunaris-$tag-windows-x64.zip"
+          Compress-Archive -Path "build\windows\x64\runner\Release\*" -DestinationPath $zipName
+          echo "ZIP_NAME=$zipName" >> $env:GITHUB_ENV
+
+      - name: Upload to GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: ${{ env.ZIP_NAME }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload Windows Zip to Gitea Release
+        shell: pwsh
+        run: |
+          $tag = "${{ github.ref_name }}"
+          if (-not $tag) { $tag = "v3.0.0" }
+          $token = "1c744d6044d756759d7b1f693c94c80cf70d75fa"
+          $giteaUrl = "https://gitea.rardogsynapse.online"
+          $repo = "RarDog/Lunaris"
+          $zipName = $env:ZIP_NAME
+
+          Write-Host "Fetching Gitea release info for tag $tag..."
+          $relUrl = "$giteaUrl/api/v1/repos/$repo/releases/tags/$tag"
+          $headers = @{ "Authorization" = "token $token" }
+          $rel = Invoke-RestMethod -Uri $relUrl -Headers $headers -Method Get
+          $releaseId = $rel.id
+          Write-Host "Found Gitea release ID: $releaseId"
+
+          $uploadUrl = "$giteaUrl/api/v1/repos/$repo/releases/$releaseId/assets?name=$zipName"
+          Write-Host "Uploading $zipName to $uploadUrl..."
+          curl.exe -X POST -H "Authorization: token $token" -F "attachment=@$zipName" $uploadUrl
+          Write-Host "Successfully uploaded Windows build to Gitea!"
diff --git a/README.md b/README.md
index 037a330..65308e1 100644
--- a/README.md
+++ b/README.md
@@ -1,149 +1,150 @@
 # 🌙 Lunaris
 
 <p align="center">
-  <img src="assets/branding/app_icon.png" width="128" height="128" alt="Lunaris Logo" />
+  <img src="android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png" width="128" height="128" alt="Lunaris Logo" style="border-radius: 28px; box-shadow: 0 10px 30px rgba(0,0,0,0.35);" />
 </p>
 
 <p align="center">
-  <strong>Современный кроссплатформенный клиент для Booru и Creator-архивов</strong><br>
-  Плавный Pinterest-стиль, поддержка фото, видео и GIF, умный черный список, встроенный менеджер загрузок и автообновление.
+  <strong>Современный кроссплатформенный клиент для Booru и Creator-архивов нового поколения</strong><br>
+  Плавный Pinterest-стиль, интеграция Pawchive 2.0, двусторонняя синхронизация, интеллектуальное автообновление и воспроизведение медиа без задержек.
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/Version-2.3.1-blueviolet?style=for-the-badge" alt="Version 2.3.1" />
+  <a href="https://github.com/RarDog/Lunaris/releases"><img src="https://img.shields.io/badge/Version-3.0.0-8A2BE2?style=for-the-badge&logo=semver&logoColor=white" alt="Version 3.0.0" /></a>
   <img src="https://img.shields.io/badge/Flutter-3.47+-02569B?style=for-the-badge&logo=flutter&logoColor=white" alt="Flutter" />
-  <img src="https://img.shields.io/badge/Platform-Android%20%7C%20Linux%20%7C%20Windows-brightgreen?style=for-the-badge" alt="Platforms" />
-  <img src="https://img.shields.io/badge/Gitea-RarDog%2FLunaris-orange?style=for-the-badge&logo=gitea&logoColor=white" alt="Gitea" />
+  <img src="https://img.shields.io/badge/Platform-Android%20%7C%20Linux%20%7C%20Windows-00C853?style=for-the-badge" alt="Platforms" />
+  <a href="https://gitea.rardogsynapse.online/RarDog/Lunaris"><img src="https://img.shields.io/badge/Gitea-RarDog%2FLunaris-FC6D26?style=for-the-badge&logo=gitea&logoColor=white" alt="Gitea" /></a>
+  <img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License MIT" />
 </p>
 
 ---
 
-## ✨ Основные возможности
+## 🚀 Что нового в Lunaris 3.0 (Major Release)
 
-- **💾 Офлайн 2.0 и Sync Hub**: 100% честное воспроизведение видео и просмотр фото прямо с диска без единого запроса в сеть, карточка аналитики хранилища (`💾 X.X ГБ на устройстве`), кнопка пакетного скачивания недостающих в 1 тап и удобная сортировка по дате, размеру и авторам.
-- **🖼️ Экран поста 2.0**: Action Dock 2.0 (чистый док из 5 главных действий + модальный лист вторичных функций), современная карточка инфо с автором, провайдером, разрешением, форматом и оценкой, лента соседних постов на мобильных и ПК, стильные блоки тегов и комментарии в виде чат-бабблов.
-- **🔍 Поиск 2.0**: Hero-панель поиска, быстрые чипы операторов (`and`, `type:video`, `rating:safe`), облако недавних поисков с быстрым удалением крестиком `✕`, карточки популярных категорий и шпаргалка по синтаксису запросов.
-- **❤️ Избранное 2.0**: Живые счетчики в сегментах (Все, Офлайн, Авторы), быстрый фильтр по типу медиа (Все / Видео / Фото), мгновенный поиск среди сохраненных работ и карточки авторов в стиле Spotify с мини-коллажем из 3 превью.
-- **🕒 История 2.0**: Группировка по дням (Сегодня, Вчера, даты), переключение между подробным списком (с 68x68 миниатюрами, бэйджами провайдеров и быстрым удалением из истории) и галерейной Masonry-сеткой, а также диалог подтверждения очистки.
-- **📁 Коллекции 2.0**: Мозаичные обложки 2x2 с превью постов, счетчики работ со стеклянным бейджем, современный экран деталей коллекции и обновленный диалог создания.
-- **⚙️ Settings 2.0**: Полный редизайн настроек с современными squircle-карточками, горизонтальной быстрой навигацией по разделам, мгновенными Segmented-кнопками выбора темы/языка/качества и стильной карточкой о приложении.
+### 🎨 Дизайн 2.0
+- **Современный визуальный стиль**: Полный переход на squircle-карточки, адаптивную цветовую палитру и улучшенную Material You динамическую тему.
+- **Интеллектуальный Action Dock 2.0**: Компактный док ключевых действий под контентом с быстрым доступом к скачиванию, шерингу, тегам и инфо.
+- **Плавные анимации и микро-взаимодействия**: Открытие медиа с эффектом Hero, интерактивное листание свайпами и анимированный лайк по двойному тапу.
 
-- **⚡ Мгновенные подсказки тегов (0 мс) и постоянный файловый кэш**: Локальный JSON-кэш на телефоне и ПК обеспечивает мгновенный отклик при наборе, а Danbooru, Gelbooru, Moebooru и e621 динамически дополняют базу тегов.
-- **🎨 Цветные бейджи категорий и подсветка совпадений**: Выделение введенных букв жирным цветом акцента и четкая цветовая палитра категорий (художник — красный, персонаж — зеленый, копирайт — фиолетовый, вид — голубой).
-- **📚 Расширенная история поиска и гибкие настройки**: До 2000 записей истории и до 20000 закэшированных тегов с ручным управлением и кнопками очистки в Настройках.
-- **🎯 Общие модификаторы в мультипоиске**: При вводе `cat and dog anthro` модификатор `anthro` автоматически применится к обоим тегам (`cat anthro` + `dog anthro`).
-- **🔀 Раздельный мульти-поиск по тегам через `and`**: Оператор `and` опрашивает серверную базу по каждому тегу независимо и плавно чередует посты обоих тегов в общей ленте.
-- **🌐 Pawchive в главной ленте**: Глобальная лента недавних постов с Pawchive подключена прямо в общий Feed наравне с Rule34, Gelbooru, e621 и Realbooru.
-- **🏷️ Интерактивные теги автора**: Быстрая фильтрация по темам с живыми счётчиками постов (`#tag (count)`).
-- **📢 Анонсы и новости авторов**: Всплывающее окно анонсов автора с датами и текстом обращений к аудитории.
-- **⚡ Мгновенный фильтр фото, видео и GIF**: Локальная быстрая фильтрация постов автора без задержек.
-- **📱 Плавная лента в стиле Pinterest**: Masonry-сетка с переключением режима (Masonry, 1:1 Сетка, Список) в шапке ленты.
-- **⚡ Сверхбыстрые видео-превью**: Мгновенная загрузка превью без фризов и лишней нагрузки на процессор и память смартфона.
-- **↔️ Листание постов влево и вправо**: Полноэкранный пейджер с плавными свайпами между фото и видео во всех разделах.
-- **❤️ Двойной тап для лайка и свайп вниз для закрытия**: Анимированное сердечко по двойному тапу и закрытие экрана просмотра свайпом вниз.
-- **📤 Прямая отправка файла (Share)**: Мгновенный экспорт оригинальных медиафайлов через системное меню «Поделиться».
-- **🔖 Сохраненные поисковые пресеты**: Быстрое сохранение комбинаций тегов и фильтров в закладки.
-- **📁 Умная структура папок скачивания**: Настраиваемые шаблоны поддиректорий (`{Artist}`, `{Provider}`, `{Service}`, `{ID}`, `{Date}`).
-- **🗑️ Менеджер кэша**: Детальная визуализация занятой памяти и выборочная очистка.
-- **📦 Бэкап и синхронизация**: Экспорт и импорт полной конфигурации в JSON-файл для переноса на другие устройства.
-- **🌑 AMOLED Pure Black тема**: Истинно черный фон (`#000000`) для экономии батареи на OLED дисплеях.
-- **🎨 Динамические цвета Material You**: Поддержка системной палитры Android из обоев устройства.
-- **⭐ Любимые авторы**: Компактная кнопка-звёздочка сверху справа для быстрого доступа ко всем любимым авторам.
-- **🏷️ Мультивыбор платформ**: Выбор нескольких платформ (Patreon, Fanbox, Fantia, Boosty, Discord).
-- **📜 Бесконечная подгрузка постов автора**: Умная пагинация при прокрутке вниз загружает всю историю работ.
-- **🔍 Умный поиск и автодополнение**: Интерактивные чипсы тегов с подсказками от активных API.
-- **🛡️ Продвинутый Blacklist / Whitelist**: Фильтрация по тегам, категориям, рейтингу контента и минимальному score.
-- **🎬 Встроенный плеер**: Удобное воспроизведение WebM / MP4, запоминание звука, fullscreen и повтор.
-- **💾 Менеджер загрузок и коллекции**: Скачивание оригиналов в высоком качестве и тематические папки-коллекции.
-- **🔄 Встроенное автообновление**: Проверка и скачивание свежих релизов напрямую из личного репозитория Gitea.
+### 🐾 Глубокая интеграция Pawchive 2.0
+- **Мульти-аккаунты**: Поддержка авторизации по логину и паролю, а также прямому вводу `Session Cookie`.
+- **Двусторонняя синхронизация (Two-Way Sync)**: Автоматическая синхронизация избранного между локальной базой Lunaris и профилем Pawchive. Новые авторы с сервера добавляются в приложение, а локальные авторы выгружаются на сервер в один тап.
+- **Моментальная синхронизация**: При нажатии кнопки «В избранное» у любого автора (Fanbox, Patreon, Fantia, Boosty, Gumroad, DLsite, Discord) статус синхронизируется с сервером на лету.
+
+### 🎬 Умный медиаплеер и определение разрешения
+- **Ленивое вычисление габаритов (1920×1080 и др.)**: Определение точного разрешения картинок и видео без полной предварительной загрузки тяжелых файлов.
+- **Автоповорот в полноэкранном режиме**: Видеоплеер автоматически ориентирует экран (альбомный или портретный режим) в зависимости от аспектного соотношения медиа.
+
+### 📦 Разделение APK и умное автообновление по ABI
+- Сборка облегчённых APK с разделением по архитектурам процессора (`arm64-v8a`, `armeabi-v7a`, `x86_64`).
+- Встроенная система обновлений автоматически определяет архитектуру вашего Android-устройства и скачивает только нужный APK, экономя трафик и ускоряя загрузку.
 
 ---
 
-## 🌐 Активные провайдеры
+## ✨ Ключевые возможности
 
-| Провайдер | Тип API | Назначение |
+- **📱 Плавная лента в стиле Pinterest**: Masonry-сетка с переключением режима отображения (Masonry, 1:1 Сетка, Компактный список).
+- **💾 Офлайн 2.0 и Sync Hub**: Просмотр фото и видео прямо из локального хранилища без запросов в сеть, аналитика занятого места и пакетная выгрузка.
+- **🔍 Поиск 2.0 с операторами**: Быстрые подсказки тегов со скоростью отклика 0 мс, оператор `and` для мульти-поиска, фильтры `type:video`, `rating:safe`.
+- **🛡️ Продвинутый Blacklist / Whitelist**: Фильтрация нежелательного контента по тегам, категориям, рейтингу и минимальному score.
+- **📁 Умный менеджер загрузок**: Шаблоны поддиректорий (`{Artist}`, `{Provider}`, `{Service}`, `{ID}`, `{Date}`) для аккуратного архива.
+- **🌑 AMOLED Pure Black**: Истинно черный фон для максимальной энергоэффективности на OLED/AMOLED дисплеях.
+
+---
+
+## 🌐 Поддерживаемые провайдеры
+
+| Провайдер | Тип API | Поддерживаемый контент |
 |---|---|---|
-| **Gelbooru** | XML / JSON API | Основная база аниме-артов |
-| **Rule34** | Booru API | Популярный booru-источник |
-| **Realbooru** | HTML Scraper | Фото и реалистичный контент |
-| **e621 / e926** | JSON API | Фурри- и антро-арт с богатой системой тегов |
-| **Pawchive** | REST API v1 | Архивы авторов Patreon, Pixiv Fanbox, Fantia и др. |
+| **Pawchive** | REST API v1 | Patreon, Pixiv Fanbox, Fantia, Boosty, Gumroad, DLsite, Discord |
+| **Gelbooru** | JSON / XML API | Аниме-арты, теги, авторы, рейтинги |
+| **Rule34** | Booru API | Огромная база booru-контента, видео и GIF |
+| **Realbooru** | Scraper / API | Фотосессии и реалистичный контент |
+| **e621 / e926** | REST JSON API | Фурри- и антро-арт с богатейшей таксономией тегов |
 
 ---
 
-## 📥 Скачать приложение
+## 📥 Загрузка (Скачать сборки)
 
-Готовые сборки для всех поддерживаемых платформ доступны на странице релизов:
+Релизы доступны на **[GitHub Releases](https://github.com/RarDog/Lunaris/releases)** и в личном репозитории **[Gitea Releases](https://gitea.rardogsynapse.online/RarDog/Lunaris/releases)**.
 
-🔗 **[Gitea Releases (RarDog/Lunaris)](https://gitea.rardogsynapse.online/RarDog/Lunaris/releases)**
-
-- **Android**: `Lunaris-v2.0.10.apk`
-- **Linux (x64)**: `Lunaris-v2.0.10-linux-x64.tar.gz`
-- **Windows**: `LunarisSetup-v2.0.10.exe` / `LunarisPortable-v2.0.10.zip`
+| Платформа | Архитектура | Формат | Описание |
+|---|---|---|---|
+| **Android** | `arm64-v8a` | `.apk` | Оптимизировано для современных смартфонов (64-bit) |
+| **Android** | `armeabi-v7a` | `.apk` | Для более старых Android-устройств (32-bit) |
+| **Android** | `x86_64` | `.apk` | Для эмуляторов Android и x86-планшетов |
+| **Linux** | `x86_64` | `.tar.gz` | Портативный архив для Linux-дистрибутивов |
+| **Windows** | `x64` | `.zip` / `.exe` | Портативная и установочная сборка для Windows 10/11 |
 
 ---
 
 ## 🛠️ Сборка из исходников
 
 ### Требования
-- Flutter SDK `>= 3.19.0`
-- OpenJDK 17
-- Android SDK (для сборки APK)
-- Clang / CMake / GTK-3 (для сборки под Linux)
+- **Flutter SDK**: `>= 3.22.0` (Dart `>= 3.4.0`)
+- **Android SDK**: Build-Tools & Platform-Tools (для Android)
+- **Linux**: `clang`, `cmake`, `ninja-build`, `pkg-config`, `libgtk-3-dev`
+- **Windows**: Visual Studio 2022 с компонентом «Desktop development with C++»
 
-### Команды разработки
+### Быстрый старт
 
 ```bash
 # Клонирование репозитория
-git clone https://gitea.rardogsynapse.online/RarDog/Lunaris.git
+git clone https://github.com/RarDog/Lunaris.git
 cd Lunaris
 
 # Установка зависимостей
 flutter pub get
 
-# Запуск тестов и анализатора
+# Проверка анализатора и запуск тестов
 flutter analyze
 flutter test
 
-# Запуск на подключенном устройстве
+# Запуск в режиме разработки
 flutter run
 ```
 
-### Сборка релизов
+### Сборка релизных пакетов
 
 ```bash
-# Android APK
-flutter build apk --release
+# Android (раздельные APK по архитектурам)
+flutter build apk --release --split-per-abi
 
-# Linux x64 Bundle
+# Linux (Desktop bundle)
 flutter build linux --release
 
-# Windows Bundle
+# Windows (Desktop bundle)
 flutter build windows --release
 ```
 
 ---
 
-## 🏛️ Архитектура
+## 🏛️ Архитектура проекта
 
-```
+```text
 lib/
- ├── app/               # Роутер, тема, локализация (RU/EN), анимации
+ ├── app/               # Роутер (GoRouter), темы, локализация (RU/EN), анимации
  ├── backend/
- │    ├── di/           # Riverpod providers для сервисов
- │    ├── models/       # Post, ArtistProfile, AppSettings, AppUpdateInfo
- │    ├── providers/    # Реализации API (Gelbooru, Rule34, Pawchive и др.)
- │    ├── repositories/ # Доступ к локальной БД Isar
- │    └── services/     # Бизнес-логика (Feed, Search, Favorites, Downloads, Updates)
- ├── core/              # Сеть (Dio), база данных (Isar), ошибки и кеши
- ├── features/          # Модули экранов (feed, post, artists, favorites, settings)
- └── shared/widgets/    # Переиспользуемые виджеты (PostCard, MasonryGrid, TagChip)
+ │    ├── di/           # Внедрение зависимостей (Riverpod providers)
+ │    ├── models/       # Post, ArtistProfile, PawchiveAccount, AppSettings
+ │    ├── providers/    # Клиенты API (Gelbooru, Rule34, Pawchive, e621)
+ │    ├── repositories/ # Локальная база данных Isar и кэширование
+ │    └── services/     # Сервисы: PawchiveSync, Feed, Search, Downloads, Updates
+ ├── core/              # Сетевой клиент (Dio), база данных, утилиты
+ ├── features/          # Модули экранов: feed, post, artists, favorites, settings
+ └── shared/widgets/    # Переиспользуемые компоненты (PostCard, MasonryGrid, Dock)
 ```
 
 ---
 
-## 🔒 Приватность и безопасность
+## 🔒 Безопасность и конфиденциальность
 
-- **Полная автономность**: Приложение не отправляет телеметрию и работает без внешних серверов-посредников.
-- **Локальное хранение**: Все настройки, история поиска, черный список и избранное хранятся исключительно на вашем устройстве в локальной базе Isar.
-- **Бережное отношение к трафику**: В ленте загружаются только оптимизированные превью. Тяжелые оригиналы и видео загружаются только при открытии или скачивании.
+- **100% локальное хранение**: Вся история, закладки, локальные авторы и конфигурации хранятся только в вашей локальной базе на устройстве.
+- **Никакой телеметрии**: Lunaris не собирает аналитику, не отправляет логи и уважает вашу приватность.
+- **Прямое соединение**: Запросы отправляются напрямую к выбранным API без прокси-серверов посредников.
+
+---
+
+<p align="center">
+  Разработано с ❤️ командой Lunaris.
+</p>