[2026-06-21] taiga-vault: family/how-to/htpc-emulators-setup.md personal/agent/Phase 2 — Approval Reactions.md personal/creative/songs/Рыба.md personal/projects/balda/balda-valera.md personal/projects/balda/fast-rlm-integration.md personal/projects/hermes/hermes-gateway-stream-consumer-text-loss.md personal/projects/hermes/no-edit-segment-send-bug.md personal/projects/zulip-router-approval-reactions.md personal/projects/zulip-router.md

family/how-to/htpc-emulators-setup.md

@@ -440,6 +440,34 @@ CACHE="$HOME/.var/app/org.libretro.RetroArch/config/retroarch/system/Mupen64plus
 
 → Подробно: [[switch-emulation-rom-infra]]
 
+### ⚠️ Текущий статус — 20.06.2026
+
+**AppImage Ryujinx Canary 1.3.287** (standalone, не flatpak) обнаружен в `/home/bazzite/Applications/publish/` — приоритетнее flatpak'а (1.3.3). Launcher `ryujinx.sh` сначала ищет AppImage, находит его, и запускает **Avalonia GUI бинарник** (не headless, `libSDL3.so` рядом есть, но нет `Ryujinx.Headless.SDL3`/`SDL2`).
+
+**Из 27 Switch игр работают 4:**
+- Donkey Kong Country Tropical Freeze ✅
+- Super Mario Odyssey ✅
+- Mario Kart 8 Deluxe ✅
+- The Legend of Zelda: Breath of the Wild ✅
+
+**Остальные 23 — открывают пустое окно Ryujinx.** В логе — только инициализация, без `LoadGuestApplication` или с обрывом на `Loading as NSP/NSZ`.
+
+**VDF-записи (shortcuts.vdf):** у всех Switch игр идентичны — `StartDir`, `tags`, `Exe`, `LaunchOptions` заполнены.
+
+**Логи:**
+- Carnivores Dinosaur Hunt: `ArgumentOutOfRangeException` в `CheckLaunchState()` (крах до загрузки ROM)
+- Hollow Knight: обрыв после `Loading as NSP` без `Loading rtld.../main...`
+- Василиса: только инициализация, даже `LoadGuestApplication` нет
+
+**Причина:** Баг Ryujinx Canary 1.3.287 — **`ArgumentOutOfRangeException` в `CheckLaunchState()` при загрузке ряда ROM**. Игры, которые не триггерят этот баг (первые 4), работают. Остальные — падают. Это известная проблема Ryujinx command-line launching — обсуждалась на LaunchBox форуме (июнь 2024), фикс в PR #7123 и #7116.
+
+**План починки:**
+1. Обновить AppImage Ryujinx Canary до версии новее 1.3.295 (где пофикшен `CheckLaunchState`)
+2. Текущая AppImage 1.3.287 переименована в `.bak`, чтобы лаунчер использовал flatpak 1.3.3 (стабильный, но тоже может не работать)
+3. Прямые download ссылки на AppImage через `ryujinx.app` ведут на UpdateServer (Kestrel), который возвращает 418 для внешних запросов. Нужно скачивать через браузер на HTPC или найти зеркало
+
+**Run скрипт:** добавлено логирование в `~/ryujinx-launch.log` — PWD, ARGS, EXE, EXIT_CODE.
+
 ---
 
 ## Геймпады — общая информация