310 строк · 26 КиБ
code/crates/chl-gui/FILE-MANAGER-DECISION.md
| 1 | # Файловый менеджер: порт, делегирование или узкий срез — и почему не порт |
| 2 | |
| 3 | Аудит нашёл, что у StartWine есть встроенный GTK4-файловый менеджер |
| 4 | (`sw_menu_file_manager.py`, 6 850 строк — самый большой отдельный модуль |
| 5 | StartWine, «модуль 12» из 12 в плане модуляризации |
| 6 | `~/Projects/startwine-optimize/MODULARIZATION-PLAN.md`), а у |
| 7 | chimera-launcher из файловых возможностей — только кнопка «Проводник», |
| 8 | запускающая `explorer.exe` изнутри Wine (`crates/chl-gui/src/game_page.rs`, |
| 9 | `crates/chl-wine/src/sandbox.rs`). Аудит также нашёл, что **решения о том, |
| 10 | нужен ли свой файловый менеджер, нигде нет** — ни в `ROADMAP.md`, ни в |
| 11 | `DECISIONS.md` (список ADR обрывается на ADR-011, ни один не про файловый |
| 12 | менеджер), ни в `AUDIT-STARTWINE.md`. Единственное близкое упоминание — |
| 13 | `ROADMAP.md` про то, что открытие `explorer` не входит в список действий |
| 14 | перед которыми делается автоснимок, потому что «файловый менеджер на |
| 15 | префиксе не опаснее уже существующей кнопки «Открыть префикс»» — это |
| 16 | замечание про безопасность автоснимков, не решение о том, строить ли |
| 17 | свой файловый менеджер. |
| 18 | |
| 19 | Это design-документ по образцу `chl-wine/CAS-DESIGN.md`: находки сначала, |
| 20 | рекомендация — с обоснованием, не нейтральным списком опций. Кода в рамках |
| 21 | этого прохода не написано ни строки — задание прямо это исключает, чтобы |
| 22 | не смешать «разобрался в вопросе» с «уже выбрал подход» до того, как |
| 23 | владелец увидел находки. |
| 24 | |
| 25 | ## Что файловый менеджер StartWine реально делает |
| 26 | |
| 27 | ### Это универсальный десктопный файловый менеджер, не Wine-осведомлённый |
| 28 | |
| 29 | Самая важная находка этого прохода: |
| 30 | |
| 31 | ``` |
| 32 | $ grep -n "drive_c\|dosdevices\|WINEPREFIX" sw_menu_file_manager.py |
| 33 | (пусто — ни одного совпадения) |
| 34 | ``` |
| 35 | |
| 36 | Модуль ничего не знает про буквы дисков Wine, `drive_c` или структуру |
| 37 | префикса. Стартовый каталог — `swgs.default_dir`, который по умолчанию |
| 38 | равен `Path.home()` (`sw_data.py:429`) и настраивается человеком отдельно |
| 39 | в глобальных настройках (`sw_menu_settings_global.py:536`). Это не |
| 40 | «файловый менеджер префикса» — это встроенный клон GNOME |
| 41 | Files/Nautilus-подобной сетки, который можно открыть на любом Unix-пути, |
| 42 | и который при этом ничего не знает о том, что где-то внутри лежит |
| 43 | Windows-дерево с буквами дисков. Единственная функция с «драйвами» в |
| 44 | названии (`on_drive`, `update_gvolume`) — это список **смонтированных |
| 45 | хостовых томов** через `GVolumeMonitor` (и `psutil.disk_partitions()` как |
| 46 | фолбэк) — то есть USB-флешки и разделы диска, а не `C:`/`Z:` Wine. |
| 47 | |
| 48 | ### Компоненты: браузер — это меньшая часть модуля |
| 49 | |
| 50 | По функциям (`grep -n "^def "`, 200+ верхнеуровневых определений) модуль |
| 51 | на самом деле — это пять разных подсистем в одном файле: |
| 52 | |
| 53 | 1. **Просмотр каталогов** — три режима (сетка/список/колонки через |
| 54 | `GtkColumnView` с фабриками сортировки по типу/размеру/владельцу/дате), |
| 55 | хлебные крошки, поиск, скрытые файлы. |
| 56 | 2. **Операции над файлами** — вырезать/копировать/вставить/переименовать/ |
| 57 | ссылка/**сжать** (zip, tar.xz, tar.zst — только стандартной |
| 58 | `zipfile`/`tarfile`)/удалить-в-корзину/свойства/allocated-size. Это |
| 59 | ровно тот набор, что есть в любом файловом менеджере рабочего стола. |
| 60 | 3. **Drag&drop** между панелями и с/на хост. |
| 61 | 4. **Встроенный VTE-терминал** и **медиаплеер** (`Gst`) — открываются в том |
| 62 | же revealer'е, что и список смонтированных томов; это не файловый |
| 63 | браузер, а отдельные виджеты, которые модуль тоже тащит. |
| 64 | 5. **Сетка «приложений»** (`on_startapp_page`, `add_startapp_page`, |
| 65 | `show_shortcut_context` — самая длинная функция контекстного меню в |
| 66 | файле, 227 строк) — это редактор закреплённых ярлыков StartWine, вообще |
| 67 | не про просмотр файлов, а про другую фичу, которая просто живёт в этом |
| 68 | же модуле после модуляризации. |
| 69 | |
| 70 | ### Архивы: сжимает, но не распаковывает |
| 71 | |
| 72 | Проверено явно — единственные упоминания архивов в файле: |
| 73 | |
| 74 | ``` |
| 75 | $ grep -n "archive_type\|zst_compress\|tar_compress\|zip_compress" sw_menu_file_manager.py |
| 76 | # только on_file_compress / zst_compress / tar_compress / zip_compress — |
| 77 | # все три создают архив, ни один не распаковывает |
| 78 | ``` |
| 79 | |
| 80 | Функции извлечения архива в файле нет вообще. Двойной клик по `.zip` |
| 81 | уходит в `on_file_open` → `Gtk.FileLauncher.launch()` (`sw_menu_file_manager.py:3368-3376`) |
| 82 | — то есть в системный обработчик по умолчанию через GIO, **то же самое**, |
| 83 | что получилось бы, открыв тот же файл в GNOME Files или через `xdg-open`. |
| 84 | Для сценария «поставить мод из архива» встроенный файловый менеджер не |
| 85 | даёт вообще ничего сверх внешнего — оба делегируют распаковку одному и |
| 86 | тому же системному механизму. |
| 87 | |
| 88 | ### Итог характеристики |
| 89 | |
| 90 | То немногое, что специфично именно для игрового лаунчера в этом модуле — |
| 91 | ничего. Всё содержимое — либо (а) типовые операции файлового менеджера, |
| 92 | которые уже есть в любом DE (копировать/переименовать/удалить/сжать/ |
| 93 | свойства), либо (б) фичи, не относящиеся к просмотру файлов вовсе |
| 94 | (терминал, медиаплеер, редактор ярлыков, список хостовых томов). Ни |
| 95 | осознания Wine-путей, ни помощи с модами (распаковка) в нём нет. |
| 96 | |
| 97 | ## Что уже есть в chimera-launcher |
| 98 | |
| 99 | Два факта, которые сильно сдвигают расчёт: |
| 100 | |
| 101 | **1. Wine-осведомлённый просмотр уже есть — и это делает его лучше, а не |
| 102 | хуже StartWine.** Кнопка «Проводник» на странице игры (`game_page.rs:76`, |
| 103 | подпись «диск C: изнутри Windows») запускает настоящий `explorer.exe` |
| 104 | внутри Wine. Это буквальный Windows Explorer с реальным пониманием |
| 105 | `C:`/`Z:`/UNC-путей — то, чего у StartWine-модуля нет в принципе (см. |
| 106 | выше, ноль строк про `drive_c`/`dosdevices`). Если задача — увидеть |
| 107 | префикс «как видит его игра», chimera-launcher уже решает её лучше, чем |
| 108 | StartWine когда-либо решал. |
| 109 | |
| 110 | **2. Паттерн «делегировать хостовому файловому менеджеру» уже в проде, |
| 111 | дважды.** `game_page.rs:508-529`, функция `open_row`: |
| 112 | |
| 113 | ```rust |
| 114 | let uri = format!("file://{}", path.display()); |
| 115 | row.connect_activated(move |r| { |
| 116 | if gtk::gio::AppInfo::launch_default_for_uri(&uri, None::<>k::gio::AppLaunchContext>) |
| 117 | .is_err() |
| 118 | { window::toast(r, "не удалось открыть файловый менеджер"); } |
| 119 | }); |
| 120 | ``` |
| 121 | |
| 122 | Используется для «Открыть папку игры» (`:429`) и «Открыть префикс» |
| 123 | (`:436`) — то есть открыть хостовый Unix-каталог в системном файловом |
| 124 | менеджере пользователя (GNOME Files, Dolphin, что угодно, что |
| 125 | зарегистрировано как `inode/directory`-обработчик). Комментарий рядом с |
| 126 | этим кодом (`:421-422`) уже формулирует ровно тот сценарий, который и |
| 127 | поставлен в задании этого прохода: «за чем чаще всего лезут в файловый |
| 128 | менеджер: посмотреть логи, положить мод, найти сохранение». Это Вариант |
| 129 | Б ниже — уже написан, работает, использован дважды. |
| 130 | |
| 131 | Единственный практический зазор сегодня: «Открыть префикс» открывает |
| 132 | корень префикса (`pfx_default/`), а не `drive_c` — за модом или сохранением |
| 133 | человеку нужен ещё один клик внутрь `drive_c`. Тривиально устранимо |
| 134 | добавлением ещё одной строки `open_row("Открыть drive_c", &prefix_dir.join("drive_c"))` |
| 135 | по тому же паттерну, без новой инфраструктуры. |
| 136 | |
| 137 | ## Три варианта |
| 138 | |
| 139 | ### А. Полный порт StartWine-модуля |
| 140 | |
| 141 | Перенести всю функциональность `sw_menu_file_manager.py` на GTK4-rs. |
| 142 | |
| 143 | - **Стоимость.** 6 850 строк Python с PyGObject → Rust с `gtk4-rs`/`libadwaita` — |
| 144 | не построчный перевод (Rust многословнее для того же самого: |
| 145 | builder-паттерны, явные типы, явное управление временем жизни замыканий |
| 146 | вместо GC), реалистично **дороже**, чем 6 850 строк, не дешевле. Для |
| 147 | сравнения: **весь** GUI chimera-launcher сегодня — 6 003 строки на 13 |
| 148 | файлов (`code/crates/chl-gui/src/*.rs`), самый большой из них — |
| 149 | `game_page.rs` на 1 353. Один этот модуль почти удвоил бы размер всего |
| 150 | GUI-крейта ради одной фичи. |
| 151 | - **Что даёт.** Просмотр в сетке/списке/колонках, drag&drop, копирование/ |
| 152 | переименование/сжатие/корзина, встроенный терминал, медиаплеер, монтирование |
| 153 | томов — то есть переизобретение desktop environment внутри лаунчера. |
| 154 | - **Что не даёт нового.** Wine-осведомлённости (её нет и у оригинала — |
| 155 | см. выше), распаковки архивов (тоже нет у оригинала). |
| 156 | - **Эксплуатационное бремя.** Проект уже прошёл через опыт «сколько стоит |
| 157 | большая GTK-поверхность» — именно ради этого StartWine потребовалась |
| 158 | отдельная модуляризация на 12 модулей (`startwine-optimize`), и файловый |
| 159 | менеджер — самый большой и последний из них. chimera-launcher взял бы на |
| 160 | себя тот же класс поверхности (drag&drop-контроллеры, три вида |
| 161 | отображения с отдельными GtkColumnView-фабриками, VTE, GStreamer) с нуля, |
| 162 | без миграции старого кода — то есть с тем же долгосрочным бременем |
| 163 | сопровождения, но без экономии на переносе, которая обычно оправдывает |
| 164 | порт. |
| 165 | |
| 166 | ### Б. Делегировать внешнему файловому менеджеру (расширить существующий паттерн) |
| 167 | |
| 168 | Ничего нового не строить — добавить ещё одну-две строки `open_row` по |
| 169 | образцу уже существующих (`game_page.rs:429,436`): «Открыть drive_c», |
| 170 | возможно «Открыть папку модов» там, где для игры известна такая папка. |
| 171 | |
| 172 | - **Стоимость.** Единицы строк, тот же уже проверенный код |
| 173 | (`Gio::AppInfo::launch_default_for_uri`). Не новая инфраструктура — |
| 174 | расширение существующей. |
| 175 | - **Что теряется относительно StartWine-модуля.** Встроенность (отдельное |
| 176 | окно вместо панели внутри лаунчера) и то немногое, что StartWine делает |
| 177 | лучше типового файлового менеджера — а этого, как показано выше, попросту |
| 178 | нет: сжатие через `zipfile`/`tarfile` есть у любого файлового менеджера |
| 179 | не хуже, распаковки нет ни там, ни тут одинаково. |
| 180 | - **Что теряется в теории, но не на практике.** Можно было бы предположить, |
| 181 | что внешний файловый менеджер «не понимает» Wine-путей и покажет голый |
| 182 | Unix-путь без семантики буквы диска — это правда, но это ровно то же |
| 183 | самое, что показывает и сам StartWine-модуль (он тоже открывается на |
| 184 | Unix-пути `default_dir`, без какого-либо перевода в `C:\...`). Разницы в |
| 185 | Wine-осведомлённости между «встроенным» и «внешним» просмотром — ноль, |
| 186 | потому что у встроенного её никогда и не было. Единственный компонент |
| 187 | chimera-launcher, который эту семантику действительно даёт — это Wine's |
| 188 | собственный `explorer.exe`, уже реализованный отдельно и без отношения |
| 189 | к этому решению. |
| 190 | - **Бремя сопровождения.** Практически нулевое — это чужой процесс, |
| 191 | обновляется и чинится вне проекта. |
| 192 | |
| 193 | ### В. Узкий встроенный браузер (только просмотр `drive_c` + открыть/показать в …) |
| 194 | |
| 195 | Гипотетический маленький модуль: список файлов в сетке или списке, вход в |
| 196 | подкаталоги, «открыть» через тот же `Gio::AppInfo`, без вырезать/ |
| 197 | копировать/переименовать/сжать/корзины/drag&drop/терминала/медиаплеера/ |
| 198 | монтирования томов. |
| 199 | |
| 200 | - **Оценка размера.** Минимально необходимый костяк из StartWine-модуля — |
| 201 | модель каталога и сортировка (`get_dir_list`, `get_file_info`, |
| 202 | `update_grid_view`, `sort_func`, `on_files`, `update_path`, |
| 203 | примерно `591–1244`, ~650 строк), рендеринг элементов сетки/списка |
| 204 | (`file_factory_bind`, `cb_factory_setup/bind`, `set_*_image`, |
| 205 | примерно `5302–6119`, ~390 строк без колоночных фабрик) и открытие файла |
| 206 | (`on_file_open`/`on_file_run`, ~120 строк) — это уже **~1 200 строк |
| 207 | Python**-эквивалента только на просмотр без единой операции записи. На |
| 208 | Rust/GTK4-rs с нуля, с учётом многословности builder-API — реалистично |
| 209 | **1 500–2 500 строк**, то есть по размеру сопоставимо с самым большим |
| 210 | существующим файлом GUI (`game_page.rs`, 1 353) или больше, ради |
| 211 | фичи, которая по возможностям — подмножество того, что `xdg-open` |
| 212 | делегирует бесплатно. |
| 213 | - **Что даёт сверх Варианта Б.** Панель внутри лаунчера вместо отдельного |
| 214 | окна — то есть не приходится переключаться между приложениями. Это |
| 215 | единственный реальный выигрыш. |
| 216 | - **Что не даёт сверх Варианта Б.** Распаковки архивов для модов (то, ради |
| 217 | чего его хотелось бы завести) — StartWine её тоже не делает, писать её |
| 218 | с нуля означало бы делать то, чего нет даже в референсной реализации. |
| 219 | Wine-осведомлённости — снова нет, потому что задача «браузер по |
| 220 | `drive_c`» — это Unix-путь `.../drive_c`, а не что-то, что понимает |
| 221 | буквы дисков сильнее, чем уже понимает `explorer.exe`. |
| 222 | - **Бремя сопровождения.** Меньше, чем Вариант А, но не нулевое: свой |
| 223 | GtkGridView/GtkListView + фабрики рендеринга + модель каталога — |
| 224 | постоянный код, который нужно тестировать и чинить при апдейтах GTK4, |
| 225 | ради экономии одного переключения окна. |
| 226 | |
| 227 | ## Проверка по заявленным приоритетам сессии |
| 228 | |
| 229 | Геймпад/Big Picture-навигация (`ROADMAP.md`, фаза 4, ещё не готова — |
| 230 | «[ ] Big Picture с навигацией геймпадом», и отдельно фаза 5 п. 8 |
| 231 | «Нативный слой геймпада» — «самая тяжёлая» фича), точность MangoHud/ |
| 232 | vkBasalt, эстетика интерфейса, унаследованная от StartWine, Steam Deck — |
| 233 | ни один из трёх вариантов не продвигает ни один из этих пунктов. Файловый |
| 234 | менеджер, в любой форме, — ортогональная ось. Отдельно стоит заметить: |
| 235 | ни встроенный браузер (ни у StartWine, ни в гипотетическом Варианте В), ни |
| 236 | внешний файловый менеджер хоста сегодня не controller-first — оба |
| 237 | рассчитаны на клавиатуру/мышь. Если геймпад-навигация станет реальным |
| 238 | приоритетом, она не решается выбором между А/Б/В — это отдельная, более |
| 239 | крупная работа (тот самый п. 8 фазы 5), которая пока не начата ни для |
| 240 | одного из трёх вариантов. |
| 241 | |
| 242 | ## Рекомендация |
| 243 | |
| 244 | **Вариант Б: расширить уже существующий паттерн `open_row`, ничего не |
| 245 | строить с нуля.** Конкретно — добавить строку «Открыть drive_c» рядом с |
| 246 | уже существующими «Открыть папку игры»/«Открыть префикс» |
| 247 | (`game_page.rs:429,436`), нацеленную на `prefix_dir.join("drive_c")`. |
| 248 | Это не полумера, а самый защитимый вывод из находок этого прохода: |
| 249 | |
| 250 | Решающий довод — фактическая ценность StartWine-модуля для игрового |
| 251 | сценария оказалась намного ниже, чем предполагает его размер. 6 850 |
| 252 | строк создают впечатление глубокой, специфичной для геймдева |
| 253 | функциональности, но по факту это (1) типовой набор операций рабочего |
| 254 | стола, который любой DE уже даёт бесплатно, плюс (2) три несвязанные с |
| 255 | просмотром файлов подсистемы (терминал, медиаплеер, редактор ярлыков), |
| 256 | плюс (3) полное отсутствие как раз тех двух вещей, ради которых хотелось |
| 257 | бы иметь встроенный браузер именно в игровом лаунчере — понимания |
| 258 | Wine-путей и распаковки архивов для модов. Первое chimera-launcher уже |
| 259 | решает лучше через настоящий `explorer.exe`; второе не решает никто, |
| 260 | включая референс. При таком раскладе Вариант В не покупает на свои |
| 261 | 1 500–2 500 строк ничего, чего не даёт уже написанный и дважды |
| 262 | используемый `open_row` за пределами удобства «панель, а не окно» — а |
| 263 | Вариант А добавляет тот же нулевой выигрыш при цене, которая одна |
| 264 | способна удвоить весь GUI-крейт. Ни А, ни В не оправданы находками; они |
| 265 | были бы оправданы, если бы аудит нашёл в StartWine что-то специфичное |
| 266 | именно для установки модов, чего нет у стандартного файлового |
| 267 | менеджера — но такого не нашлось. |
| 268 | |
| 269 | Если позже появится факт, а не предположение (например, владелец |
| 270 | регулярно ловит себя на желании drag&drop мода прямо из скачанного |
| 271 | архива в `drive_c/…/Mods` без промежуточного окна) — это будет конкретный, узкий |
| 272 | довод для Варианта В, оценённый заново на основе того факта, а не общего |
| 273 | «хорошо бы иметь файловый менеджер». Сейчас такого факта нет — есть один |
| 274 | абстрактный пункт аудита без единого зафиксированного случая, когда |
| 275 | внешнего файлового менеджера или `explorer.exe` не хватило. |
| 276 | |
| 277 | ## Как перепроверить |
| 278 | |
| 279 | ```bash |
| 280 | # Wine-осведомлённости в StartWine-модуле нет — ноль совпадений: |
| 281 | grep -n "drive_c\|dosdevices\|WINEPREFIX" \ |
| 282 | /home/fanchji/Games/StartWine/data/scripts/sw_menu_file_manager.py |
| 283 | |
| 284 | # default_dir — это $HOME, не префикс, и настраивается отдельно: |
| 285 | grep -n "default_dir" /home/fanchji/Games/StartWine/data/scripts/sw_data.py \ |
| 286 | /home/fanchji/Games/StartWine/data/scripts/sw_menu.py |
| 287 | |
| 288 | # распаковки архивов нет — только сжатие через stdlib: |
| 289 | grep -n "archive_type\|_compress(" \ |
| 290 | /home/fanchji/Games/StartWine/data/scripts/sw_menu_file_manager.py |
| 291 | |
| 292 | # двойной клик по файлу уходит в системный обработчик по умолчанию, |
| 293 | # то же самое, что дал бы xdg-open: |
| 294 | sed -n '3368,3376p' /home/fanchji/Games/StartWine/data/scripts/sw_menu_file_manager.py |
| 295 | |
| 296 | # «модуль 12» из 12 — файловый менеджер самый большой и последний |
| 297 | # в модуляризации StartWine: |
| 298 | grep -o "модуль [0-9]*" /home/fanchji/Games/StartWine/data/scripts/sw_menu.py | sort -u |
| 299 | |
| 300 | # паттерн "делегировать хостовому файловому менеджеру" уже в проде дважды: |
| 301 | grep -n "open_row(" /home/fanchji/Projects/chimera-launcher/code/crates/chl-gui/src/game_page.rs |
| 302 | |
| 303 | # размер всего GUI-крейта chimera-launcher сегодня — меньше одного модуля StartWine: |
| 304 | wc -l /home/fanchji/Projects/chimera-launcher/code/crates/chl-gui/src/*.rs | tail -1 |
| 305 | |
| 306 | # ни один пункт фазы 5 ROADMAP не про файловый менеджер, гамепад — отдельный, |
| 307 | # ещё не начатый пункт: |
| 308 | sed -n '295,340p' /home/fanchji/Projects/chimera-launcher/ROADMAP.md |
| 309 | ``` |
| 310 |