Project Chimera
Меню

Исходники

310 строк · 26 КиБ

code/crates/chl-gui/FILE-MANAGER-DECISION.md

1# Файловый менеджер: порт, делегирование или узкий срез — и почему не порт
2
3Аудит нашёл, что у StartWine есть встроенный GTK4-файловый менеджер
4(`sw_menu_file_manager.py`, 6 850 строк — самый большой отдельный модуль
5StartWine, «модуль 12» из 12 в плане модуляризации
6`~/Projects/startwine-optimize/MODULARIZATION-PLAN.md`), а у
7chimera-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
41Files/Nautilus-подобной сетки, который можно открыть на любом Unix-пути,
42и который при этом ничего не знает о том, что где-то внутри лежит
43Windows-дерево с буквами дисков. Единственная функция с «драйвами» в
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
531. **Просмотр каталогов** — три режима (сетка/список/колонки через
54 `GtkColumnView` с фабриками сортировки по типу/размеру/владельцу/дате),
55 хлебные крошки, поиск, скрытые файлы.
562. **Операции над файлами** — вырезать/копировать/вставить/переименовать/
57 ссылка/**сжать** (zip, tar.xz, tar.zst — только стандартной
58 `zipfile`/`tarfile`)/удалить-в-корзину/свойства/allocated-size. Это
59 ровно тот набор, что есть в любом файловом менеджере рабочего стола.
603. **Drag&drop** между панелями и с/на хост.
614. **Встроенный VTE-терминал** и **медиаплеер** (`Gst`) — открываются в том
62 же revealer'е, что и список смонтированных томов; это не файловый
63 браузер, а отдельные виджеты, которые модуль тоже тащит.
645. **Сетка «приложений»** (`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 уже решает её лучше, чем
108StartWine когда-либо решал.
109
110**2. Паттерн «делегировать хостовому файловому менеджеру» уже в проде,
111дважды.** `game_page.rs:508-529`, функция `open_row`:
112
113```rust
114let uri = format!("file://{}", path.display());
115row.connect_activated(move |r| {
116 if gtk::gio::AppInfo::launch_default_for_uri(&uri, None::<&gtk::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/
232vkBasalt, эстетика интерфейса, унаследованная от 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бы иметь встроенный браузер именно в игровом лаунчере — понимания
258Wine-путей и распаковки архивов для модов. Первое chimera-launcher уже
259решает лучше через настоящий `explorer.exe`; второе не решает никто,
260включая референс. При таком раскладе Вариант В не покупает на свои
2611 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-модуле нет — ноль совпадений:
281grep -n "drive_c\|dosdevices\|WINEPREFIX" \
282 /home/fanchji/Games/StartWine/data/scripts/sw_menu_file_manager.py
283
284# default_dir — это $HOME, не префикс, и настраивается отдельно:
285grep -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:
289grep -n "archive_type\|_compress(" \
290 /home/fanchji/Games/StartWine/data/scripts/sw_menu_file_manager.py
291
292# двойной клик по файлу уходит в системный обработчик по умолчанию,
293# то же самое, что дал бы xdg-open:
294sed -n '3368,3376p' /home/fanchji/Games/StartWine/data/scripts/sw_menu_file_manager.py
295
296# «модуль 12» из 12 — файловый менеджер самый большой и последний
297# в модуляризации StartWine:
298grep -o "модуль [0-9]*" /home/fanchji/Games/StartWine/data/scripts/sw_menu.py | sort -u
299
300# паттерн "делегировать хостовому файловому менеджеру" уже в проде дважды:
301grep -n "open_row(" /home/fanchji/Projects/chimera-launcher/code/crates/chl-gui/src/game_page.rs
302
303# размер всего GUI-крейта chimera-launcher сегодня — меньше одного модуля StartWine:
304wc -l /home/fanchji/Projects/chimera-launcher/code/crates/chl-gui/src/*.rs | tail -1
305
306# ни один пункт фазы 5 ROADMAP не про файловый менеджер, гамепад — отдельный,
307# ещё не начатый пункт:
308sed -n '295,340p' /home/fanchji/Projects/chimera-launcher/ROADMAP.md
309```
310