fix(android): diagnostic log sharing and whitelist black-screen fix

.cursorrules

@@ -0,0 +1,32 @@
+# Invisible Gorilla XRay Client Notes
+
+- Всегда читать все файлы из `memory-bank/` в начале новой задачи. Если Memory Bank отсутствует, создать базовые файлы и поддерживать их в актуальном состоянии.
+- Всегда отвечать пользователю на русском языке.
+- Для Android VPN/TUN изменений проверять не только UI, но и реальную маршрутизацию через IP-проверку в браузере до и после `STOP`.
+- После правок в `XRay-Wrapper/xray/android_tun2socks.go` обязательно пересобирать `libXRayCore.so` для `arm64-v8a` и `x86_64`.
+- После правок в Android runtime/service публиковать как минимум `android-x64` для эмулятора и `android-arm64` для устройства.
+- Для Android нативная библиотека должна идти через `AndroidNativeLibrary`, а не через копирование `.bin` в app-private storage.
+- В `InvisibleGorilla-XRay.Android/Views/MainView.axaml.cs` для сложных overlay/dialog контролов не полагаться на auto-generated поля `x:Name`; на Android они могут оставаться `null` в runtime. Для обращений из code-behind использовать явные `GetRequiredControl(...)`-геттеры с именами, не совпадающими с `x:Name`.
+- Если на Android проявляется зависание при `STOP`, сначала проверять блокировки вокруг `StopAndroidTun2Socks`, `AndroidVpnService`, `OnStartCommand`, `StopForeground`, и `logcat` на `Timeout executing service` или `ANR`.
+- Для сложных `vless://` ссылок в adb помнить, что `&` и `#` могут ломаться shell-парсингом; при необходимости валидировать через прямую запись конфига в app data или через UI/clipboard flow.
+- Для установки и runtime-проверки Android-сборок на эмуляторе использовать `Release` APK; `dotnet publish -c Debug` может давать fast-deployment APK с падением `No assemblies found ... Assuming this is part of Fast Deployment`.
+- В `XRay-Wrapper/xray/android_tun2socks.go` нельзя занулять `bridge.tunFile`/`bridge.lwip` до завершения `runAndroidTunLoop`; корректный shutdown: закрыть `stop`, закрыть TUN FD, дождаться `bridge.done`, затем закрывать LWIP, иначе `STOP` может уронить Android процесс через Go panic `nil pointer dereference`.
+- В Windows-сборке `InvisibleGorilla-XRay` runtime-пути (`Settings.json`, `TUN`, `Libraries`) завязаны на текущую рабочую директорию (`.`), а не на переназначаемый `SetRoot()`, поэтому любые desktop runtime-проверки вне UI нужно запускать с правильным `cwd`.
+- В `InvisibleGorilla-XRay.Mac/Views` использовать абсолютные `using InvisibleGorillaXRay.Services...`, потому что после добавления `InvisibleGorillaXRay.Mac.Services` относительные `using Services...` начинают резолвиться не в тот namespace.
+- Desktop app rules хранятся как полный список выбранных приложений; при сохранении настроек нужно сохранять и те выбранные rules, которые временно не попали в auto-discovery список, чтобы не терять скрытые/редкие приложения.
+- В Avalonia-представлениях Android не называть собственные свойства/геттеры так же, как `x:Name` в `.axaml`: `Avalonia.NameGenerator` уже создаёт поля с этими именами, и совпадение приводит к `CS0102` при сборке.
+- Исключения приложений в Android через `VpnService.Builder.AddDisallowedApplication(...)` меняют маршрут трафика, но не гарантируют, что сторонние приложения не увидят сам факт активной VPN-сессии; в Windows/macOS текущая реализация split tunneling тоже не делает TUN/VPN полностью невидимым на уровне ОС.
+- Для TUN-режима локальный SOCKS listener теперь должен идти только через session-scoped auth contract (`InvisibleGorillaXRayCore` -> `XRayCoreWrapper` -> native `XRay-Wrapper` -> Android/desktop helper); не откатывать Android или desktop TUN path обратно на `NO_AUTH`. Desktop `system proxy` path пока сознательно остаётся legacy-веткой до отдельной совместимой реализации.
+- При сохранении raw JSON-конфигов через `GeneralConfig` сначала санитизировать runtime-managed top-level секции (`api`, `stats`, `inbounds`), чтобы импорт не мог подменять локальные listener/API surface, который клиент должен контролировать сам.
+- Linux-голова `InvisibleGorilla-XRay.Linux` намеренно не дублирует UI: Avalonia views и code-behind линкуются из `InvisibleGorilla-XRay.Mac/`. При линковке `.axaml` файлов в `.csproj` обязательно одновременно включать их и в `<AvaloniaResource>` (для runtime XAML loading), и в `<AdditionalFiles>` с дочерним `<SourceItemGroup>AvaloniaXaml</SourceItemGroup>` — без этой метаданной Avalonia name source generator пропускает связанные XAML и сборка валится сериями `CS0103: Имя "<controlName>" не существует в текущем контексте` для всех `x:Name`-полей.
+- В Linux-голове linked code-behind остаётся в namespace `InvisibleGorillaXRay.Mac.Views`; не переименовывать namespace при копировании/линковке. Любая Linux-специфичная логика идёт в отдельные файлы (`Managers/`, `Handlers/`, `Factories/`).
+- `MacInstalledAppDiscovery` для Linux лежит в `InvisibleGorilla-XRay.Linux/Services/MacInstalledAppDiscovery.cs`, но под namespace `InvisibleGorillaXRay.Mac.Services`, чтобы линкованный App Rules UI цеплялся к Linux `.desktop`-парсеру без правок самих view-файлов.
+- Linux TUN режим всегда fail-closed: privileged шаги (`ip tuntap`, `ip route`, `resolvectl`) идут через `pkexec` (предпочтительно) или `sudo -n`; если elevation не удался — TUN не поднимается, а не «продолжаем без VPN».
+- На Linux GNOME proxy управляется только через `gsettings org.gnome.system.proxy*`. На не-GNOME окружениях `LinuxProxy` должен no-op'ом не ломая остальной flow; не пытаться поднять KDE/`environment.d` без отдельной задачи.
+- Для Linux сборок единственная поддерживаемая точка входа — `./build.sh` в корне репо. При добавлении новых runtime-зависимостей обновлять и список deps в `build.sh`, и заметки в `memory-bank/techContext.md`.
+- Linux app-rules сейчас только JSON-bridge (`LinuxAppRulesBridge`), без kernel enforcement (cgroups + `iptables -m owner`). Не помечать enforcement как готовый, пока не добавлен helper, реально применяющий правила на ядре.
+- Для Linux native bridge имя файла обязано быть `Libraries/libXRayCore.so`: `XRayCoreWrapper` на Linux ищет именно это имя. Не собирать/копировать его как `XRayCore.so`, иначе приложение соберётся, но упадёт при первом обращении к native Xray core.
+- Linux publish должен давать реальный single-file app binary `publish-linux/<rid>/InvisibleGorilla-XRay.Linux` (`PublishSingleFile=true`, `IncludeNativeLibrariesForSelfExtract=true`). Bundle-этап должен проверять именно этот исполняемый файл, а не наличие `.dll`.
+- Linux `tun2socks` нужно запускать по `InvisibleGorillaXRay.Values.Path.TUN_EXE` (`AppContext.BaseDirectory/TUN/tun2socks`), а не через относительный `./TUN/tun2socks`: `.desktop` запуск не гарантирует текущую рабочую директорию `bin/`.
+- Windows `build.ps1` должен читать требуемый .NET SDK из `global.json` и устанавливать/проверять именно эту версию (сейчас `8.0.419`). Нельзя считать установленный SDK 7.x достаточным: `dotnet restore` всё равно упадёт из-за SDK resolution по `global.json`.
+- Windows `build.ps1` по умолчанию должен restore/build/publish только `InvisibleGorilla-XRay/InvisibleGorilla-XRay.csproj`, а не весь `InvisibleGorilla-XRay.sln`: иначе на чистой Windows-машине сборка desktop-клиента требует Android workload из `InvisibleGorilla-XRay.Android.csproj`.

