From b628bfcd82c55b640b1c689db6a115317d3c46f0 Mon Sep 17 00:00:00 2001
From: Umbrix Developer <vodorod@umbrix.app>
Date: Tue, 20 Jan 2026 11:56:04 +0300
Subject: [PATCH] feat: Add README and launch script for Windows Portable ZIP
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add README.txt with clear instructions (first file alphabetically)
- Add 'Запустить Umbrix.bat' for easy launch
- Update WINDOWS_PORTABLE_ZIP.md with file structure explanation
- Users won't be confused which file to run anymore
---
 update-server/WINDOWS_PORTABLE_ZIP.md         | 39 ++++++++++++++++++-
 windows/packaging/portable/README.txt         | 19 +++++++++
 .../packaging/portable/Запустить Umbrix.bat   |  8 ++++
 3 files changed, 65 insertions(+), 1 deletion(-)
 create mode 100644 windows/packaging/portable/README.txt
 create mode 100644 windows/packaging/portable/Запустить Umbrix.bat

diff --git a/update-server/WINDOWS_PORTABLE_ZIP.md b/update-server/WINDOWS_PORTABLE_ZIP.md
index 381cdd7f..d0e552c9 100644
--- a/update-server/WINDOWS_PORTABLE_ZIP.md
+++ b/update-server/WINDOWS_PORTABLE_ZIP.md
@@ -29,12 +29,23 @@ flutter build windows --release
 # Путь к build папке
 $buildPath = "build\windows\x64\runner\Release"
 
+# ✨ НОВОЕ: Добавить файлы для пользователей
+Copy-Item "windows\packaging\portable\README.txt" -Destination "$buildPath\" -Force
+Copy-Item "windows\packaging\portable\Запустить Umbrix.bat" -Destination "$buildPath\" -Force
+
 # Создать ZIP архив
 $zipName = "umbrix-1.7.5-portable-windows-x64.zip"
 Compress-Archive -Path "$buildPath\*" -DestinationPath $zipName -Force
 
 # Проверить размер (~50-60MB)
 Get-Item $zipName | Select-Object Name, Length
+
+Write-Host "`n✅ ZIP содержит:" -ForegroundColor Green
+Write-Host "  • README.txt (инструкция - ПЕРВЫЙ файл в списке)" -ForegroundColor Cyan
+Write-Host "  • Запустить Umbrix.bat (удобный запуск)" -ForegroundColor Cyan
+Write-Host "  • Umbrix.exe (основное приложение)" -ForegroundColor Yellow
+Write-Host "  • UmbrixCli.exe (служебная утилита)" -ForegroundColor Gray
+Write-Host "  • Все DLL и папки" -ForegroundColor Gray
 ```
 
 ### Шаг 3: Создать релиз в Gitea
@@ -176,7 +187,33 @@ Get-Item $zipName | Select-Object Name, @{N="Size (MB)";E={[math]::Round($_.Leng
 
 ---
 
-## 💡 Советы
+## � Структура Portable ZIP (что видят пользователи)
+
+Когда пользователь распакует ZIP, он увидит:
+
+```
+umbrix-portable/
+├── 📄 README.txt                          ⭐ ПЕРВЫЙ в списке - инструкция!
+├── 🚀 Запустить Umbrix.bat               ⭐ Удобный способ запуска
+├── 📱 Umbrix.exe                          ⭐ Основное приложение (267 KB)
+├── ⚙️  UmbrixCli.exe                      ⚠️  Служебная утилита (1.8 MB)
+├── 1.7.4/                                 📂 Папка с данными
+├── data/                                  📂 Ресурсы Flutter
+├── dynamic_color_plugin.dll              🔧 DLL плагины
+├── flutter_windows.dll                   🔧 Flutter (17 MB)
+├── libcore.dll                           🔧 Либкор (45 MB)
+└── ...другие DLL...
+```
+
+**Почему пользователи не запутаются:**
+1. ✅ **README.txt** - первый файл (по алфавиту), ясная инструкция
+2. ✅ **Запустить Umbrix.bat** - второй файл, понятное название
+3. ✅ **Umbrix.exe** с красивой иконкой - визуально выделяется
+4. ⚠️ **UmbrixCli.exe** - название намекает что это утилита командной строки
+
+---
+
+## �💡 Советы
 
 **Для разработки:**
 - ✅ Используйте Portable ZIP - быстрее тестировать
diff --git a/windows/packaging/portable/README.txt b/windows/packaging/portable/README.txt
new file mode 100644
index 00000000..48455ccc
--- /dev/null
+++ b/windows/packaging/portable/README.txt
@@ -0,0 +1,19 @@
+═══════════════════════════════════════════════════════════
+   UMBRIX - Portable Version
+═══════════════════════════════════════════════════════════
+
+🚀 ДЛЯ ЗАПУСКА ПРИЛОЖЕНИЯ:
+   ► Откройте файл:  Umbrix.exe
+
+📦 Portable версия:
+   • Не требует установки
+   • Не требует прав администратора  
+   • Все настройки сохраняются в папке приложения
+
+⚠️  НЕ ЗАПУСКАЙТЕ:
+   • UmbrixCli.exe - это служебная утилита командной строки
+   • Файлы .dll - это системные библиотеки
+
+═══════════════════════════════════════════════════════════
+   https://umbrix.net
+═══════════════════════════════════════════════════════════
diff --git a/windows/packaging/portable/Запустить Umbrix.bat b/windows/packaging/portable/Запустить Umbrix.bat
new file mode 100644
index 00000000..a844e5b2
--- /dev/null
+++ b/windows/packaging/portable/Запустить Umbrix.bat	
@@ -0,0 +1,8 @@
+@echo off
+chcp 65001 >nul 2>&1
+echo.
+echo ═══════════════════════════════════════════════
+echo    Запуск Umbrix...
+echo ═══════════════════════════════════════════════
+echo.
+start "" "%~dp0Umbrix.exe"