From dec7ed2509a0e5f8ea0ca192b3f2d458367e75c6 Mon Sep 17 00:00:00 2001
From: Umbrix Developer <vodorod@umbrix.app>
Date: Tue, 20 Jan 2026 13:30:04 +0300
Subject: [PATCH] docs: Add quick start guide for Windows Portable

---
 update-server/WINDOWS_PORTABLE_QUICK_START.md | 87 +++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 update-server/WINDOWS_PORTABLE_QUICK_START.md

diff --git a/update-server/WINDOWS_PORTABLE_QUICK_START.md b/update-server/WINDOWS_PORTABLE_QUICK_START.md
new file mode 100644
index 00000000..7b7e0e4b
--- /dev/null
+++ b/update-server/WINDOWS_PORTABLE_QUICK_START.md
@@ -0,0 +1,87 @@
+# 🚀 Быстрая сборка Windows Portable ZIP
+
+## Проблема решена! ✅
+
+Теперь в ZIP будут файлы которые помогут пользователям не запутаться:
+
+```
+umbrix-portable/
+├── 📄 README.txt                   ⭐ ПЕРВЫЙ в списке - ясная инструкция!
+├── 🚀 Запустить Umbrix.bat        ⭐ Удобный запуск одним кликом
+├── 📱 Umbrix.exe                   ⭐ Основное приложение
+├── ⚙️  UmbrixCli.exe               ⚠️  Служебная утилита
+└── ...DLL и папки...
+```
+
+---
+
+## 📦 Команда для сборки на Windows
+
+```powershell
+# 1. Собрать Release
+flutter build windows --release
+
+# 2. Скопировать файлы для пользователей + создать ZIP
+$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
+
+$zipName = "umbrix-1.7.5-portable-windows-x64.zip"
+Compress-Archive -Path "$buildPath\*" -DestinationPath $zipName -Force
+
+# 3. Проверить
+Get-Item $zipName | Select-Object Name, @{N="MB";E={[math]::Round($_.Length/1MB,2)}}
+```
+
+---
+
+## ✅ Что увидит пользователь после распаковки
+
+1. **README.txt** - первый файл (по алфавиту с символом '═')
+   - Большой заголовок с инструкцией
+   - Указывает запускать **Umbrix.exe**
+   - Предупреждает не запускать UmbrixCli.exe
+
+2. **Запустить Umbrix.bat** - второй файл
+   - Русское название понятное всем
+   - Запускает Umbrix.exe автоматически
+
+3. **Umbrix.exe** - основное приложение
+   - Яркая цветная иконка
+   - Выделяется визуально
+
+4. **UmbrixCli.exe** - служебная утилита
+   - Название "Cli" намекает что это командная строка
+   - Большинство не будет трогать
+
+---
+
+## 🎯 Альтернативы (если не понравится)
+
+### Вариант 1: Скрыть CLI в подпапку
+```powershell
+# При создании ZIP переместить CLI в tools/
+New-Item -Path "$buildPath\tools" -ItemType Directory -Force
+Move-Item "$buildPath\UmbrixCli.exe" "$buildPath\tools\" -Force
+Compress-Archive -Path "$buildPath\*" -DestinationPath $zipName -Force
+```
+
+### Вариант 2: Переименовать основное приложение
+Изменить в `windows/packaging/exe/make_config.yaml`:
+```yaml
+executable_name: Start-Umbrix.exe  # Без пробела!
+```
+⚠️ Но это сломает update скрипты которые ищут `umbrix.exe`
+
+### Вариант 3: Только батник
+Удалить README.txt, оставить только `Запустить Umbrix.bat` как единственный понятный способ запуска.
+
+---
+
+## 📝 Полная документация
+
+См. [WINDOWS_PORTABLE_ZIP.md](./WINDOWS_PORTABLE_ZIP.md) для:
+- Создания релиза в Gitea
+- Загрузки ZIP через API
+- Тестирования auto-update
+- Сравнения ZIP vs EXE