.gitattributes

@@ -0,0 +1,25 @@
+# Force LF for shell scripts and other POSIX-sensitive text files so CRLF
+# line endings never sneak in via Windows editors or `core.autocrlf=true`.
+# This is required for build.sh and any other *.sh helpers to run on Linux.
+*.sh              text eol=lf
+*.bash            text eol=lf
+build.sh          text eol=lf
+install.sh        text eol=lf
+run-igxray        text eol=lf
+
+# Linux desktop integration files are plain-text with LF endings.
+*.desktop         text eol=lf
+*.service         text eol=lf
+*.policy          text eol=lf
+
+# Avalonia / .NET text assets — keep cross-platform friendly defaults.
+*.cs              text
+*.csproj          text
+*.sln             text
+*.axaml           text
+*.xaml            text
+*.xml             text
+*.json            text
+*.yaml            text
+*.yml             text
+*.md              text

.github/FUNDING.yml

@@ -1 +1 @@
-custom: https://invisiblemanvpn.github.io/donation/
+custom: https://invisiblegorilla.github.io/donation/

.gitignore

@@ -1,6 +1,42 @@
 /Files
-/InvisibleMan-XRay/bin
-/InvisibleMan-XRay/obj
+/InvisibleGorilla-XRay/bin
+/InvisibleGorilla-XRay/obj
+/InvisibleGorilla-XRay.Mac/bin
+/InvisibleGorilla-XRay.Mac/obj
+/InvisibleGorilla-XRay.Android/bin
+/InvisibleGorilla-XRay.Android/obj
+/InvisibleGorilla-XRay.Linux/bin
+/InvisibleGorilla-XRay.Linux/obj
+/InvisibleGorilla-XRay.Linux/TUN
+/InvisibleGorilla.Core/bin
+/InvisibleGorilla.Core/obj
 *.dll
 *.dat
