Project Chimera
Меню

Исходники

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
23GUI на 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
46mksquashfs "${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` дней (по умолчанию
515) образ **пересобирается с нуля** и с флагом `-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
121cd ~/Games/StartWine/data/scripts
122wc -l *.py sw_runlib | sort -rn # размеры
123grep -c 'export SW_USE' ../app_config/StartWine
124sed -n '1401,1420p' sw_runlib # create_backup
125sed -n '2378,2405p' sw_runlib # установка лончера Epic
126python3 -c "import json; print(list(json.load(open('wine_version.json'))))"
127```
128
129Из нового кода то же самое:
130
131```bash
132cd code
133cargo run -p chl-cli -- legacy info
134cargo run -p chl-cli -- legacy verify
135```
136