Project Chimera
Меню

Исходники

189 строк · 13 КиБ

REFERENCES.md

1# Ссылки на документацию
2
3Только то, что реально нужно по фазам плана. Ссылки на официальные источники,
4а не на пересказы.
5
6## Wine и трансляция графики
7
8- [Wine Wiki: Wineprefix](https://gitlab.winehq.org/wine/wine/-/wikis/FAQ) —
9 устройство префикса, `WINEPREFIX`, `WINEARCH`
10- [Wine: WINEDLLOVERRIDES](https://gitlab.winehq.org/wine/wine/-/wikis/Wine-User%27s-Guide#dll-overrides)
11 — синтаксис оверрайдов, нужен для `dll_overrides`
12- [DXVK](https://github.com/doitsujin/dxvk) — Direct3D 9/10/11 → Vulkan,
13 переменные окружения и конфиг в `dxvk.conf`
14- [VKD3D-Proton](https://github.com/HansKristian-Work/vkd3d-proton) —
15 Direct3D 12 → Vulkan
16- [Kron4ek Wine-Builds](https://github.com/Kron4ek/Wine-Builds) — источник
17 сборок, который StartWine перечисляет в `wine_version.json`
18- [Proton](https://github.com/ValveSoftware/Proton) — устройство рантайма,
19 переменные `PROTON_*`
20- [ntsync в ядре Linux](https://docs.kernel.org/userspace-api/ntsync.html) —
21 примитивы синхронизации NT, самый быстрый режим для `ntsync`
22- [dgVoodoo2](http://dege.freeweb.hu/dgVoodoo2/dgVoodoo2/) — обёртка
23 DirectX 1–7 и Glide
24
25## Магазины
26
27- [legendary](https://github.com/derrod/legendary) — открытая реализация
28 клиента Epic: OAuth-поток, манифесты, чанковая загрузка. Код StartWine в
29 `sw_dlm.py` основан на нём; наша реализация ориентируется на тот же протокол
30- [Heroic Games Launcher](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher)
31 — рабочий пример связки нативной библиотеки и веб-магазина
32- [Steam VDF](https://developer.valvesoftware.com/wiki/KeyValues) — формат
33 `libraryfolders.vdf` и `shortcuts.vdf`
34- [SteamGridDB API](https://www.steamgriddb.com/api/v2) — арт для ярлыков
35 не-Steam игр
36- [nile](https://github.com/imLinguin/nile) — то же для Amazon, если дойдём
37
38## Хранилище и бэкапы
39
40- [btrfs: reflink и клонирование](https://btrfs.readthedocs.io/en/latest/Reflink.html)
41 — основа снапшотов префиксов
42- [`ioctl_ficlonerange(2)`](https://man7.org/linux/man-pages/man2/ioctl_ficlonerange.2.html)
43 — системный вызов `FICLONE`
44- [casync](https://github.com/systemd/casync) — образец чанкинга для
45 дифф-загрузки обновлений
46- [ludusavi manifest](https://github.com/mtkennerly/ludusavi-manifest) — пути
47 сохранений из PCGamingWiki, открытые данные
48- [rclone](https://rclone.org/docs/) — бэкенд синхронизации сохранений
49
50## Steam Deck и питание
51
52- [MangoHud](https://github.com/flightlessmango/MangoHud) — оверлей и, что
53 важнее, формат лога фреймтаймов для автотюнера
54- [`MANGOHUD_CONFIG`](https://github.com/flightlessmango/MangoHud#environment-variables)
55 — параметры, которые лежат в `mangohud_config`
56- [cgroup v2: freezer](https://docs.kernel.org/admin-guide/cgroup-v2.html#core-interface-files)
57 — `cgroup.freeze` для supervisor-а сна
58- [lsfg-vk](https://github.com/PancakeTAS/lsfg-vk) — генерация кадров,
59 за которую отвечает `lossless_frame_gen`
60- [vkBasalt](https://github.com/DadSchoorse/vkBasalt) — постобработка
61
62## Изоляция и запуск
63
64- [bubblewrap](https://github.com/containers/bubblewrap) — песочница для
65 запуска игр
66- [XDG Base Directory](https://specification.freedesktop.org/basedir-spec/basedir-spec-latest.html)
67 — раскладка каталогов, реализована в `paths.rs`
68
69## GUI
70
71- [gtk4-rs](https://gtk-rs.org/gtk4-rs/stable/latest/docs/gtk4/) — привязки GTK4
72- [libadwaita](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/) —
73 адаптивные компоненты для «десктоп ↔ Deck»
74- [Книга gtk4-rs](https://gtk-rs.org/gtk4-rs/stable/latest/book/) — практическое
75 введение
76
77## Совместимость игр
78
79- [ProtonDB](https://www.protondb.com/) — отчёты пользователей
80- [PCGamingWiki](https://www.pcgamingwiki.com/) — исправления и пути файлов
81
82## База знаний по играм (`chl-kb`)
83
84Только русскоязычные источники — по просьбе владельца лончера. У каждого
85куска текста в интерфейсе стоит первоисточник и лицензия; условия и
86причины отбора расписаны в [PRIVACY.md](PRIVACY.md).
87
88- Русские вики игр: русский раздел на Fandom (`gothic.fandom.com/ru`,
89 `reddead.fandom.com/ru`, `metro.fandom.com/ru`, `stalker.fandom.com/ru`,
90 `gta.fandom.com/ru`, `starwars.fandom.com/ru`,
91 `thelastofus.fandom.com/ru`, `princeofpersia.fandom.com/ru`) и русские
92 вики со своим адресом (`vedmak.fandom.com`, `ru.minecraft.wiki`,
93 `terraria.wiki.gg/ru`). Язык и лицензия читаются с самой вики.
94- [Русская Википедия](https://ru.wikipedia.org/) (CC BY-SA 4.0) — блок
95 «Об игре», картинки с Wikimedia Commons и русское название игры.
96
97Англоязычных источников среди тех, что дают **текст статьи**, нет ни
98одного: PCGamingWiki, которая была единственным исключением и единственным
99поставщиком «Управления» и «Проблем и фиксов», убрана 2026-09-07 по
100решению владельца. Из-за этого «Проблемы и фиксы» остались без источника
101вовсе — так и подписано в интерфейсе.
102
103### Оценки совместимости — единственное сознательное исключение
104
105Три источника ниже — англоязычные, и это не отмена решения про
106PCGamingWiki, а его точная граница: правило «только по-русски» защищает от
107языкового барьера в *тексте* (гайд, прохождение), а эти источники отдают
108не текст, а один статус из закрытого списка значений — переводится без
109остатка, и на экране всегда русское слово (`chl-kb/src/protondb.rs`,
110`chl-kb/src/anticheat.rs`, `chl-kb/src/steamdeck.rs`).
111
112- [ProtonDB](https://www.protondb.com/) — сводный вердикт сообщества,
113 заведётся ли игра под Proton. Эндпоинт `api/v1/reports/summaries/<appid>.json`,
114 без ключа, используется самим сайтом.
115- [Are We Anti-Cheat Yet](https://areweanticheatyet.com/) — держит ли
116 анти-чит игры Linux вообще. Датасет целиком:
117 [`games.json`](https://github.com/AreWeAntiCheatYet/AreWeAntiCheatYet).
118- Категория Steam Deck — вердикт самого Valve, недокументированный
119 эндпоинт `ajaxgetdeckappcompatibilityreport` магазина Steam.
120
121### «Где ещё почитать» — русские издания, только ссылки
122
123Разбор русских игровых изданий (2026-09-07) по просьбе владельца:
124«stopgame… igromania, лучшие компьютерные игры… goha… ixbt». Итог: **текста
125не берём ни у одного** — лицензии на переиспользование нет нигде, Creative
126Commons ни у кого; но **ссылка с заголовком статьёй не является**, и там,
127где пользовательское соглашение издания не запрещает автоматический
128доступ, лончер берёт адрес страницы игры. Полная таблица с цитатами — в
129шапке `chl-kb/src/editorial.rs` и в вики OpenProject (проект
130`chimera-launcher`).
131
132Куда лончер ходит — по одному запросу за адресом страницы игры:
133
134- [VGTimes](https://vgtimes.ru/) — `/games/<игра>/guides/`
135- [PlayGround.ru](https://www.playground.ru/) — `/<игра>`
136- [GoHa.Ru](https://goha.ru/) — `/games/<игра>`
137- [IXBT Games](https://ixbt.games/) — `/games/<игра>`
138
139Куда **не** ходит, и почему именно:
140
141- **StopGame** — п. 5.2.6 пользовательского положения: «не использовать
142 автоматические скрипты для сбора информации с Сайта».
143- **DTF** — п. 5.3.8 правил: «использовать без специального на то
144 разрешения Администрации Сайта автоматизированные скрипты (программы)
145 для сбора информации на Сайте».
146- **«Игромания», «Канобу»** — соглашение запрещает «автоматические
147 механизмы… агенты, автоматические устройства, скрипты или «пауки»», и
148 вдобавок оба отдают 403 любому не-браузеру.
149- **[«Лучшие компьютерные игры»](http://lki.ru/)** — единственный
150 источник в списке, у которого **разрешение на переиспользование текста
151 есть** ([условия](http://lki.ru/info.php?subj=sotrudnichestvo)), но
152 журнал закрыт в январе 2012 года и ни одной игры владельца там нет;
153 поиск по игре мёртв, сайт только по HTTP и в windows-1251. Стоит
154 вернуться, если в библиотеке появятся игры до 2012 года.
155- **Zone of Games** — правила не мешают, но сайт объявляет UTF-8 и отдаёт
156 windows-1251; читать его нечем без своего перекодировщика.
157- **Overclockers.ru** — «Мы категорически против перепечатки материалов…
158 разместите анонс на своём сайте и дайте ссылку на источник»; игрового
159 раздела со страницами игр нет.
160- **GameFAQs** — соглашение запрещает автоматический сбор прямо.
161
162## Заимствования из StartWine
163
164Код StartWine (GPL-3.0) использовался как референс. Что именно взято:
165
166- **Состав и семантика 53 настроек** — выверено по
167 `data/scripts/sw_runlib` версии 423. Реестр в `settings.rs` описывает те же
168 переменные своими словами; значения и поведение проверялись по коду.
169- **Список библиотек d3dx9_24…d3dx9_43** и симметричная логика обратного
170 оверрайда при выключении — `sw_runlib:568`.
171- **Переменные для старого OpenGL** (`MESA_EXTENSION_MAX_YEAR=2003`,
172 `__GL_ExtensionStringVersion=17700`) — `sw_runlib:1043`.
173- **Схема запуска lsfg-vk** (`ENABLE_LSFG`, `LSFG_PROCESS`, `LSFGVK_CONFIG`) —
174 `sw_runlib:1048`.
175
176Авторы StartWine: Maslov N.G., Normatov R.R. Проект:
177[StartWine-Launcher](https://github.com/RusNor/StartWine-Launcher).
178
179Каналы проекта — те же ссылки, что показывает раздел «О программе»
180(`chl_core::about::STARTWINE_LINKS`). Взяты не по памяти и не по шаблону, а
181с самой страницы проекта `startwine-launcher.ru`, где они подписаны как его
182каналы (проверено 2026-09-07); git — тот же адрес, что в `origin` их
183репозитория:
184
185- [Исходники](https://github.com/RusNor/StartWine-Launcher)
186- [Telegram](https://t.me/StartWine)
187- [Сообщество ВКонтакте](https://vk.com/club225021002)
188- [Сайт проекта](https://startwine-launcher.ru/)
189