-*.exe
+*.exe
+*.dylib
+*.so
+
+# Build outputs
+/publish
+/publish-android
+/publish-linux
+/publish-macos
+/dist
+/dist-linux
+/dist-macos
+/.dotnet-sdk
+/.dotnet-home
+/.nuget
+/XRay-Wrapper/gorilla-xray
+.cursorrules
+memory-bank/activeContext.md
+memory-bank/progress.md
+memory-bank/systemPatterns.md
+.cursorrules
+.cursorrules
+/memory-bank
+.cursorrules
+/memory-bank
+.cursorrules
+/memory-bank
+/memory-bank

InvisibleGorilla-XRay.Android/AndroidManifest.xml

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <uses-sdk android:minSdkVersion="24" android:targetSdkVersion="34" />
+  <uses-permission android:name="android.permission.INTERNET" />
+  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE" />
+  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+  <queries>
+    <intent>
+      <action android:name="android.intent.action.MAIN" />
+      <category android:name="android.intent.category.LAUNCHER" />
+    </intent>
+  </queries>
+  <application
+    android:allowBackup="true"
+    android:icon="@drawable/ic_launcher_windows"
+    android:label="Invisible Gorilla XRay"
+    android:roundIcon="@drawable/ic_launcher_windows"
+    android:supportsRtl="true">
+    <provider
+      android:name="androidx.core.content.FileProvider"
+      android:authorities="io.invisiblegorilla.xray.fileprovider"
+      android:exported="false"
+      android:grantUriPermissions="true">
+      <meta-data
+        android:name="android.support.FILE_PROVIDER_PATHS"
+        android:resource="@xml/file_paths" />
+    </provider>
+  </application>
+</manifest>

