Project Chimera
Меню

Исходники

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
4201. **Доктор запуска.** Проверка Vulkan, драйвера, лимитов, отсутствующих
421 рантаймов и шрифтов, регистра в путях, прав на устройства. Человеческим
422 языком плюс кнопка «Исправить». Первым — снимает половину вопросов
423 «почему не запускается».
4242. **Supervisor сна.** Wine-игры массово умирают после сна Steam Deck.
425 Заморозка группы процессов через cgroup freezer перед suspend, разморозка
426 после, с обходами для отдельных игр. Вне Steam этого не делает никто.
4273. **Power-профили на игру.** TDP, частоты GPU, кривая вентилятора, частота
428 обновления, уровень FSR — применяются при запуске, восстанавливаются при
429 выходе.
4304. **Автотюнер конфига.** Прогон игры с разными наборами настроек (ntsync
431 против fsync, DXVK против VKD3D, уровни FSR), сбор фреймтаймов из лога
432 MangoHud, статистика по 1% и 0.1% low, обоснованная рекомендация.
4335. **Game Capsule.** Экспорт игры целиком — данные, префикс, конфиг,
434 сохранения, закреплённая версия Wine — в один переносимый файл с
435 дедупликацией.
4366. **Синхронизация сохранений на своём хранилище.** Бэкенд rclone
437 (Яндекс.Диск, S3, WebDAV), версионирование и разрешение конфликтов. Пути
438 сохранений — из открытого манифеста ludusavi, а не собирать вручную.
4397. **Предсобранные шейдер-кэши.** Раздача готовых кэшей DXVK и VKD3D по ключу
440 «игра + архитектура GPU + версия драйвера + версия DXVK».
4418. **Нативный слой геймпада.** Профиль на игру, экранная клавиатура, гироскоп
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) плюс перехват ввода, которого у
548MangoHud как раз нет. Второй реальный путь — `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
606Heroic, 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» всё же имеет смысл и остаётся в плане **не ради
648macOS**: разрез «переносимое ядро / платформенный слой» полезен для тестов без
649GTK и для 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