136 строк · 8 КиБ
AUDIT-STARTWINE.md
| 1 | # Замер StartWine 423 |
| 2 | |
| 3 | Снято 2026-09-02 с установки в `~/Games/StartWine` (1,7 ГБ). Это не оценка на |
| 4 | глаз, а измерения: всё ниже проверяемо командами из последнего раздела. |
| 5 | |
| 6 | ## Размер |
| 7 | |
| 8 | | Подсистема | Размер | Что это | |
| 9 | |---|---|---| |
| 10 | | `sw_menu.py` | 19 496 строк | весь GUI одним файлом | |
| 11 | | `sw_shaders.py` | 11 936 строк | работа с шейдерными кэшами | |
| 12 | | `sw_data.py` | 6 111 строк | пути, данные, состояние | |
| 13 | | `sw_func.py` | 4 842 строки | общие функции | |
| 14 | | `sw_term.py` | 4 104 строки | встроенный терминал и файловый менеджер | |
| 15 | | `sw_runlib` | 3 883 строки bash | **настоящий рантайм запуска** | |
| 16 | | `sw_dlm.py` | 2 314 строк | загрузчик, часть кода из legendary | |
| 17 | | `sw_crier.py` | 2 279 строк | диалоги, распаковка, скачивание | |
| 18 | | остальное | ~5 000 строк | widget, input, cast, opengl, pacurl | |
| 19 | | `sw_start` | 5,6 МБ | собранный бинарник, stripped | |
| 20 | |
| 21 | Итого около **56 000 строк Python и 3 900 строк bash**. |
| 22 | |
| 23 | GUI на GTK4 через PyGObject (`Gtk 4.0`, `Gdk 4.0`, `Gst 1.0`). |
| 24 | |
| 25 | ## Находки, из которых выросли решения |
| 26 | |
| 27 | ### 1. Конфиг игры — исполняемый bash |
| 28 | |
| 29 | `data/app_config/<игра>` это скрипт из строк `export SW_USE_XXX="значение"`, |
| 30 | который `sw_runlib` подключает через `source` перед запуском. У установленной |
| 31 | версии там 53 настройки. |
| 32 | |
| 33 | Следствия: нет схемы, нет валидации (опечатка в значении молча меняет |
| 34 | поведение), нет миграций между версиями, и конфиг игры в принципе может |
| 35 | выполнить произвольный код. **Главное следствие: пока конфиг — bash, лаунчер |
| 36 | обязан быть shell.** Это архитектурный замок, и снимать надо его первым. |
| 37 | |
| 38 | Решение: [`ADR-002`](DECISIONS.md) — TOML со схемой, bash читается только для |
| 39 | переноса. |
| 40 | |
| 41 | ### 2. Бэкап сохранений затирает предыдущий |
| 42 | |
| 43 | `create_backup()` в `sw_runlib:1401`: |
| 44 | |
| 45 | ```bash |
| 46 | mksquashfs "${SOURCE_DIR}" "${FULL_BACKUP_FILE}" -noappend -b 1M -comp zstd |
| 47 | ``` |
| 48 | |
| 49 | `SOURCE_DIR` — это `data/app_saves` целиком, `FULL_BACKUP_FILE` — один общий |
| 50 | файл `saves_backup.iso`. Раз в `SW_USE_BACKUP_UPDATE_PERIOD` дней (по умолчанию |
| 51 | 5) образ **пересобирается с нуля** и с флагом `-noappend` затирает предыдущий. |
| 52 | |
| 53 | То есть: копия одна на все игры, версий нет, и испорченное сохранение вытеснит |
| 54 | целое, если заметить позже пяти дней. Резервная копия, которая может уничтожить |
| 55 | то, что должна защищать. |
| 56 | |
| 57 | Бэкапы префиксов устроены так же — полный образ `pfx_<игра>.iso` через |
| 58 | `mksquashfs`, без дедупликации: двадцать префиксов с одинаковыми vcrun и DXVK |
| 59 | занимают место двадцати. |
| 60 | |
| 61 | Решение: [`ADR-003`](DECISIONS.md) — контентно-адресуемое хранилище с |
| 62 | версионными снапшотами. `/home` на btrfs, значит reflink доступен и снапшот |
| 63 | почти бесплатен. |
| 64 | |
| 65 | ### 3. Список версий Wine — строка с URL через пробел |
| 66 | |
| 67 | `data/scripts/wine_version.json`, 5 каналов (`wine_staging`, |
| 68 | `wine_steam_proton`, `wine_proton_ge`, `wine_staging_tkg`, `wine_proton_em`). |
| 69 | Значение канала — **одна строка**, в которой ссылки разделены пробелами, а не |
| 70 | список. Файл генерируется bash-ом в `sw_runlib:658`. |
| 71 | |
| 72 | Нет ни версий как данных, ни контрольных сумм, ни подписей, ни отката, ни |
| 73 | привязки версии к игре. Отсюда и отсутствие автообновлений: на такой структуре |
| 74 | их безопасно не построить. |
| 75 | |
| 76 | Решение: [`ADR-004`](DECISIONS.md) — подписанный манифест, дифф-загрузка, |
| 77 | закрепление версии за игрой. |
| 78 | |
| 79 | ### 4. Epic Games Store — два несвязанных пути |
| 80 | |
| 81 | - `sw_dlm.py` содержит код на основе [legendary](https://github.com/derrod/legendary) |
| 82 | и обращается к Epic напрямую (виден `User-Agent: EpicGamesLauncher/11.0.1`), |
| 83 | но вытаскивает только библиотеку: `get_epic_list()` читает `items.json`; |
| 84 | - `sw_runlib:2378` отдельно качает готовый `EpicGames.tar.xz` с настоящим |
| 85 | Windows-лончером Epic и распаковывает в префикс `pfx_EpicGamesLauncher`. |
| 86 | |
| 87 | Пути не связаны между собой. Отсюда ровно то, что видно в интерфейсе: список |
| 88 | игр есть, магазина и настроек аккаунта нет. |
| 89 | |
| 90 | Решение: [`ADR-005`](DECISIONS.md) — библиотека нативно, магазин через webview |
| 91 | на настоящий сайт. |
| 92 | |
| 93 | ### 5. Всё в одной папке |
| 94 | |
| 95 | `data/` содержит вперемешку: `pfx`, `wine`, `app_saves`, `app_config`, |
| 96 | `pfx_backup`, `tmp`, `img`, `runtime`, `tools`, `scripts`. Не XDG. |
| 97 | |
| 98 | Следствие: нельзя забэкапить пользовательские данные, не забрав гигабайты кэша, |
| 99 | и нельзя почистить кэш, не рискуя настройками. |
| 100 | |
| 101 | Решение: раскладка по XDG с разделением по ценности данных — реализовано в |
| 102 | `chl-core/src/paths.rs`. |
| 103 | |
| 104 | ## Что взять, а не выбрасывать |
| 105 | |
| 106 | Замер — не повод считать старый код плохим. Ценное в нём: |
| 107 | |
| 108 | - **53 настройки — это карта того, что реально нужно для запуска игр.** Каждая |
| 109 | появилась из чьей-то сломанной игры. Реестр в `settings.rs` перенесён именно |
| 110 | оттуда, с выверкой семантики по `sw_runlib`. |
| 111 | - `data/app_patches/*.reg` — готовые обходы под конкретные игры |
| 112 | (DeadSpace2, Dungeon Siege 2, EveLauncher, переключение CSMT и hidraw). |
| 113 | - Логика `SW_USE_D3D_PLUGINS`: подмена d3dx9_24…d3dx9_43 с симметричным |
| 114 | обратным оверрайдом при выключении — неочевидная деталь, которую легко |
| 115 | потерять при наивном переписывании. |
| 116 | - Знание, что именно нужно подложить для BattlEye и EAC. |
| 117 | |
| 118 | ## Как перепроверить |
| 119 | |
| 120 | ```bash |
| 121 | cd ~/Games/StartWine/data/scripts |
| 122 | wc -l *.py sw_runlib | sort -rn # размеры |
| 123 | grep -c 'export SW_USE' ../app_config/StartWine |
| 124 | sed -n '1401,1420p' sw_runlib # create_backup |
| 125 | sed -n '2378,2405p' sw_runlib # установка лончера Epic |
| 126 | python3 -c "import json; print(list(json.load(open('wine_version.json'))))" |
| 127 | ``` |
| 128 | |
| 129 | Из нового кода то же самое: |
| 130 | |
| 131 | ```bash |
| 132 | cd code |
| 133 | cargo run -p chl-cli -- legacy info |
| 134 | cargo run -p chl-cli -- legacy verify |
| 135 | ``` |
| 136 |