InvisibleGorilla-XRay.Android/App.axaml

@@ -0,0 +1,8 @@
+<Application xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             x:Class="InvisibleGorillaXRay.Android.App"
+             RequestedThemeVariant="Dark">
+    <Application.Styles>
+        <FluentTheme />
+    </Application.Styles>
+</Application>

InvisibleGorilla-XRay.Android/App.axaml.cs

@@ -0,0 +1,86 @@
+using System;
+using Avalonia;
+using Avalonia.Controls.ApplicationLifetimes;
+using Avalonia.Markup.Xaml;
+using Avalonia.Threading;
+
+namespace InvisibleGorillaXRay.Android
+{
+    using InvisibleGorillaXRay.Android.Handlers;
+    using InvisibleGorillaXRay.Android.Managers;
+    using InvisibleGorillaXRay.Android.Platforms;
+    using InvisibleGorillaXRay.Android.Views;
+
+    public partial class App : Application
+    {
+        private AndroidAppManager? appManager;
+
+        public override void Initialize()
+        {
+            try
+            {
+                AvaloniaXamlLoader.Load(this);
+                InvisibleGorillaXRay.Core.DiagnosticLog.Write("AndroidApp", "App.Initialize: AvaloniaXamlLoader.Load completed");
+            }
+            catch (Exception ex)
+            {
+                InvisibleGorillaXRay.Core.DiagnosticLog.WriteException("AndroidApp.Initialize", ex);
+                throw;
+            }
+        }
+
+        public override void OnFrameworkInitializationCompleted()
+        {
+            try
+            {
+                if (ApplicationLifetime is ISingleViewApplicationLifetime singleView)
+                {
+                    InvisibleGorillaXRay.Core.DiagnosticLog.Write("AndroidApp", "Single view lifetime detected");
+
+                    AndroidAppStorage.ConfigureAppRoot();
+                    InvisibleGorillaXRay.Core.DiagnosticLog.Write(
+                        "AndroidApp",
+                        $"App root configured: {InvisibleGorillaXRay.Values.Directory.ROOT}");
+
+                    AndroidAppStorage.EnsureRuntimeAssets();
+                    InvisibleGorillaXRay.Core.DiagnosticLog.Write("AndroidApp", "Runtime assets prepared");
+
+                    appManager = new AndroidAppManager();
+                    InvisibleGorillaXRay.Core.DiagnosticLog.Write("AndroidApp", "App manager created");
+
+                    appManager.Initialize();
+                    InvisibleGorillaXRay.Core.DiagnosticLog.Write("AndroidApp", "App manager initialized");
+
+                    MainView mainView = new MainView();
+                    InvisibleGorillaXRay.Core.DiagnosticLog.Write("AndroidApp", "MainView constructed");
+
+                    singleView.MainView = mainView;
+                    InvisibleGorillaXRay.Core.DiagnosticLog.Write("AndroidApp", "MainView assigned to lifetime");
+
+                    Dispatcher.UIThread.Post(() =>
+                    {
+                        try
+                        {
+                            appManager.HandlersManager
+                                .GetHandler<AndroidLocalizationHandler>()
+                                .TryApplyCurrentLanguage();
+                            mainView.Setup(appManager);
+                            InvisibleGorillaXRay.Core.DiagnosticLog.Write("AndroidApp", "MainView setup completed");
+                        }
+                        catch (Exception ex)
+                        {
+                            InvisibleGorillaXRay.Core.DiagnosticLog.WriteException("AndroidApp.SetupPost", ex);
+                        }
+                    }, DispatcherPriority.ApplicationIdle);
+                }
+            }
+            catch (Exception ex)
+            {
+                InvisibleGorillaXRay.Core.DiagnosticLog.WriteException("AndroidApp", ex);
+                throw;
+            }
+
+            base.OnFrameworkInitializationCompleted();
+        }
+    }
+}