docs: overhaul README with Lunaris 3.0 and add GitHub Actions release workflow
Build and Release / Build Windows x64 (push) Has been cancelled
Build and Release / Build Windows x64 (push) Has been cancelled
This commit is contained in:
@@ -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!"
|
||||
@@ -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>
|
||||
|
||||
Reference in New Issue
Block a user