427 строк · 42 КиБ
PRIVACY.md
| 1 | # Приватность |
| 2 | |
| 3 | Коротко: Chimera-Launcher не собирает и никуда не отправляет |
| 4 | телеметрию, не ведёт скрытый лог твоих действий и не делает в фоне |
| 5 | ничего, кроме того, что прямо описано ниже. Нажатие кнопки делает ровно |
| 6 | то, что написано на кнопке — не больше. |
| 7 | |
| 8 | Это не маркетинговый текст, а список того, что реально происходит в |
| 9 | коде, с конкретными файлами, если захочешь проверить сам. |
| 10 | |
| 11 | ## Чего нет вообще |
| 12 | |
| 13 | - Никакой аналитики, телеметрии, crash-reporting SDK, "статистики |
| 14 | использования" — в кодовой базе нет ни одной такой зависимости. |
| 15 | - Никакого центрального сервера Chimera-Launcher, куда стекались бы |
| 16 | данные всех пользователей. У проекта нет "облака" в этом смысле. |
| 17 | - Никакого журнала действий, который писался бы куда-то помимо твоего |
| 18 | собственного диска и с целью, отличной от самой функции (см. ниже |
| 19 | про статистику наигранного времени — она видна только тебе). |
| 20 | |
| 21 | ## Что хранится локально, у тебя на диске |
| 22 | |
| 23 | - Библиотека игр, настройки — обычные файлы в `~/.config/chimera-launcher` |
| 24 | и `~/.local/share/chimera-launcher` (`chl_core::paths::Dirs`). |
| 25 | - Наигранное время и число запусков (`chl_core::state`) — только чтобы |
| 26 | показать тебе самому на странице игры. Никуда не отправляется, кроме |
| 27 | единственного явного случая ниже (кнопка "Поделиться своим опытом"). |
| 28 | |
| 29 | ## Что реально уходит по сети — и когда |
| 30 | |
| 31 | Не "никогда", а честно, по конкретным случаям: |
| 32 | |
| 33 | - **Steam** (`chl_steam`) — поиск обложки по названию игры и её загрузка |
| 34 | идут в открытую витрину store.steampowered.com/CDN Steam, тем же |
| 35 | путём, каким это делает браузер. Отправляется только название игры. |
| 36 | - **Epic Games Store** (`chl_epic`) — обращение к официальному API Epic |
| 37 | происходит, когда открываешь раздел "Epic Games" (вход, список игр). |
| 38 | Токен входа хранится файлом с правами 0600 (доступен только тебе) в |
| 39 | `~/.config/chimera-launcher/credentials` — не в системной связке ключей |
| 40 | (`secret-tool`/Secret Service): она не гарантированно есть на любом |
| 41 | Linux-рабочем столе (минимальные оконные менеджеры, часть настроек |
| 42 | Steam Deck), а лаунчер должен работать на любом дистрибутиве и у |
| 43 | любого пользователя. Удаляется полностью при удалении программы. |
| 44 | - **GOG.com** (`chl_gog`) — то же самое: токен тем же способом, в том же |
| 45 | каталоге, при открытии раздела "GOG.com". |
| 46 | - **Автопоиск обложки** (`chl_covers`) — при открытии раздела "Библиотека" |
| 47 | (и сразу после добавления игр — через «Сканировать папку» или по итогам |
| 48 | установки из установщика) лончер сам ищет обложку по названию для игр |
| 49 | без своей картинки: |
| 50 | Steam/Epic/GOG сюда не попадают, у них обложка уже из своего магазина. |
| 51 | Пробует по очереди четыре источника — открытую витрину |
| 52 | store.steampowered.com, каталог catalog.gog.com, статью в Википедии, |
| 53 | поиск по файлам Wikimedia Commons; ни один не требует ключа или |
| 54 | регистрации. Отправляется только название игры. Один из источников |
| 55 | недоступен (например, заблокирован без VPN) — просто пробуется |
| 56 | следующий, без остановки и без предупреждений. SteamGridDB — тоже |
| 57 | возможный источник, но только для тех, кто сам завёл переменную |
| 58 | окружения `STEAMGRIDDB_API_KEY`; в интерфейсе про него ничего нет и |
| 59 | вводить туда нечего. |
| 60 | - **База знаний** (`chl_kb`) — раздел на странице игры: прохождения, |
| 61 | советы, гайды, сюжет и управление, разложенные по этим заголовкам |
| 62 | («Проблемы и фиксы» — заголовок остался, источника у него больше нет, |
| 63 | см. ниже). **Выключено по умолчанию** и включается один раз — |
| 64 | переключателем «Настройки лончера» → «База знаний» или кнопкой |
| 65 | «Включить загрузку базы знаний» прямо в разделе (одна и та же настройка, |
| 66 | `kb_fetch_enabled` в `global.toml`). Пока не включено, лончер туда не |
| 67 | ходит вовсе. После включения — только при открытии страницы конкретной |
| 68 | игры и только для неё; в сеть уходит название этой игры (у игр из Steam |
| 69 | — ещё и `steam_appid`, см. раздел «Совместимость» ниже) и больше ничего. |
| 70 | Ничего не скачивается заранее и для всей библиотеки сразу. Результат |
| 71 | лежит в `~/.cache/chimera-launcher/kb` (`<игра>.json` + каталог |
| 72 | картинок, обычно сотни килобайт на игру), повторное открытие страницы — |
| 73 | с диска, «Обновить» скачивает заново. В файле кэша стоит **номер набора |
| 74 | источников** (`schema`): файл, набранный по прежним правилам отбора, не |
| 75 | показывается, а скачивается заново. Без этого смена правил действовала |
| 76 | бы только на игры, которых человек ещё не открывал — так и вышло |
| 77 | 2026-09-07, когда загрузку уже сделали русскоязычной, а на экране |
| 78 | остались английские статьи из старого кэша. |
| 79 | |
| 80 | **Источники русскоязычные, и исключений нет** — по прямой просьбе |
| 81 | требования к лончеру: «Базы знаний по играм, надо брать только из |
| 82 | русскоязычных источников. Чтобы не было проблем с доступами и языковых |
| 83 | барьеров», и затем прямо: «только русскоязычные ресурсы и данные |
| 84 | затащить». |
| 85 | |
| 86 | | Источник | Что берётся | Лицензия | |
| 87 | |---|---|---| |
| 88 | | **Русская вики самой игры** — русский раздел на Fandom (`gothic.fandom.com/ru`, `metro.fandom.com/ru`, `stalker.fandom.com/ru`, `gta.fandom.com/ru`) или русская вики со своим адресом (`vedmak.fandom.com`, `ru.minecraft.wiki`, `terraria.wiki.gg/ru`) | страницы квестов и миссий («Прохождение»), сюжет, механики, советы | своя у каждой; **язык и лицензия читаются с самой вики** (`meta=siteinfo`), и текст берётся, только если язык — русский, а лицензия — Creative Commons | |
| 89 | | **Русская Википедия** | короткий блок «Об игре», картинки и русское название игры | CC BY-SA 4.0 | |
| 90 | | **Русские игровые издания** — `vgtimes.ru`, `www.playground.ru`, `goha.ru`, `ixbt.games` | **только адрес страницы этой игры и её заголовок**. Ни строчки их текста | лицензии на переиспользование нет ни у одного, поэтому текст и не берётся; ссылка с заголовком статьёй не является | |
| 91 | |
| 92 | **Про издания подробнее — что именно уходит и что не берётся.** По |
| 93 | одному запросу на издание, по адресу вида `vgtimes.ru/games/<игра>/guides/`, |
| 94 | собранному из названия игры прямо на машине. Оттуда читается только |
| 95 | заголовок страницы — чтобы убедиться, что это страница нужной игры, а не |
| 96 | соседней части серии и не отданная с кодом 200 страница ошибки (у |
| 97 | VGTimes и PlayGround бывает именно так). Ни текст, ни картинки, ни |
| 98 | комментарии не скачиваются и в кэш не попадают. Поисковая выдача изданий |
| 99 | не запрашивается вовсе: `robots.txt` у PlayGround, StopGame, |
| 100 | «Игромании» и «Канобу» закрывает `/search/`. |
| 101 | |
| 102 | К **StopGame, DTF, «Игромании» и «Канобу» лончер не ходит ни за чем** — |
| 103 | их пользовательские соглашения запрещают автоматический доступ прямым |
| 104 | текстом (StopGame п. 5.2.6, DTF п. 5.3.8; «Игромания» и «Канобу» — |
| 105 | «не использовать автоматические механизмы… агенты, автоматические |
| 106 | устройства, скрипты или «пауки»»). Обходить это лончер не будет, в том |
| 107 | числе подстраиваясь под чужое имя: `robots.txt` «Игромании» и «Канобу» |
| 108 | разрешает `GPTBot` и `ClaudeBot`, но лончер не они. Полный разбор всех |
| 109 | кандидатов с цитатами — `REFERENCES.md` и шапка |
| 110 | `chl-kb/src/editorial.rs`. |
| 111 | |
| 112 | **Совместимость с Linux/Proton** — тот же раздел «База знаний», третий |
| 113 | независимый блок: заведётся ли игра вообще. Спрашивается только у игр |
| 114 | со `steam_appid` (запись в библиотеке от Steam, а не заведённая вручную) |
| 115 | и только вместе с остальной базой знаний — своего переключателя нет. |
| 116 | Источники здесь **англоязычные**, и это не отступление от правила |
| 117 | «только по-русски», а его точная граница: правило защищает от языкового |
| 118 | барьера в длинном тексте (прохождение, гайд), а не в одном статусе из |
| 119 | закрытого списка значений — его лончер переводит сам, на экране всегда |
| 120 | русское слово, а не английский токен (подробно — шапки |
| 121 | `chl-kb/src/protondb.rs`, `chl-kb/src/anticheat.rs`, |
| 122 | `chl-kb/src/steamdeck.rs`). |
| 123 | |
| 124 | | Источник | В сеть уходит | Что приходит обратно | |
| 125 | |---|---|---| |
| 126 | | **ProtonDB** — сводка отчётов сообщества | `steam_appid` | вердикт («золото», «платина» и т. д.) | |
| 127 | | **Are We Anti-Cheat Yet** — держит ли анти-чит игры Linux вообще | ничего сверх названия игры — файл со всем списком общий для всех игр | статус («работает», «не работает», «неофициально» и т. д.) и какой именно анти-чит | |
| 128 | | **Steam Deck** — вердикт самого Valve | `steam_appid` | категория («проверено», «играбельно» и т. д.) | |
| 129 | |
| 130 | Ничего из этого не подписывается — ни аккаунтом Steam, ни IP отдельно от |
| 131 | обычного заголовка HTTP‑запроса, который есть у любого сетевого клиента. |
| 132 | |
| 133 | Язык, с которым вики прочитали, кладётся в саму запись кэша и |
| 134 | проверяется ещё раз при чтении файла. По хосту его не угадать: тот же |
| 135 | `gta.fandom.com` — это и русская «Grand Theft Wiki» (путь `/ru`), и |
| 136 | английская «GTA Wiki», а `crimsondesert.fandom.com` на запрос |
| 137 | `/ru/api.php` отвечает своей английской вики. |
| 138 | |
| 139 | **Зачем базе знаний Википедия, если статью про игру решили не брать.** |
| 140 | Во-первых, это единственный источник картинок, которые можно законно |
| 141 | положить в свой кэш. Во-вторых — и это важнее — она даёт **русское |
| 142 | название игры**: «The Witcher 3: Wild Hunt» и «Ведьмак 3: Дикая Охота» |
| 143 | не имеют ни одного общего слова, и без этого русская вики «Ведьмака» по |
| 144 | названию из библиотеки не находится вовсе. Спрашивается это одним |
| 145 | запросом (`titles=…&redirects=1`), то есть переводом занимается сама |
| 146 | Википедия, а не лончер. |
| 147 | |
| 148 | Картинки скачиваются только с Wikimedia Commons — файлы, залитые в сам |
| 149 | раздел Википедии (обычно обложки по fair use), не берутся. У каждой |
| 150 | статьи и картинки в интерфейсе стоит ссылка на первоисточник и |
| 151 | лицензия — это условие лицензий, а не оформление. |
| 152 | |
| 153 | **Не используются, и почему именно:** |
| 154 | |
| 155 | - **PCGamingWiki** (`pcgamingwiki.com`, CC BY-NC-SA 3.0) — **убрана |
| 156 | целиком 2026-09-07.** Была единственным англоязычным источником и |
| 157 | единственным поставщиком «Управления» и «Проблем и фиксов» (убрать |
| 158 | лаунчер, поддержка ультраширокого экрана, что правится под Wine). |
| 159 | Держалась на доводе «русского аналога такому справочнику нет ни |
| 160 | одного, а `--skip-launcher` читается одинаково на любом языке» — |
| 161 | этот довод отклонён, правило подтверждено без исключений. |
| 162 | Следствие названо прямо, а не спрятано: **«Проблемы и фиксы» теперь |
| 163 | не приходят ни с одного источника**, а **«Управление» — только если |
| 164 | такой раздел есть на русской вики самой игры**. Пустые разделы в |
| 165 | интерфейсе так и подписаны («Пока нет статей: …»), а не убраны с |
| 166 | экрана. |
| 167 | - **Текст русских игровых изданий** — ни у одного нет лицензии на |
| 168 | переиспользование, поэтому в базе знаний его нет и не будет, сколько |
| 169 | бы прохождений там ни лежало. Раньше здесь стояло, что эти сайты «не |
| 170 | берутся» вообще; после разбора 2026-09-07 формулировка исправлена: |
| 171 | **ссылка с заголовком — не воспроизведение статьи**, и у части |
| 172 | изданий (VGTimes, PlayGround, GoHa, IXBT Games) соглашение |
| 173 | автоматический доступ не запрещает — с них берётся адрес, см. таблицу |
| 174 | выше. У StopGame, DTF, «Игромании» и «Канобу» запрет есть, и туда |
| 175 | лончер не ходит вовсе. |
| 176 | - **«Лучшие компьютерные игры»** (`lki.ru`) — единственный источник во |
| 177 | всём разборе, у которого **разрешение на переиспользование текста |
| 178 | есть**: `info.php?subj=sotrudnichestvo` разрешает размещать |
| 179 | «руководства, прохождения, новости и другие материалы» при условии |
| 180 | подписи «публикуется с разрешения редакции журнала…» и ссылки. Не |
| 181 | подключён потому, что журнал закрыт в январе 2012 года и ни одной |
| 182 | нужных игр там нет, поиск по игре на сайте мёртв, а сам сайт |
| 183 | живёт только по HTTP и в windows-1251. Условия «>5 материалов — |
| 184 | баннер у себя на главной» и «сообщить на webmaster@lki.ru» — решение |
| 185 | живой проверки, а не догадки. |
| 186 | - **GameFAQs** — то же самое: пользовательское соглашение прямо |
| 187 | запрещает автоматический сбор. |
| 188 | - **Викиучебник** (`ru.wikibooks.org`) — лицензия подходящая |
| 189 | (CC BY-SA 4.0), но по нужным играм там пусто. Живой поиск |
| 190 | 2026-09-07 по «Gothic», «Red Dead Redemption», «Metro Exodus», |
| 191 | «S.T.A.L.K.E.R.», «The Witcher», «Prince of Persia» не дал ни одной |
| 192 | игровой страницы (руководства там есть — на Doom, Wolfenstein 3D, |
| 193 | Spore — но не на то, во что играют на этой машине). Держать источник ради |
| 194 | нуля результатов незачем. |
| 195 | - **StrategyWiki** (`strategywiki.org`) — **убрана целиком.** Была |
| 196 | главным источником прохождений, но, во-первых, англоязычная, то есть |
| 197 | под новое требование не подходит; во-вторых, сайт закрыт Cloudflare и |
| 198 | отдаёт 403 любому клиенту по HTTP/1.1 (лончер ходит через `ureq`, а он |
| 199 | только HTTP/1.1; проверено 2026-09-06: `curl --http1.1` → 403, |
| 200 | `--http2` → 200 при том же User-Agent). Специально обходить защиту от |
| 201 | ботов ради этого источника не стали и не станем — тащить в лончер |
| 202 | второй HTTP-клиент только затем, чтобы не попасться проверке, это и |
| 203 | есть обход, а не «поддержка протокола». |
| 204 | - **Английская Википедия** — отката на неё больше нет: «по-русски |
| 205 | статьи нет, покажем английскую» — ровно тот языковой барьер, который |
| 206 | и просили убрать. |
| 207 | - Любая вики, чья лицензия не Creative Commons или чей язык не русский. |
| 208 | |
| 209 | Ходим только в `api.php` этих сайтов; HTML-страницы не скребём. |
| 210 | - **GitHub** (`GloriousEggroll/proton-ge-custom`, `Kron4ek/Wine-Builds`, |
| 211 | `PhialsBasement/wine-adobe-installers`) — только когда ты сам нажимаешь |
| 212 | "Установить"/"Обновить" сборку Wine или Proton, включая отдельный канал |
| 213 | «Wine для Adobe» на странице «Сборки Wine». |
| 214 | - **GitHub, ещё раз** (`legendary-gl/legendary`) — только когда на |
| 215 | странице Epic-игры нет кнопки "Установить" (нет ни своей, ни системной |
| 216 | копии `legendary`) и ты сам нажимаешь "Скачать legendary". Качается |
| 217 | официальный релиз, сверяется по контрольной сумме, которую сообщает |
| 218 | сам GitHub API (не выдуманной нами и не со стороннего зеркала), и |
| 219 | кладётся в `~/.local/share/chimera-launcher/tools/legendary` — не |
| 220 | системно, не для всех пользователей машины. Тот же приём, что |
| 221 | использует Heroic Games Launcher (`chl_epic::legendary`). |
| 222 | - **GitHub, ещё раз** (`dscharrer/innoextract`) — только когда на |
| 223 | карточке GOG-игры нет кнопки "Установить" (нет ни своей, ни системной |
| 224 | копии `innoextract`) и ты сам нажимаешь "Скачать innoextract". Качается |
| 225 | официальный релиз и кладётся в |
| 226 | `~/.local/share/chimera-launcher/tools/innoextract` — не системно, не |
| 227 | для всех пользователей машины. Проверяется не суммой (GitHub не |
| 228 | публикует её для этого релиза), а detached-подписью автора |
| 229 | (встроенный публичный ключ, отпечаток сверен независимо — подробности в |
| 230 | `chl_gog::innoextract`). |
| 231 | - **`lampa.mx`** — медиацентр Lampa, вкладка «Лампа» на странице «Медиа». |
| 232 | Это не наш запрос: лаунчер показывает сайт Lampa во встроенном WebKit — |
| 233 | ровно то же, что произошло бы, открой ты `lampa.mx` в браузере. В сеть |
| 234 | ничего не уходит, пока ты не откроешь эту вкладку; ничего не качается и |
| 235 | не ставится ни в систему, ни в каталог лаунчера. Что делает дальше сама |
| 236 | Lampa (её источники, TMDB, TorrServer) — её дело и её настройки, не |
| 237 | лончера, и настраивается внутри неё же. Единственное, что лаунчер в неё |
| 238 | добавляет, — значения по умолчанию в её собственном `localStorage` |
| 239 | («я на десктопе», внешний плеер) и мостик, которым Lampa просит открыть |
| 240 | фильм: адрес уходит системному видеоплееру, и больше никуда |
| 241 | (`chl_gui::lampa_page`). Раньше здесь качалась и обновлялась |
| 242 | Electron-обёртка `Kolovatoff/lampa-desktop` с GitHub — теперь не |
| 243 | качается ничего, и исключения из правила «в сеть только по нажатию» |
| 244 | больше нет. |
| 245 | - **Витрины Epic/GOG/Steam** (раздел «Магазины») — тот же приём, что у |
| 246 | Lampa выше: встроенный WebKit показывает настоящий сайт магазина, а не |
| 247 | пересказ через API лончера. Купленные игры показывает библиотека, вход |
| 248 | в аккаунты — раздел «Аккаунты» (OAuth `chl_gog`/`chl_epic::auth`), у |
| 249 | него свой пункт ниже. Вход внутри самой витрины переживает перезапуск |
| 250 | лончера: у витрин свой каталог cookies и данных сайта, |
| 251 | `~/.local/share/chimera-launcher/store-browser`, отдельно и от системного |
| 252 | умолчания WebKit (общего на любое приложение на машине, ничем не |
| 253 | подписанного), и от Lampa (у неё своё). Один каталог на три магазина, |
| 254 | не три: домены разные, куки между ними и так не пересекаются политикой |
| 255 | браузера same-origin. С 2026-09-12 хранение cookies задано явно — до |
| 256 | этого в комментарии к коду стояло, что WebKitGTK пишет их на диск сам, |
| 257 | и это было неверно: файла с ними в каталоге не было вовсе, а вход жил |
| 258 | до закрытия лончера. |
| 259 | |
| 260 | Витрины открываются **под тем же аккаунтом**, в который вошли, — и |
| 261 | делается это по-разному: |
| 262 | - **Epic** — токен лончера меняется на одноразовый код обмена (тот же |
| 263 | эндпоинт `account/api/oauth/exchange`, которым `legendary` |
| 264 | синхронизирует свою сессию), а страница `epicgames.com/id/exchange` |
| 265 | меняет код на cookies сайта. Пароль здесь не участвует. |
| 266 | - **GOG** — публичного обмена токена на сессию сайта у GOG нет. Вход в |
| 267 | аккаунт идёт через тот же каталог cookies, что и витрина, поэтому |
| 268 | одного входа хватает на оба места; пока его нет, витрина честно |
| 269 | говорит об этом и предлагает войти. |
| 270 | - **Steam** — лончер в аккаунт Steam не входит вовсе и токена не имеет. |
| 271 | Зато на этой же машине уже вошёл клиент Steam, и его встроенный |
| 272 | браузер хранит cookies обычным для Chromium способом — файлом SQLite |
| 273 | в каталоге клиента. Лончер **читает этот локальный файл** (только на |
| 274 | чтение и копией — клиент держит на нём блокировку) и берёт из него |
| 275 | ровно пять cookies входа с двух доменов `store.steampowered.com` и |
| 276 | `steamcommunity.com`. Значения зашифрованы запасным ключом Chromium |
| 277 | (фиксированный пароль `peanuts` — документированный путь самого |
| 278 | Chromium, когда связки ключей рабочего стола нет; у клиента Steam её |
| 279 | и нет, в его `Local State` отсутствует раздел `os_crypt`). |
| 280 | |
| 281 | **Куда это попадает:** только в сессию встроенной витрины, в том же |
| 282 | окне. Никуда не отправляется — ни на сервер проекта, ни в журнал, ни |
| 283 | в отчёты о проблеме. Пароля в этом файле нет и он недоступен. |
| 284 | **Что может пойти не так:** cookie сессии — это вход в аккаунт, и |
| 285 | Valve вправе посчитать её использование двумя браузерами поводом |
| 286 | сессию прекратить; тогда клиент Steam попросит войти заново. |
| 287 | Выключается настройкой `steam_webauth` («Настройки лончера»). |
| 288 | - **Проверка новой версии самого лаунчера** (`chl_selfupdate`) — при |
| 289 | запуске, в фоне, если включена настройка «Проверять новую версию при |
| 290 | запуске» (`self_update_check` в `global.toml`). **Включена по |
| 291 | умолчанию** — единственный пункт этого списка, про который так сказано, и |
| 292 | вот почему это не противоречие правилу «в сеть только по нажатию». |
| 293 | Уходит **обычный анонимный GET одного статического файла** — подписанного |
| 294 | манифеста релиза по адресу из настройки `update_feed_url` (по умолчанию |
| 295 | `compat.project-chimera.ru`, тот же личный хост проекта, что ниже, — |
| 296 | публичный, а не только домашняя сеть, с 2026-09-08). |
| 297 | Не отправляется **ничего**: ни название игры, ни список библиотеки, ни |
| 298 | версия системы, ни токен — в том числе `compat_api_token`, специально: |
| 299 | токен дал бы серверу возможность отличать запросы друг от друга, то есть |
| 300 | завёл бы телеметрию побочным эффектом. |
| 301 | |
| 302 | Скачивание и установка обновления — **никогда автоматически**. Уведомление |
| 303 | ведёт в раздел «Обновления», где выбор из трёх: поставить сейчас, потом, |
| 304 | пропустить эту версию. Подлинность держится на подписи ed25519, которую |
| 305 | проверяет вшитый в бинарник публичный ключ (тот же, что у манифеста |
| 306 | сборок Wine), плюс sha256 каждого файла из подписанного манифеста; пока |
| 307 | ключ в сборку не зашит, обновление не устанавливается вовсе. |
| 308 | |
| 309 | Выключается в двух местах, это одна и та же настройка: «Настройки |
| 310 | лончера» → «Обновление лаунчера» и «Обновления» → «Проверять при |
| 311 | запуске». Выключенная, она не мешает проверить вручную кнопкой или |
| 312 | командой `chl update --check` — это уже прямое действие человека. |
| 313 | - **Твой собственный сервер совместимости** (`chl_compat`, |
| 314 | `compat.project-chimera.ru`) — единственный адрес в этом списке, |
| 315 | который не принадлежит Valve/Epic/GOG/GitHub, а личной инфраструктуре |
| 316 | инфраструктуре проекта. До 2026-09-08 отвечал только внутри домашней |
| 317 | сети проекта (`chimera-compat.chimera.local`), теперь — по настоящему |
| 318 | публичному адресу. Два случая: |
| 319 | - лаунчер **сам, без нажатия кнопки**, спрашивает у этого сервера, есть |
| 320 | ли у сообщества подтверждённый рабочий профиль (wine + настройки) для |
| 321 | игры — отправляется только её название. Это происходит в двух местах: |
| 322 | при открытии страницы не-Steam игры и при первом запуске игры, у |
| 323 | которой ещё нет своих настроек. Запрос делается **один раз на игру**: |
| 324 | полученная рекомендация ложится файлом |
| 325 | (`~/.config/chimera-launcher/community/<игра>.toml`), и дальше в сеть |
| 326 | за ней не ходят. Рекомендация не перебивает твои настройки никогда — |
| 327 | у игры, где ты что-то выставил руками, её вообще не спрашивают; |
| 328 | - кнопка "Поделиться своим опытом" отправляет туда же то, что ты сам |
| 329 | видишь на экране: текущий wine, изменённые относительно дефолта |
| 330 | настройки, и вердикт, который ты выбрал. Ничего сверх этого — |
| 331 | ни имени пользователя, ни списка остальных игр, ни системной |
| 332 | информации. |
| 333 | |
| 334 | - **Отчёт о проблеме** (`chl_report`, «Диагностика» → «Отправить отчёт», |
| 335 | `chl report`) — туда же, на `compat.project-chimera.ru`, и **только |
| 336 | по нажатию кнопки «Отправить на сервер»**. Кнопка «Сохранить файлом» |
| 337 | рядом в сеть не ходит вовсе. |
| 338 | |
| 339 | Устроено так нарочно: отчёт **всегда сначала ложится файлом** в |
| 340 | `~/.local/state/chimera-launcher/reports/` двумя файлами (`.json` и |
| 341 | `.txt` — тот же текст, что был в предпросмотре), и только потом, |
| 342 | отдельным нажатием, уходит. До 2026-09-08 у этого была практическая |
| 343 | причина — адрес разрешался только в домашней сети проекта, и |
| 344 | снаружи (например, у друга с тестовым Steam Deck) отправка была |
| 345 | обречена всегда. Теперь сервер отвечает публично, но правило |
| 346 | остаётся: сеть у человека может не быть вообще, сервер — быть |
| 347 | временно недоступен, а тихой очереди «дослать потом» в проекте |
| 348 | сознательно нет. |
| 349 | |
| 350 | **Что уходит:** ровно то, что показано в предпросмотре, слово в слово — |
| 351 | предпросмотр и отправляемое собираются из одного и того же места. Какие |
| 352 | разделы собраны, решает выбранный симптом (не запускается / чёрный экран |
| 353 | / вылетает / тормозит / нет звука / геймпад / что-то не так в самом |
| 354 | лаунчере), и рядом с каждым разделом написано, зачем он собран под этот |
| 355 | симптом. **Любой раздел можно выключить перед отправкой.** Из чего |
| 356 | разделы состоят: версия лончера, дистрибутив, ядро, тип сессии; |
| 357 | видеокарты, драйверы, версия Vulkan, занятая видеопамять, подключённые |
| 358 | выходы; сборка Wine, префикс, размеры DLL рендера; изменённые (только |
| 359 | изменённые) настройки игры; название игры и история её запусков; хвост |
| 360 | вывода прошлого запуска и лог, который игра написала сама; проверки |
| 361 | «Диагностики»; для отчёта про геймпад — список устройств ввода и |
| 362 | переназначенные кнопки. |
| 363 | |
| 364 | **Что вычищается автоматически, до предпросмотра** (не «можно |
| 365 | включить», а всегда): домашний каталог заменяется на `~`, имя |
| 366 | пользователя — на `<пользователь>`, имя машины — на `<машина>`, токен |
| 367 | сервиса совместимости — на `<токен скрыт>`, любая шестнадцатеричная |
| 368 | строка от 32 символов — на `<похоже на ключ, скрыто>` (страховка на |
| 369 | случай чужого ключа в чужом логе). Что именно и сколько раз скрыто, |
| 370 | написано в самом отчёте отдельным разделом. `chl report --raw` чистку |
| 371 | отключает, но вместе с `--send` запрещён: непочищенный отчёт отправить |
| 372 | нельзя. |
| 373 | |
| 374 | **Чего в отчёте нет:** содержимого дампов памяти. Отчёты о сбоях, |
| 375 | которые оставила сама игра, называются путём и размером — внутрь лончер |
| 376 | не смотрит и не прикладывает их, потому что в дампе лежит память |
| 377 | процесса (то же решение и та же причина, что в |
| 378 | `chl_core::crash_reports`). Приложить сами файлы — отдельное решение |
| 379 | хозяина машины, руками. |
| 380 | |
| 381 | Чистка нарочно **не** пытается угадывать персональные данные вообще |
| 382 | (имена в текстах логов, адреса, номера): такой фильтр либо не находит |
| 383 | ничего, либо калечит диагностику, а главное — создаёт ложное чувство, |
| 384 | что отчёт «проверен». Поэтому вместо этого — полный предпросмотр и |
| 385 | возможность выкинуть раздел. |
| 386 | |
| 387 | Никакой отправки в фоне, никакой очереди «дослать, когда появится |
| 388 | сеть», никаких повторов: всё это означало бы отправку без человека. |
| 389 | |
| 390 | ## Steam LaunchOptions и другие правки чужих файлов |
| 391 | |
| 392 | Кнопка "Сохранить" на параметрах запуска Steam правит ровно один файл |
| 393 | (`localconfig.vdf`) и ровно одно значение внутри него — с резервной |
| 394 | копией перед записью. Никакой другой файл Steam (статистика игр, |
| 395 | друзья, настройки интерфейса) не читается и не трогается, кроме того, |
| 396 | что нужно прочитать, чтобы найти нужное место в этом одном файле |
| 397 | (`chl_steam::localconfig`, если интересна реализация). |
| 398 | |
| 399 | ## Диагностика (раздел "Диагностика") |
| 400 | |
| 401 | Проверки читают `/proc`, `/sys`, `/etc/os-release` и файловую систему — |
| 402 | всё локально, никуда не отправляется. Кнопка "Скопировать команду" |
| 403 | кладёт текст в буфер обмена и всё — установка пакета остаётся на тебе, |
| 404 | лаунчер сам ничего не ставит и не запрашивает root. |
| 405 | |
| 406 | На той же странице есть кнопка **"Отправить отчёт"** — единственное |
| 407 | место, откуда данные диагностики могут куда-то уйти, и только по |
| 408 | отдельному нажатию «Отправить на сервер» уже после того, как ты увидел |
| 409 | отчёт целиком. Подробно — выше, в пункте «Отчёт о проблеме» списка «Что |
| 410 | реально уходит по сети». Пока ты его не нажал, «Диагностика» остаётся |
| 411 | тем, чем была: чтением `/proc` и `/sys` без сети. |
| 412 | |
| 413 | ## Журнал запуска игры |
| 414 | |
| 415 | `chl run` (и кнопка «Играть», которая его вызывает) с некоторых пор |
| 416 | запоминает исход запуска: код возврата, сколько игра прожила, какой |
| 417 | сборкой запускалась и **последние 200 строк вывода** (до 64 КиБ) — в |
| 418 | `~/.local/state/chimera-launcher/runs/<игра>.toml`, одна запись на игру, |
| 419 | только последняя. |
| 420 | |
| 421 | Это локальный файл и ничего больше: он не отправляется сам никуда и ни |
| 422 | при каких условиях. Существует он ради отчёта о проблеме — раньше вывод |
| 423 | игры жил только в памяти интерфейса и умирал вместе с диалогом об |
| 424 | ошибке, и приложить к отчёту было нечего. Файл можно удалить в любой |
| 425 | момент: следующий запуск запишет новый, а отчёт просто скажет, что |
| 426 | журнала нет. |
| 427 |