672 строк · 62 КиБ
ROADMAP.md
| 1 | # План работ |
| 2 | |
| 3 | Вес — относительная трудоёмкость, не календарь. Каждая фаза заканчивается |
| 4 | проверяемым критерием, а не ощущением «вроде готово». |
| 5 | |
| 6 | Полная версия с обоснованиями: |
| 7 | [артефакт «StartWine на Rust»](https://claude.ai/code/artifact/28f02c45-3ae2-4023-8c0d-88997705cde1). |
| 8 | |
| 9 | ## Сводка |
| 10 | |
| 11 | | Фаза | Что | Вес | Состояние | |
| 12 | |---|---|---|---| |
| 13 | | 0 | Ядро и паритет запуска | фундамент | готово, кроме бэкапа сохранений (см. фазу 1) | |
| 14 | | 1 | Хранилище префиксов и версионные бэкапы | крупная | базовые снимки готовы | |
| 15 | | 2 | Обновления Wine и библиотек | средняя | манифест+подпись+хэш готовы (без продакшн-ключа), закрепление версии и patch notes закрыты, дифф-загрузка и самообновление — design-only | |
| 16 | | 3 | Steam и Epic Games Store | крупная | Steam и GOG готовы, Epic — только библиотека | |
| 17 | | 4 | GUI на GTK4 | крупная | готов, включая экран глобальных настроек | |
| 18 | | 5 | Фичи-дифференциаторы | по одной | геймпад начат (пункт 8), остальное не начато | |
| 19 | | 6 | Долги и уроки из разбора GameHub | средняя | план составлен 2026-09-11, в работе | |
| 20 | |
| 21 | --- |
| 22 | |
| 23 | ## Фаза 0. Ядро и паритет запуска |
| 24 | |
| 25 | Цель — ядро, которое умеет запускать игры не хуже bash-версии, и CLI, через |
| 26 | который доступно всё. |
| 27 | |
| 28 | - [x] Cargo workspace, каталог сборки вне Яндекс.Диска |
| 29 | - [x] Реестр настроек с обязательным объяснением каждой — 53 настройки |
| 30 | - [x] Чтение bash-конфигов StartWine без потерь + проверка обратной сборкой |
| 31 | - [x] Перевод конфигов в самодокументированный TOML |
| 32 | - [x] Поиск установки StartWine, раскладка по XDG |
| 33 | - [x] CLI: `legacy info | list | show | verify | convert`, `settings`, `dirs` |
| 34 | - [x] `chl-runtime`: сборка окружения — 53 настройки из 54 |
| 35 | - [x] Типизированный конфиг игры с провенансом значения |
| 36 | - [x] Режим дампа окружения: `chl env <игра>` — отсортирован и детерминирован |
| 37 | - [x] Оверрайды DLL с семантикой bash (дописывание в начало) |
| 38 | - [x] Каталог сборок Wine и установка: `chl wine list | install | installed` |
| 39 | - [x] Создание префикса через `wineboot` |
| 40 | - [x] `chl run <игра>` — запускает программы Windows |
| 41 | - [x] Доктор запуска: 26 проверок (`chl doctor`) |
| 42 | - [x] Сборки Wine: установка, удаление, размер на диске и сообщение о вышедших новее |
| 43 | - [x] Библиотека игр: `chl add | list | forget` |
| 44 | - [x] Сканирование каталога с играми: `chl scan <dir> [--add]` и кнопка |
| 45 | «Сканировать папку» — кандидаты, отсев мусора, имена без тегов релиз-групп, |
| 46 | обложки подтягиваются фоном (`chl_core::scan`) |
| 47 | - [x] Версия Windows, патчи реестра, виртуальный рабочий стол |
| 48 | - [x] MangoHud и vkBasalt с конфигом на каждую игру |
| 49 | - [x] Собранный бинарник `chl` вместо запуска через cargo |
| 50 | - [x] dgVoodoo2 и «не обновлять префикс при смене Wine» — портированы |
| 51 | (`Prefix::apply_dgvoodoo2`/`set_update_disabled` в `chl-wine`) |
| 52 | - [ ] `saves_backup_period_days` — упирается в отсутствие фоновой задачи |
| 53 | бэкапов сохранений, это уже вопрос фазы 1, не точечный порт |
| 54 | - [x] Дамп из bash-версии и побайтовое сравнение — харнесс в |
| 55 | `tools/env-dump-harness/`, 5 игр (bananarfo/Сапёр/Absolum реальные, |
| 56 | OpenGL/внешний лончер шаблонные — на машине нет ни одной реальной |
| 57 | игры этих категорий), 3 реальных бага порта найдено и исправлено |
| 58 | (LD_LIBRARY_PATH/WINEDLLPATH/PATH не выставлялись, режим OpenGL не |
| 59 | учитывался тремя блоками, launch_parameters не доезжали до игры), |
| 60 | после фиксов на всех пяти — ровно 4 расхождения, все объяснённые |
| 61 | (2 намеренных отличия, документированы через `Note::Deviation`; 1 — |
| 62 | уже известная оговорка vkbasalt_effects) |
| 63 | - [x] Запись в реестр напрямую, без запуска `regedit` в префиксе — |
| 64 | `chl_wine::registry` (парсер `.reg` + слияние в `system.reg`/`user.reg` |
| 65 | Wine, включая резолвинг `System\CurrentControlSet` как `REG_LINK` и |
| 66 | чтение уже существующей у Wine записи `str(N):`), 58 юнит-тестов. |
| 67 | Сверено эмпирически с реальным `regedit.exe` на всех 22 патчах из |
| 68 | `data/app_patches/` StartWine (`chl-wine/examples/reg_patch_diff.rs`) — |
| 69 | расхождений в содержимом ни одного патченного ключа, кроме заведомо |
| 70 | безвредного (Wine не пишет пустой ключ-предок, если у него нет своих |
| 71 | значений, а есть только дочерний ключ; прямая запись пишет — тот же |
| 72 | результат при загрузке). Вызов в `chl-cli` переключён на прямую |
| 73 | запись с автоматическим откатом на `apply_reg_patch` |
| 74 | (`regedit.exe`-версию) при ошибке — на случай записи в существующем |
| 75 | префиксе, которой не было ни в одном проверенном патче |
| 76 | - [x] Изоляция запуска через bubblewrap — своего у StartWine никогда не было |
| 77 | (`chl_wine::sandbox`, настройка `sandbox`, по умолчанию выключена). |
| 78 | Только файловая изоляция: `--ro-bind` каталога установки целиком плюс |
| 79 | `--bind` на запись только для префикса игры и `data/tmp` — без |
| 80 | `--unshare-pid`/`--unshare-user`/seccomp, осознанно, ради BattlEye и |
| 81 | Easy Anti-Cheat (их рантайм-шимы чувствительны к видимости дерева |
| 82 | процессов; та же граница, что у pressure-vessel — песочницы Proton |
| 83 | для Steam). Проверено делом (2026-09-03, `bwrap 0.12.0`, CachyOS): 10 |
| 84 | юнит-тестов, включая настоящий bwrap-тест записи за пределы bind'ов |
| 85 | (`cargo test -p chl-wine sandbox`), и отдельная сквозная проверка |
| 86 | (`chl-wine/examples/sandbox_smoke_test.rs`) — реальный Wine |
| 87 | (GE-Proton11-6) в одноразовой `--reflink=auto`-копии реального |
| 88 | префикса, `wine cmd /c echo` внутри песочницы отработал и напечатал |
| 89 | вывод. Непроверенное: реальный хендшейк BattlEye/EAC (только что |
| 90 | переменные `PROTON_*_RUNTIME` доезжают до процесса), реальная игра |
| 91 | целиком, GUI-сессия с окном. Поэтому настройка по умолчанию выключена |
| 92 | - [x] Где взять exe игры: StartWine хранит путь вне конфига — |
| 93 | `~/.cache/sw_fm/exe_data.json`. `Library::import_startwine` читал этот |
| 94 | индекс неверно: считал ключ верхнего уровня именем игры, хотя по |
| 95 | `sw_data.py::hash_()`/`class ExeData` это `sha256(path)[:16]` — |
| 96 | непрозрачный идентификатор, а имя и путь лежат в полях значения |
| 97 | (`name`/`path`). Исправлено (2026-09-03): парсинг по настоящей схеме, |
| 98 | записи `platform == "steam"` (`sw_func.py:3052`, путь — |
| 99 | `steam://rungameid/<id>`, не файл) пропускаются, `"epic"` |
| 100 | (`sw_func.py:~4649`) тоже — точнее переносится своим импортом |
| 101 | (`chl_epic::installed`), `"gog"` (`sw_func.py:~4589`) переносится |
| 102 | отсюда за неимением своего. 5 новых юнит-тестов на реальной форме |
| 103 | фикстуры. |
| 104 | - [x] Файлы, которых требует `WINEDLLOVERRIDES`, реально кладутся в |
| 105 | префикс — найдено аудитом (2026-09-03): `chl_runtime::env::build` |
| 106 | с самого начала правильно строил саму строку `WINEDLLOVERRIDES` |
| 107 | («возьми настоящий DXVK/VKD3D-Proton/D3DX вместо встроенного»), но |
| 108 | ни один файл на диск при этом не клался — каждая игра молча уезжала |
| 109 | на медленный встроенный `wined3d`, без единой ошибки. Харнесс |
| 110 | побайтового сравнения окружения из пункта выше этот класс багов в |
| 111 | принципе не видит: это файловый побочный эффект, а не переменная |
| 112 | окружения — критерий фазы («дамп побайтово совпадает») был закрыт, а |
| 113 | баг оставался. Портировано из `RUN_VULKAN`/`try_link_d3d_plugins` |
| 114 | (`sw_runlib:574-655`, `700-728`, `1574-1739`) в |
| 115 | `chl_wine::prefix::Prefix`: `apply_vkd3d_and_icu`, |
| 116 | `apply_wined3d_builtin`, `apply_dxvk`, `apply_vkd3d_proton`, |
| 117 | `apply_d3d_plugins`, `apply_fonts`, вызываются из `chl-cli` сразу |
| 118 | после `apply_dgvoodoo2`. 19 новых юнит-тестов (335 всего в |
| 119 | workspace) плюс сквозная проверка на настоящих сборках Wine и |
| 120 | настоящих архивах DXVK/VKD3D-Proton на этой машине |
| 121 | (`chl-wine/examples/dll_placement_smoke_test.rs`) — sha256 каждого |
| 122 | положенного файла сверен с файлом-источником: 166 совпадений на |
| 123 | GE-Proton11-6 (включая оба варианта — из комплекта сборки и из |
| 124 | собственного архива chimera-launcher), 134 на голом |
| 125 | wine-11.16-staging-amd64 (без vkd3d/DXVK в комплекте — только |
| 126 | standalone-ветка и шрифты). Попутно подтверждена асимметрия |
| 127 | раскладки: у собственных (не входящих в сборку Wine) архивов |
| 128 | подкаталог с 32-битными файлами у DXVK называется `x32`, а у |
| 129 | VKD3D-Proton — `x86`, не `x32` — легко перепутать при копировании |
| 130 | логики с одного на другой. Непроверенное: реальная активация DXVK/ |
| 131 | VKD3D-Proton внутри конкретной игры (нужен ручной прогон одной игры |
| 132 | каждого типа рендера с проверкой `dxgi.dll`/лога DXVK в запущенном |
| 133 | процессе) — sha256-сверка доказывает, что нужные файлы оказываются |
| 134 | на месте и не повреждены, но не то, что Wine их не проигнорирует. |
| 135 | |
| 136 | **Готово, когда** `chl run <игра>` запускает игру, а дамп окружения побайтово |
| 137 | совпадает с bash-версией на пяти играх: DX11, DX12, OpenGL, 32-битной и с |
| 138 | внешним лончером. |
| 139 | |
| 140 | **Пока идёт фаза 0** старый интерфейс StartWine продолжает работать — он просто |
| 141 | вызывает `chl` вместо `sw_runlib`. |
| 142 | |
| 143 | --- |
| 144 | |
| 145 | ## Фаза 1. Хранилище префиксов и версионные бэкапы |
| 146 | |
| 147 | Основание: [ADR-003](DECISIONS.md). Здесь исправляется бэкап, который сейчас |
| 148 | затирает предыдущую копию. |
| 149 | |
| 150 | - [x] Снимок префикса reflink-копией (`cp --reflink=auto`, честный запасной |
| 151 | путь — обычное копирование на файловых системах без reflink, проверено |
| 152 | делом через `supports_reflink()`, а не по имени ФС) |
| 153 | - [x] Версионные снапшоты, старые не затираются новыми — `chl snapshot |
| 154 | create | list | restore | remove`, кнопки на странице игры |
| 155 | - [x] Контентно-адресуемое хранилище, дедупликация по хэшу — **но только |
| 156 | для установленных сборок Wine/Proton (`data/wine/*`), не для живых |
| 157 | префиксов и не для их снимков.** Владелец рассмотрел |
| 158 | `code/crates/chl-wine/CAS-DESIGN.md` и явно сузил scope до этой оси: |
| 159 | сборки Wine — read-only референсные данные, которые в любой момент |
| 160 | можно перекачать заново, в отличие от префиксов с незаменяемыми |
| 161 | сохранениями. Реализовано `chl_wine::cas` — объектный пул |
| 162 | (`data/cas/objects/<2 hex>/<62 hex>`, staging+rename, объект |
| 163 | неизменяем и `chmod 444`), `adopt` (принять установленную сборку в |
| 164 | пул — только чтение исходного каталога), `materialize` (собрать |
| 165 | рабочий каталог из пула reflink-копиями, с перепроверкой каждого |
| 166 | файла по хэшу манифеста), `plan_gc`/`delete_candidates` |
| 167 | (mark-and-sweep, dry-run по умолчанию, удаление только по `--delete`). |
| 168 | CLI: `chl cas adopt <сборка>|--all`, `chl cas list`, `chl cas |
| 169 | materialize`, `chl cas gc [--delete]`. Проверено на реальной |
| 170 | установке (2026-09-03): `chl cas adopt --all` на всех четырёх |
| 171 | сборках `~/Games/Chimera/data/wine` — 13448 уникальных объектов вместо |
| 172 | 22761 файлов, реконструкция 5.0 ГиБ уместилась в 3.8 ГиБ пула, |
| 173 | исходные каталоги не тронуты (проверено побайтовым `diff` на |
| 174 | материализованной копии одной из сборок и повторным запуском |
| 175 | `wine --version` из неё). Живые префиксы (`data/pfx/*`, |
| 176 | `data/pfx_snapshots/*`) этот модуль не читает и не пишет вообще — |
| 177 | расширение на них специально не делалось, это решение для |
| 178 | отдельного прохода. `chl wine install` пока архивы, а не пул: это |
| 179 | сознательно оставлено на будущее (см. `CAS-DESIGN.md`) |
| 180 | - [x] Автоснимок перед сменой сборки Wine и перед новым/изменённым патчем |
| 181 | реестра — `chl_core::state::snapshot_needed`, вызывается из `chl run` |
| 182 | до применения изменения; откат — `chl snapshot restore`, кнопки на |
| 183 | странице игры |
| 184 | - [x] То же самое перед остальными изменениями префикса (winetricks, ручные |
| 185 | DLL-оверрайды из инструментов на странице игры) — `chl_core::state:: |
| 186 | snapshot_before_tool`, вызывается из `run_tool` в `chl-cli` (то же |
| 187 | место, которым и GUI открывает инструменты через `chl tool …`, так |
| 188 | что вторая точка входа не понадобилась). Снимает перед winetricks, |
| 189 | winecfg, regedit, uninstaller и cmd — безусловно, при каждом |
| 190 | открытии, а не по сравнению «было — стало»: в отличие от `chl run`, |
| 191 | это не операция на каждом запуске игры, а редкое явное действие. |
| 192 | `explorer` сознательно не входит — файловый менеджер на префиксе не |
| 193 | опаснее уже существующей кнопки «Открыть префикс», перед которой |
| 194 | снимок никогда не делался. Настройка `dll_overrides` (env var |
| 195 | `WINEDLLOVERRIDES`) в список тоже не входит: она живёт только в |
| 196 | переменной окружения и префикс не трогает — это явно |
| 197 | задокументировано в её же описании в реестре настроек; «ручные |
| 198 | DLL-оверрайды» из ROADMAP — это вкладка Libraries в winecfg, и она |
| 199 | попадает под общую защиту winecfg |
| 200 | - [x] «Машина времени» префикса: список изменений у каждого снимка, не только |
| 201 | дата — `Snapshot::description`, новое поле рядом с `label` в том же |
| 202 | файле `.chl-snapshot` внутри снимка (не отдельный параллельный |
| 203 | файл). У автоматических снимков это текст `SnapshotReason::explain()` |
| 204 | («сборка Wine меняется с wine-11 на GE-Proton10-34 — …», а не только |
| 205 | короткая метка «до смены Wine»); у ручных — что ввёл человек через |
| 206 | `chl snapshot create --description` или что подставил GUI. Снимки до |
| 207 | этой правки читаются нормально: пустое `description` при чтении |
| 208 | подменяется меткой. Показывается в `chl snapshot list` (второй |
| 209 | строкой, когда отличается от метки) и в subtitle снимка на странице |
| 210 | игры |
| 211 | - [x] Проверка целостности хранилища по хэшам — `chl_wine::integrity` + |
| 212 | `chl snapshot verify <id>`. Хэши **не** считаются в `snapshot::create()` |
| 213 | по умолчанию: чтение всех байт снимка на порядки дороже reflink-копии |
| 214 | и сломало бы «готово, когда» ниже. Вместо этого — явный довесок: |
| 215 | `chl snapshot create --hash` считает манифест (sha256 каждого файла, |
| 216 | sha256 переиспользован из `chl_wine::dedup::hash_file`, а не написан |
| 217 | заново) сразу при создании и кладёт его сайдкар-файлом |
| 218 | `.chl-manifest` рядом с `.chl-snapshot` внутри каталога снимка — |
| 219 | аддитивно, формат самого снимка не тронут. Снимки без манифеста (а |
| 220 | это почти все существующие снимки и любой новый без `--hash`) `verify` |
| 221 | честно отвечает «сверять не с чем», а не выдумывает эталон и не |
| 222 | падает; `chl snapshot verify <id> --establish` может посчитать |
| 223 | манифест задним числом, но результат помечен полем |
| 224 | `captured_at_creation = false` и CLI явно предупреждает, что |
| 225 | повреждение, случившееся раньше первого `--establish`, такой |
| 226 | проверкой не поймать. 10 новых юнит-тестов |
| 227 | (`crates/chl-wine/src/integrity.rs`), сквозная проверка через сам |
| 228 | бинарник на одноразовой scratch-фикстуре: создание с `--hash`, |
| 229 | порча файла внутри каталога снимка → `verify` находит `изменён`, |
| 230 | снимок без манифеста → `NoBaseline`, `--establish` → баланс |
| 231 | восстановлен с честной пометкой «задним числом» |
| 232 | - [x] Учёт, политика и удаление снимков — `chl_wine::usage`, |
| 233 | `chl_wine::snapshot::{Policy, to_prune, prune, covered_by}`, вкладка |
| 234 | «Снимки префиксов» в разделе «Сборки Wine». Место считается по |
| 235 | экстентам через ioctl `FS_IOC_FIEMAP`, а не `du`: у reflink-копий |
| 236 | данные общие, и `du` на 28 снимках показывал 436 ГиБ там, где занято |
| 237 | 5.9 — расхождение в семьдесят раз. Сумма непомеченных флагом |
| 238 | `FIEMAP_EXTENT_SHARED` экстентов сходится с `btrfs filesystem du` |
| 239 | до байта (5.90 ГиБ против 5.90 ГиБ), при этом не требует ни root, ни |
| 240 | btrfs-progs/compsize/btdu. Показываются два числа: «своё» (уйдёт с |
| 241 | диска вместе со снимком) и «общее» (останется). Политика — настройки |
| 242 | лончера `pfx_snapshot_keep` (3) и `pfx_snapshot_days` (14): уходит |
| 243 | автоматический снимок, ставший лишним по счёту или старше срока; |
| 244 | снятый человеком не удаляется никогда и в счёт не идёт (`origin` в |
| 245 | `.chl-snapshot`, у старых снимков — по метке). Уборка запускается |
| 246 | сразу после автоснимка и по `chl snapshot prune`. Лишние снимки |
| 247 | теперь и не создаются: смена сборки туда и обратно за сутки не |
| 248 | плодит второй снимок с той же причиной (`covered_by`) — 2026-09-07 |
| 249 | таких набралось восемь за день. Множественное удаление — флажки в |
| 250 | GUI и `chl snapshot remove <id> …`, оба с подтверждением, в котором |
| 251 | перечислено, что именно исчезнет |
| 252 | - [ ] Перенос существующих `.iso` в новое хранилище — **важно при |
| 253 | реализации**: читать squashfs через `backhand` (crates.io, MIT OR |
| 254 | Apache-2.0, активно поддерживается) прямо в процессе, а не шеллом |
| 255 | наружу в `unsquashfs`. Проверено 2026-09-06 в проходе про |
| 256 | предупреждения `chl doctor`: официальные релизы |
| 257 | `plougher/squashfs-tools` публикуют только исходный код, готового |
| 258 | бинарника нет, а самой фичи чтения этих `.iso` пока не существует |
| 259 | нигде в коде — соответствующая проверка `unsquashfs` поэтому удалена |
| 260 | из `chl-doctor` (`TOOLS`), а не оставлена «необязательной»: предупреждать |
| 261 | не о чем, пока нет самого переключателя. |
| 262 | |
| 263 | **Готово, когда** снапшот 8-гигабайтного префикса занимает меньше секунды и |
| 264 | меньше 10 МБ, а откат после изменения, сломавшего игру, возвращает её в |
| 265 | рабочее состояние. |
| 266 | |
| 267 | --- |
| 268 | |
| 269 | ## Фаза 2. Обновления Wine и библиотек |
| 270 | |
| 271 | Основание: [ADR-004](DECISIONS.md). То, что так и не появилось в StartWine. |
| 272 | Исследование, обоснование и то, что осталось design-only, — |
| 273 | [`WINE-UPDATES-DESIGN.md`](code/crates/chl-wine/WINE-UPDATES-DESIGN.md). |
| 274 | |
| 275 | - [x] Манифест версий с хэшами, подписанный ed25519 — `chl_wine::{catalog, |
| 276 | install,manifest,sign}`, `chl wine manifest {build,keygen,sign,verify}`, |
| 277 | сквозь проверено на реальных данных GE-Proton/Kron4ek/RusNor. Механизм |
| 278 | готов и включается в `chl wine install`, если манифест есть и подписан; |
| 279 | настоящего продакшн-ключа владельца пока нет — `keys/wine-manifest.pub` |
| 280 | пуст, `chl wine manifest keygen` не запускался. До этого шага |
| 281 | механизм не защищает ни одну реальную установку. |
| 282 | - [ ] Дифф-загрузка вместо перекачивания архива целиком — design-only, |
| 283 | рекомендация не строить без новых фактов: апстрим не даёт файл- |
| 284 | адресуемого формата, а обновление сборки в этом проекте — редкое |
| 285 | ручное действие, не фоновый поток. Подробности в design-документе. |
| 286 | - [x] Закрепление версии Wine за игрой — оказалось уже сделано |
| 287 | инфраструктурой фаз 0–1 (`wine` в конфиге игры, `Prefix::built_with`, |
| 288 | `SnapshotReason::WineChanged`, `chl wine installed` только сообщает |
| 289 | о новой сборке, ничего не переключает); этот проход добавил только |
| 290 | проверку хэша самой сборки поверх уже работающего закрепления. |
| 291 | - [x] Атомарное обновление самого лаунчера с откатом — **сделано |
| 292 | 2026-09-07** по тому самому наброску (staging + `rename` + журнал + |
| 293 | маркер здоровья + автооткат), крейт `chl-selfupdate`, обёртки |
| 294 | `chl update` и раздел «Обновления» в интерфейсе. Все три открытых |
| 295 | вопроса design-документа закрыты и записаны в [ADR-012](DECISIONS.md): |
| 296 | каталог берётся из `current_exe()`, проверка автоматическая а |
| 297 | установка никогда, бинарника два и они обновляются одним манифестом. |
| 298 | Честно про пределы: уже запущенный процесс доработает на старом коде |
| 299 | (нужен перезапуск), два файла — две операции `rename`, и смесь версий |
| 300 | между ними лечится журналом, а не предотвращается; пока |
| 301 | `keys/wine-manifest.pub` пуст, обновление не устанавливается вовсе — и |
| 302 | говорит об этом вслух. |
| 303 | - [x] Patch notes из истории коммитов, с фильтром по используемым функциям — |
| 304 | `chl_core::devlog`, `chl changelog [--game <игра>]`, источник — |
| 305 | уже существующий `DEVLOG.md`, зашитый в бинарник; фильтр — честно |
| 306 | документированная эвристика по подстроке, не точный разбор. |
| 307 | |
| 308 | - [x] «О программе» с честными благодарностями — `chl_core::about`, |
| 309 | `chl about`, раздел «О программе» в интерфейсе. StartWine назван |
| 310 | первым и по имени, с проверенными по первоисточнику ссылками на git, |
| 311 | Telegram и сообщество ВКонтакте; всё, на чём лаунчер стоит, — с |
| 312 | лицензиями. |
| 313 | |
| 314 | **Готово, когда** обновление Wine между соседними версиями качает дельту, а не |
| 315 | весь архив, и ни одна установленная игра не меняет версию без явного согласия. |
| 316 | Вторая половина условия выполнена и проверена; дельта вместо архива целиком |
| 317 | осталась открытым пунктом — design-документ объясняет, почему это осознанный |
| 318 | выбор, а не недоделка. |
| 319 | |
| 320 | --- |
| 321 | |
| 322 | ## Фаза 3. Steam и Epic Games Store |
| 323 | |
| 324 | Основание: [ADR-005](DECISIONS.md), [ADR-006](DECISIONS.md). |
| 325 | |
| 326 | - [x] Epic: OAuth по одноразовому коду, токен в связке ключей |
| 327 | - [x] Epic: библиотека с отсевом дополнений и ассетов |
| 328 | - [x] Epic: магазин вкладкой на настоящем сайте (WebKitGTK) |
| 329 | - [x] Steam: чтение `libraryfolders.vdf`, разбор манифестов, отсев служебного |
| 330 | - [x] Steam: обложки из кэша, импорт игр в библиотеку |
| 331 | - [x] Steam: ярлыки для Game Mode, с сохранением чужих записей |
| 332 | - [x] Steam: запуск игр через сам Steam |
| 333 | - [ ] Epic: установка и запуск игр (чанковый протокол) — разбор двоичного |
| 334 | манифеста **сделан** (`chl_epic::manifest`, сверен с legendary); |
| 335 | сама загрузка не написана, развилка «внешний legendary против своего |
| 336 | загрузчика» разобрана и ждёт решения владельца в |
| 337 | [`CHUNKED-INSTALL-DESIGN.md`](code/crates/chl-epic/CHUNKED-INSTALL-DESIGN.md) |
| 338 | - [ ] Steam: автоустановка Windows-Steam в свой префикс |
| 339 | - [x] GOG — auth (тот же безопасный код-based флоу, что у Epic, подтверждено |
| 340 | живыми запросами к auth.gog.com без реального аккаунта), библиотека, |
| 341 | закачка (обычный HTTP, без чанкового протокола — GOG его и не |
| 342 | использует) и распаковка (`innoextract` на Windows-инсталляторах; |
| 343 | Linux-инсталлятор — это шелл-скрипт с ZIP в хвосте, `unzip` читает |
| 344 | его напрямую, `binwalk` из bash-версии не нужен — проверено |
| 345 | синтетическим тестом). Не проверено вживую: реальный вход и |
| 346 | полная установка игры — нет доступа к настоящему аккаунту GOG в |
| 347 | этой сессии |
| 348 | |
| 349 | **Готово, когда** в разделе Epic можно найти игру в магазине, купить, установить |
| 350 | и запустить, не выходя из лаунчера и не запуская Windows-лончер Epic. |
| 351 | |
| 352 | --- |
| 353 | |
| 354 | ## Фаза 4. GUI на GTK4 |
| 355 | |
| 356 | Основание: [ADR-007](DECISIONS.md), [ADR-008](DECISIONS.md). |
| 357 | |
| 358 | - [x] Генерация интерфейса настроек из реестра |
| 359 | - [x] Три уровня сложности, по умолчанию виден только простой |
| 360 | - [x] Провенанс значения: откуда взялось текущее |
| 361 | - [x] Библиотека плитками с обложками, страница игры, запуск |
| 362 | - [x] Живой фон и стекло, шесть палитр, выключаемая анимация |
| 363 | - [x] Ярлык в меню приложений и значок |
| 364 | - [x] Настройки MangoHud/vkBasalt — не текстовое поле, а настоящий выбор: |
| 365 | 39 подписанных индикаторов MangoHud + 14 цветовых пикеров |
| 366 | (`Kind::MangoHudList`, одна строка mangohud_config — как и раньше, |
| 367 | MangoHud сам не различает индикаторы и цвета), 71 эффект vkBasalt с |
| 368 | управлением порядком цепочки (`Kind::MultiFlag`, эффекты |
| 369 | order-sensitive) + слайдер резкости CAS. Заодно найдено: в самом |
| 370 | StartWine 69 из 70 переключателей ReShade были мертвы — путь к |
| 371 | шейдерам никогда не заполнялся; не стали изобретать раздачу шейдеров, |
| 372 | но таблицу reshadeEffects в конфиге теперь пишем полностью |
| 373 | - [x] Экран глобальных настроек лончера — раньше не было вообще. Автозапуск |
| 374 | (настоящий XDG autostart-файл), каталог по умолчанию для выбора exe, |
| 375 | сброс настроек, очистка кэша шейдеров (все драйверные кэши + |
| 376 | общий кэш DXVK/VKD3D всех игр разом — паритет с кнопкой в StartWine). |
| 377 | Сознательно не сделано: язык интерфейса (нет i18n вообще, пустой |
| 378 | переключатель хуже отсутствующего) и трей/автосворачивание (в GTK4 |
| 379 | нет системного трея, инфраструктуры не существует) — задокументировано |
| 380 | как открытый гэп, а не тихо пропущено |
| 381 | - [x] Скриншот по глобальному хоткею — `chl-capture`, через |
| 382 | `org.freedesktop.portal.Screenshot` (один код для X11 и Wayland), |
| 383 | хоткей — сырой evdev, не GTK-акселератор (иначе работал бы только |
| 384 | с фокусом на окне лончера, а не поверх игры) и не портальный |
| 385 | `GlobalShortcuts` (не работает на wlroots-компоузиторах вроде |
| 386 | Sway/Hyprland). Проверено по-настоящему — реальный PNG 3840×2160 |
| 387 | получен на этой машине. Запись экрана — намеренно только дизайн |
| 388 | (`chl-capture/src/recording.rs`), не сделана: это полноценный |
| 389 | GStreamer/PipeWire-пайплайн, а не одноразовый вызов портала |
| 390 | - [x] Big Picture с навигацией геймпадом — три части, каждая работает |
| 391 | отдельно. **Навигация**: события пада читает `chl_input::reader` |
| 392 | (поток, спящий в `read(2)`; своего опроса нет), переводит в действия |
| 393 | `chl_input::nav` (мёртвая зона, гистерезис, повтор с разгоном), |
| 394 | выполняет `chl-gui/src/gamepad.rs` — обычным `child_focus`, тем же |
| 395 | механизмом, что и стрелки на клавиатуре. Пад **не захватывается** |
| 396 | (`EVIOCGRAB` не зовётся), поэтому игра продолжает видеть его сама; |
| 397 | пока окно неактивно, события выбрасываются — падом играют, а не ходят |
| 398 | по меню. **Переназначение**: свой раздел «Геймпад» — что подключено, |
| 399 | какая кнопка что делает, «Назначить» ловит следующее нажатие, |
| 400 | мёртвая зона и тайминги повтора; файл `gamepad.toml`, битый файл — |
| 401 | раскладка по умолчанию, а не отказ работать. В терминале то же самое: |
| 402 | `chl gamepad bindings`. **Режим приставки**: `--big-picture`, F11, |
| 403 | кнопка в шапке или Select на паде — полный экран, плитки в 1.75 раза |
| 404 | крупнее, шрифт на четверть, панель разделов в полосу значков и |
| 405 | **остановленный живой фон** (та самая экономия на Steam Deck: ни |
| 406 | шейдер, ни запасное рисование на процессоре кадров больше не просят). |
| 407 | Выход — Esc, B или та же кнопка. Второго интерфейса под режим нет |
| 408 | намеренно, см. `DECISIONS.md` про «не два тулкита» |
| 409 | |
| 410 | **Готово, когда** человек, впервые открывший лаунчер, устанавливает и запускает |
| 411 | игру, не открыв документацию и не спросив, что делает переключатель. |
| 412 | |
| 413 | --- |
| 414 | |
| 415 | ## Фаза 5. Фичи-дифференциаторы |
| 416 | |
| 417 | Независимы друг от друга, берутся по одной. Порядок — по соотношению |
| 418 | польза к трудоёмкости. |
| 419 | |
| 420 | 1. **Доктор запуска.** Проверка Vulkan, драйвера, лимитов, отсутствующих |
| 421 | рантаймов и шрифтов, регистра в путях, прав на устройства. Человеческим |
| 422 | языком плюс кнопка «Исправить». Первым — снимает половину вопросов |
| 423 | «почему не запускается». |
| 424 | 2. **Supervisor сна.** Wine-игры массово умирают после сна Steam Deck. |
| 425 | Заморозка группы процессов через cgroup freezer перед suspend, разморозка |
| 426 | после, с обходами для отдельных игр. Вне Steam этого не делает никто. |
| 427 | 3. **Power-профили на игру.** TDP, частоты GPU, кривая вентилятора, частота |
| 428 | обновления, уровень FSR — применяются при запуске, восстанавливаются при |
| 429 | выходе. |
| 430 | 4. **Автотюнер конфига.** Прогон игры с разными наборами настроек (ntsync |
| 431 | против fsync, DXVK против VKD3D, уровни FSR), сбор фреймтаймов из лога |
| 432 | MangoHud, статистика по 1% и 0.1% low, обоснованная рекомендация. |
| 433 | 5. **Game Capsule.** Экспорт игры целиком — данные, префикс, конфиг, |
| 434 | сохранения, закреплённая версия Wine — в один переносимый файл с |
| 435 | дедупликацией. |
| 436 | 6. **Синхронизация сохранений на своём хранилище.** Бэкенд rclone |
| 437 | (Яндекс.Диск, S3, WebDAV), версионирование и разрешение конфликтов. Пути |
| 438 | сохранений — из открытого манифеста ludusavi, а не собирать вручную. |
| 439 | 7. **Предсобранные шейдер-кэши.** Раздача готовых кэшей DXVK и VKD3D по ключу |
| 440 | «игра + архитектура GPU + версия драйвера + версия DXVK». |
| 441 | 8. **Нативный слой геймпада.** Профиль на игру, экранная клавиатура, гироскоп |
| 442 | и тачпады через виртуальный геймпад на evdev и uinput. Самая тяжёлая, но |
| 443 | именно она снимает зависимость от Steam Input. |
| 444 | **Начато** (`chl-input`, `GAMEPAD-DESIGN.md`): перечисление устройств и |
| 445 | хотплаг — сделаны и проверены на настоящем геймпаде (8BitDo Ultimate 2), |
| 446 | включая живое переподключение. По дороге воспроизведён и исправлен |
| 447 | собственный баг StartWine — сверка устройств по одному имени путает |
| 448 | несколько `eventN`-нод одной железки. Ни виртуальное uinput-устройство, |
| 449 | ни перехват ввода (`EVIOCGRAB`) пока не созданы — сознательно, это |
| 450 | первая по-настоящему рискованная часть, ждёт отдельного прохода. |
| 451 | Настройка `controller` пока остаётся нерабочей (`NO_EFFECT`) до тех пор. |
| 452 | |
| 453 | --- |
| 454 | |
| 455 | ## Фаза 6. Долги и уроки из разбора GameHub |
| 456 | |
| 457 | Появилась 2026-09-11. Две половины: хвосты, которые накопились за сентябрьские |
| 458 | релизы (0.1.2–0.1.6), и выводы из разбора macOS-лаунчера GameHub — его устройство |
| 459 | разобрано по установленной копии, материалы в `~/Projects/gamehub-recon/` |
| 460 | (вне git: чужие файлы в наш репозиторий не кладём, берём идеи, не содержимое). |
| 461 | |
| 462 | Порядок: сначала долги, потом новое, macOS — последним. |
| 463 | |
| 464 | ### 6.1. Долги |
| 465 | |
| 466 | - [ ] **Подтвердить проброс настроек в Steam живым запуском.** Механика выпущена |
| 467 | в 0.1.6 и настроена, но запуск настоящей игры через обёртку не наблюдался. |
| 468 | Критерий: в `steam-compat.log` есть строка с appid игры и списком |
| 469 | переменных, и игра при этом запустилась. |
| 470 | - [x] **Убрать устаревшее предупреждение** на вкладке «Настройки» у игры Steam |
| 471 | и в выводе `chl run` — после 0.1.6 это неправда, если проброс настроен. |
| 472 | Текст зависит от состояния обёртки (0.1.11 в интерфейсе, 0.1.12 в CLI). |
| 473 | - [x] **`--screenshot` обязан завершать процесс.** Сделано: выход через |
| 474 | `std::process::exit` с честным кодом возврата. `CHL_TAB` принимает список |
| 475 | имён через запятую — вложенные вкладки (магазины → Epic → «Магазин») |
| 476 | теперь достижимы снимком без единого щелчка мышью. |
| 477 | - [ ] **Скрипт упаковки прячет ошибку за пайпом.** `build-installer.sh | tail` |
| 478 | возвращает код 0 даже когда сборка упала (поймано на неподнятом |
| 479 | `Cargo.lock`). Нужен `set -o pipefail` или проверка кода. |
| 480 | - [ ] **Флапающий тест `chl-epic`** (`без_системного_и_без_своей_копии_недоступно`): |
| 481 | падает в общем прогоне, проходит в одиночку — тесты делят состояние |
| 482 | окружения. |
| 483 | - [ ] **Сборки GE-Proton не видны обёртке Steam.** Steam запускает только то, что |
| 484 | лежит у него; наши сборки живут в каталоге лаунчера. Решить: раскладывать |
| 485 | симлинком в `compatibilitytools.d` или честно сказать в интерфейсе. |
| 486 | - [ ] **Завести работу в OpenProject** (проект 9, `chimera-launcher`): релизы |
| 487 | 0.1.2–0.1.6 и эта фаза. По правилам проекта работа должна быть на виду, а |
| 488 | не только в переписке и журнале. |
| 489 | - [ ] **Сквозная вычитка текстов** — от нейрослопа к своему регистру, по всем |
| 490 | подписям, описаниям настроек и документации. Отложена с 2026-09-09. |
| 491 | |
| 492 | ### 6.2. Магазины |
| 493 | |
| 494 | - [x] **Магазины одним разделом с переключателем** — сделано в 0.1.11. |
| 495 | Постоянная сессия витрины оказалась мифом: cookies не сохранялись вообще, |
| 496 | в каталоге сессии не было даже файла (`set_persistent_storage` не |
| 497 | вызывался). Починено в 0.1.12, там же — вход витрины Epic под аккаунтом |
| 498 | лаунчера через одноразовый код обмена, без второго входа и без капчи. |
| 499 | - [ ] **Витрина GOG под своим аккаунтом без отдельного входа.** У GOG нет |
| 500 | публичного обмена токена на сессию сайта (у Heroic то же ограничение), |
| 501 | поэтому пока так: один вход в «Аккаунты» — и витрина знает о нём, потому |
| 502 | что это один и тот же `NetworkSession`. Проверить живьём после повторного |
| 503 | входа в GOG. |
| 504 | - [x] **Магазины — только витрины, купленное — в библиотеке** (0.1.14). Раздел |
| 505 | «Магазины» это три витрины и браузер; вкладки «Мои игры» убраны, купленное |
| 506 | в Epic и GOG показано в сетке библиотеки рядом с установленным. Вход в |
| 507 | аккаунты — свой раздел «Аккаунты», с выходом. |
| 508 | - [x] **Библиотека: вкладки по магазинам и деление на установленные/нет** |
| 509 | (0.1.14). |
| 510 | - [x] **Витрина Steam под своим аккаунтом** (0.1.14) — сессия сайта берётся у |
| 511 | клиента Steam на этой же машине (`chl_steam::webauth`), выключается |
| 512 | настройкой `steam_webauth`. |
| 513 | - [ ] **Список купленного в Steam.** Локально его нет (`appmanifest` только у |
| 514 | установленного), публичного способа без ключа Steam Web API у Valve тоже. |
| 515 | Вариант: необязательное поле «ключ Steam Web API» в «Аккаунтах» и |
| 516 | `IPlayerService/GetOwnedGames` — стабильный документированный путь, в |
| 517 | отличие от разбора вёрстки профиля. |
| 518 | - [ ] **Своё поле «магазин» у записи игры.** Сейчас Epic и GOG обе пишутся как |
| 519 | `Source::Store` без различения, и установленная игра из магазина попадает |
| 520 | на обе вкладки сразу. Часть работы по устойчивому ключу игры (#266). |
| 521 | |
| 522 | ### 6.2b. Публичная страница проекта |
| 523 | |
| 524 | - [x] **Страница есть** (0.1.14): `compat.project-chimera.ru/launcher/` — что это |
| 525 | за программа, заметки к выпуску (читаются на лету из подписанного |
| 526 | манифеста), таблица «что уходит в сеть и когда», список того, чего лаунчер |
| 527 | не делает, как сообщить о проблеме. |
| 528 | - [ ] **Публичная лента отчётов.** У `chimera-compat` есть таблица |
| 529 | `problem_reports`; нужен эндпоинт, отдающий агрегат (вид проблемы, игра, |
| 530 | число, когда в последний раз) — без тела отчёта. Пока показывать нечего, |
| 531 | кроме собственных тестовых отправок. |
| 532 | - [ ] **Исходники наружу.** Публичного зеркала репозитория нет; на странице об |
| 533 | этом сказано прямо. Требует решения: открывать ли зеркало и где. |
| 534 | - [ ] **Отдельный адрес** `launcher.project-chimera.ru` — одна запись DNS, |
| 535 | сертификат уже покрывает поддомены. Сейчас страница живёт на том же хосте, |
| 536 | что манифест выпуска, чтобы читать его без CORS. |
| 537 | |
| 538 | ### 6.2a. Оверлей поверх игры |
| 539 | |
| 540 | Запрошено: вызвать оверлей, не выходя из игры, — отправить баг, снять видео, |
| 541 | открыть гайд. Скриншоты, записи, гайды и документация привязаны к запущенной |
| 542 | игре. |
| 543 | |
| 544 | Честная оценка: окно поверх игры — это не решение. В полноэкранном режиме оно |
| 545 | не поднимется ни на X11 без грязных трюков, ни на Wayland вовсе. Настоящий |
| 546 | оверлей — слой Vulkan поверх swapchain (как MangoHud; DXVK и VKD3D переводят |
| 547 | в Vulkan почти всё, что запускается под Wine) плюс перехват ввода, которого у |
| 548 | MangoHud как раз нет. Второй реальный путь — `gamescope` вложенным |
| 549 | композитором и layer-shell поверх него. |
| 550 | |
| 551 | - [x] **Привязать медиа к запущенной игре** — сделано в 0.1.13. Имя игры в |
| 552 | имени файла кадра (`chl_wine::running::current_game` по метке |
| 553 | `CHL_GAME`), подпись «во что играли и когда» вместо имени файла, |
| 554 | группа «Снимки из игры» на вкладке «Картинки» карточки. |
| 555 | Не сделано: то же для записей экрана — их пока нет вовсе. |
| 556 | - [ ] **Решить путь оверлея**: слой Vulkan своими руками или `gamescope`. |
| 557 | Требует решения — это разный объём работы и разные требования к машине. |
| 558 | - [ ] **Гайды и документация по игре** — уже есть база знаний (`chl-kb`), |
| 559 | нужно связать её с оверлеем, когда тот появится. |
| 560 | |
| 561 | ### 6.3. Что берём из GameHub |
| 562 | |
| 563 | По убыванию пользы. Обоснование каждого пункта — в `ОТЧЁТ.md` разбора. |
| 564 | |
| 565 | - [x] **Метка процесса.** Свой тег в окружении запуска (`PROCESS_TAG`-подобный) и |
| 566 | поиск процессов игры по нему. Лечит «игра сменила процесс, лаунчер её |
| 567 | потерял». Самый дешёвый пункт фазы. |
| 568 | - [x] **Стабильный ключ игры вместо имени файла.** Сделано иначе и уже |
| 569 | (0.1.9): болела не раскладка файлов, а импорт Steam, искавший игру по |
| 570 | названию. Теперь по `steam_appid`, с переносом файлов за записью. |
| 571 | Epic и GOG остаются на названии — им нужно поле под идентификатор. |
| 572 | Было: Сейчас конфиг зовётся |
| 573 | `<имя>.toml`, и переименование вручную тащит конфиг, состояние запусков и |
| 574 | обложки — на этом уже теряли настройки (журнал 2026-09-07). У GameHub имя |
| 575 | файла профиля = sha256 от ключа `{платформа, app_id, внутренний id}`, а |
| 576 | название игры — просто подпись. Нужна миграция существующих конфигов. |
| 577 | - [~] **Третий слой профилей и открытая база.** Слои сделаны (0.1.10): |
| 578 | реестр → рекомендация сообщества → общие умолчания → настройки игры. |
| 579 | Открытый репозиторий профилей — остаётся. Было: У нас два слоя (общие умолчания + |
| 580 | переопределение игры, `Origin::Global`). Добавить третий — вендорские и |
| 581 | сообщества умолчания под пользовательскими правками, слияние на чтении, |
| 582 | видно происхождение значения, откат к вендорскому. |
| 583 | У GameHub слои **не разделены**: вендорское впечатывается в тот же файл при |
| 584 | добавлении игры, поэтому обновить профиль, не затерев правки, нечем. Плюс |
| 585 | база у них закрытая и серверная. У нас GPL — база профилей открытым |
| 586 | git-репозиторием с приёмом правок от игроков. |
| 587 | - [ ] **Рецепты зависимостей и манифесты компонентов.** Зависимость — YAML с |
| 588 | шагами (`archive_extract` с url+sha256+размером, `copy_dll` с глоб-масками), |
| 589 | компонент — манифест с `environment_template` и подстановкой путей. Сейчас |
| 590 | это код в `env.rs` и `chl-install`; станет данными, и новый компонент не |
| 591 | потребует пересборки лаунчера. |
| 592 | - [~] **Исключения на конкретный `.exe` внутри игры — отклонено в этой |
| 593 | постановке.** У нас окружение одно на всё дерево процессов запуска, |
| 594 | и «разным exe разные настройки» без прослойки на каждый процесс не |
| 595 | сделать. Применимый у нас вариант той же боли — профили запуска на |
| 596 | игру (у игры несколько exe, у каждого свои настройки и свой пункт |
| 597 | запуска). Было: Лаунчер издателя и сама |
| 598 | игра едут на разных настройках. У GameHub это `GraphicsStackException |
| 599 | { exe, stack_id }` и отдельный блок в интерфейсе; у нас `exe` один на игру. |
| 600 | - [x] **Предполётная проверка с машиночитаемыми кодами** (0.1.11): все |
| 601 | причины сразу и до работы над префиксом, у каждой код, «что» и «что |
| 602 | делать». |
| 603 | |
| 604 | ### 6.3a. Что берём у аналогов (обзор 2026-09-23) |
| 605 | |
| 606 | Heroic, Lutris, Bottles, Faugus, PortProton, umu — `docs/ANALOGS-REVIEW.md`, |
| 607 | там же откуда и почему. По убыванию пользы. |
| 608 | |
| 609 | - [x] Нехватки и рекомендуемые пакеты на странице игры, установка кнопкой |
| 610 | (Bottles: Eagle и профиль совместимости) — `deps_card.rs`. |
| 611 | - [x] Журнал последнего запуска на странице игры (Heroic, Lutris, Faugus: |
| 612 | «играть с логами») — `run_log_row.rs`. |
| 613 | - [x] Добавление игры кнопкой рядом с поиском, а не строками во всю ширину |
| 614 | (Heroic, Lutris). |
| 615 | - [ ] Окно «анти-чит этой игры под Linux не работает» перед первым запуском, |
| 616 | с источником (Heroic, PortProtonQt; AreWeAntiCheatYet — MIT). Статус |
| 617 | уже есть в базе знаний. |
| 618 | - [ ] «Затронет N игр» у всего, что пишет в общий префикс (Faugus). |
| 619 | - [ ] Автобэкап выбранных папок сохранений после выхода игры, N поколений |
| 620 | (Bottles, Faugus) — поверх раздела «Бэкапы сохранений». |
| 621 | - [ ] Разбор .exe до первого запуска: движок, анти-чит, пакеты (Bottles |
| 622 | Eagle под GPL — писать своё, таблица импорта уже разбирается в `chl deps`). |
| 623 | - [ ] Таблица переменных окружения с проверкой ключей (Heroic). |
| 624 | - [ ] Представление «Запущено» и сохранённые поиски (Lutris). |
| 625 | |
| 626 | ### 6.4. Требует решения владельца |
| 627 | |
| 628 | - [ ] **Оверлейные контейнеры вместо общего префикса.** Префикс на игру отвергнут |
| 629 | из-за места на диске ([ADR по общему префиксу](DECISIONS.md)) — и это верно |
| 630 | при копировании. GameHub хранит тяжёлое один раз в контент-адресуемом |
| 631 | складе и приводит в префикс ссылками, контент игры в префикс не копируется |
| 632 | вовсе: виртуальный контейнер игры 79–172 МБ против общего склада 290 МБ. |
| 633 | То есть изоляция на игру без платы диском. На Linux делается штатно — |
| 634 | `overlayfs` или `bubblewrap`, без правки wine (им ради этого пришлось |
| 635 | писать свою ФС и инжектить в процесс). Крупная перестройка рантайма, |
| 636 | поэтому — отдельное решение, не самотёком. |
| 637 | |
| 638 | ### 6.5. macOS — не делаем |
| 639 | |
| 640 | **Решение 2026-09-11: порта на macOS не будет.** Силы идут в качество продукта |
| 641 | на Linux. Разведка на MacBook отменена, задание снято, разбор GameHub остаётся |
| 642 | полезным сам по себе — идеи из него в 6.3 не про macOS, а про устройство |
| 643 | лаунчера вообще. |
| 644 | |
| 645 | Причины, чтобы не возвращаться к этому по кругу, — в [ADR-013](DECISIONS.md). |
| 646 | |
| 647 | Что из «задела под macOS» всё же имеет смысл и остаётся в плане **не ради |
| 648 | macOS**: разрез «переносимое ядро / платформенный слой» полезен для тестов без |
| 649 | GTK и для Steam Deck. Он не срочный и делается по месту, когда мешает, |
| 650 | а не отдельной кампанией. |
| 651 | |
| 652 | **Критерий фазы:** долги закрыты, магазины сведены в один раздел, профили живут |
| 653 | в трёх слоях с открытой базой. |
| 654 | |
| 655 | --- |
| 656 | |
| 657 | ## Чего сознательно не делаем |
| 658 | |
| 659 | Список обязателен так же, как список фаз. |
| 660 | |
| 661 | - **Не портируем `sw_shaders.py` построчно.** 11 936 строк — накопленная |
| 662 | сложность вокруг нескольких реальных задач. Сначала выяснить, каких. |
| 663 | - **Не поддерживаем bash-конфиги вечно.** Читалка нужна только для переноса и |
| 664 | будет удалена ([ADR-002](DECISIONS.md)). |
| 665 | - **Не делаем два UI-фреймворка** ([ADR-007](DECISIONS.md)). |
| 666 | - **Не изобретаем свой формат архивов и протокол обновлений.** zstd, ed25519, |
| 667 | чанкинг в стиле casync — готовое и проверенное. |
| 668 | - **Не начинаем с GUI** ([ADR-001](DECISIONS.md)). |
| 669 | - **Не собираем свою базу совместимости с нуля.** ProtonDB, PCGamingWiki и |
| 670 | манифест ludusavi уже открыты. |
| 671 | - **Не обещаем полную замену нативного Steam** ([ADR-006](DECISIONS.md)). |
| 672 |