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 | Три источника ниже — англоязычные, и это не отмена решения про |
| 106 | PCGamingWiki, а его точная граница: правило «только по-русски» защищает от |
| 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 |
| 126 | Commons ни у кого; но **ссылка с заголовком статьёй не является**, и там, |
| 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 |