403 строк · 28 КиБ
TESTING.md
| 1 | # Как это тестировать |
| 2 | |
| 3 | Версия 0.2.6. Что делалось по ночам и почему — в [`DEVLOG.md`](DEVLOG.md), |
| 4 | верхние записи. |
| 5 | |
| 6 | **Коротко, за вторую ночь:** новых больших кусков нет, зато прогнано руками |
| 7 | и глазами всё, что уже было. Нашлось и исправлено: живой фон съедал целое |
| 8 | ядро процессора (теперь 8%), запуск из интерфейса ждал завершения игры, |
| 9 | `chl env` показывал не тот префикс и не ту сборку, чем запускал `chl run`, |
| 10 | плитки в сетке разъезжались, игры Steam уходили в ярлыки Steam, Windows-Steam |
| 11 | не запускался, а четыре настройки выглядели рабочими, ничего не делая. |
| 12 | Появились: удаление сборок Wine и сообщение о вышедших новее, поиск по |
| 13 | библиотеке и по настройкам, чтение игр Epic от Heroic и legendary, снимок |
| 14 | перед патчем реестра, подсветка фокуса для геймпада. |
| 15 | |
| 16 | ## Общие настройки и Steam |
| 17 | |
| 18 | В «Настройках игры» выбери параметр, включая явное «выключено», и нажми |
| 19 | «Применить ко всем играм». В существующей игре соответствующее исключение |
| 20 | должно исчезнуть; остальные параметры, exe, префикс и архитектура сохраняются. |
| 21 | Рядом с изменённым конфигом появляется `.toml.before-global`. Повторное нажатие |
| 22 | ничего не меняет. Следующая правка общего значения действует и для этой игры, |
| 23 | и для новой записи библиотеки. Сброс общего параметра не снимает исключения |
| 24 | в игре: массово применяются только явно выбранные общие значения. |
| 25 | |
| 26 | В поле «Дополнительные параметры Steam» проверь строку |
| 27 | `PROTON_LOG=1 %command% -windowed`: переменная должна дойти до запуска, |
| 28 | аргумент — сохраниться целиком, а правка строки — примениться при следующем |
| 29 | запуске без перезапуска Steam. Требуется подключённая обёртка Chimera Launcher; |
| 30 | её настройка доступна на этой же странице. Служебные вызовы Proton `run` |
| 31 | не получают дополнительную строку. Старые параметры в самом Steam остаются |
| 32 | в силе; новый общий шаблон хранится в `global-game-settings.toml`. |
| 33 | |
| 34 | ## Запуск |
| 35 | |
| 36 | Программа установлена, ярлык в меню приложений есть: |
| 37 | |
| 38 | ```bash |
| 39 | chimera-launcher # интерфейс |
| 40 | chl --help # то же самое из терминала |
| 41 | ``` |
| 42 | |
| 43 | Если что-то пересобрал сам: |
| 44 | |
| 45 | ```bash |
| 46 | bash packaging/install.sh |
| 47 | ``` |
| 48 | |
| 49 | Ставится в домашний каталог, без sudo. Удаляется `packaging/uninstall.sh`, |
| 50 | данные при этом остаются. |
| 51 | |
| 52 | ## Что проверять, по порядку |
| 53 | |
| 54 | ### 1. Первый взгляд |
| 55 | |
| 56 | Открой `chimera-launcher`. Должно быть: |
| 57 | |
| 58 | - **Библиотека** — плитки с обложками Absolum и Hellforged Demo, подтянутыми |
| 59 | из твоего Steam. |
| 60 | - Слева семь разделов, у каждого значок. |
| 61 | - Под интерфейсом медленно плывут световые ленты, панели полупрозрачные. |
| 62 | |
| 63 | Строки поиска над сеткой сейчас нет — она появляется, начиная с двенадцати |
| 64 | игр. Проверял на подставной библиотеке из 204 игр: поиск появляется, |
| 65 | открытие раздела занимает 0,95 секунды вместо 0,55. |
| 66 | |
| 67 | **На что смотреть:** не рябит ли фон, не мешает ли движение, читается ли |
| 68 | текст поверх стекла. Это вкусовое, и правится в разделе «Внешний вид» — |
| 69 | шесть палитр, фон выключается, яркость регулируется. |
| 70 | |
| 71 | ### 2. Библиотека и запуск |
| 72 | |
| 73 | Нажми на плитку — откроется страница игры: широкая картинка, кнопка |
| 74 | «Запустить», сведения о том, чем именно игра запустится. |
| 75 | |
| 76 | **Игры Steam запускаются самим Steam**, а не нашим Wine. Это осознанно: |
| 77 | Steam подберёт Proton, включит облачные сохранения, оверлей и Steam Input. |
| 78 | Подменять его своим Wine значит всё это потерять и вдобавок получить |
| 79 | проблемы с античитами. |
| 80 | |
| 81 | Проверь: нажми «Запустить» на Absolum — должен подняться Steam и начать |
| 82 | игру. |
| 83 | |
| 84 | **Своя игра** (не из Steam) запускается нашим Wine: |
| 85 | |
| 86 | ```bash |
| 87 | chl add "/путь/к/игре.exe" |
| 88 | chl run <имя> |
| 89 | ``` |
| 90 | |
| 91 | Проверочная игра уже заведена: `chl run Сапёр` — встроенный «Сапёр» из Wine |
| 92 | в префиксе `pfx_default`. |
| 93 | |
| 94 | **Убрать игру** можно с её же страницы, внизу: «Убрать из библиотеки». |
| 95 | Файлы игры и префикс при этом остаются на диске — убирается только запись. |
| 96 | |
| 97 | ### 3. Настройки |
| 98 | |
| 99 | Раздел «Настройки». Сверху выбор игры, **уровня сложности** и **поиск**. На |
| 100 | «простом» видно 21 настройку из 67, остальные не спрятаны, но и не мешают. |
| 101 | |
| 102 | Поиск идёт по названию, описанию, «когда менять» и по старому имени из |
| 103 | StartWine: помнишь не «Масштабирование FSR», а «то, что понижает |
| 104 | разрешение», — найдётся и так. Уровень при поиске не учитывается: искать |
| 105 | настройку и не найти её потому, что она «экспертная», — это препятствие, а |
| 106 | не помощь. |
| 107 | |
| 108 | Для не-Steam игр на вкладке «Запуск» есть переключатели собственного |
| 109 | окружения: «Без видео Wine» добавляет `WINEDLLOVERRIDES=winegstreamer=`, |
| 110 | «Счётчик FPS (DXVK)» — `DXVK_HUD=fps`, «Без вертикальной синхронизации» — |
| 111 | `vblank_mode=0`. Произвольные переменные можно вписать в настройке |
| 112 | «Окружение запуска»; `chl run <игра> --dry-run` показывает итог отдельно. |
| 113 | |
| 114 | **Главное, что надо оценить:** под каждой настройкой написано, что она |
| 115 | делает. Разверни любую — там же «когда менять» и откуда взялось текущее |
| 116 | значение. |
| 117 | |
| 118 | Если хоть про одну настройку непонятно, зачем она, — **это баг и мне он |
| 119 | интереснее, чем сбой запуска**. Весь смысл проекта в том, чтобы такого |
| 120 | вопроса не возникало. |
| 121 | |
| 122 | ### 4. Магазины и Windows-Steam |
| 123 | |
| 124 | **Steam** — раздел «Магазины»: твоя библиотека, найденный Proton |
| 125 | Experimental, кнопка добавления игр Chimera в Steam ярлыками (это |
| 126 | единственный способ попасть в Game Mode на Steam Deck). |
| 127 | |
| 128 | Ярлыки пишутся аккуратно: чужие записи не трогаются, перед записью делается |
| 129 | резервная копия `.chl-backup`. После добавления Steam надо перезапустить — |
| 130 | он читает файл при старте. |
| 131 | |
| 132 | **Epic** — раздел «Магазин Epic»: настоящий сайт магазина внутри окна, с |
| 133 | навигацией. Работает без всякого входа, посмотреть можно прямо сейчас. |
| 134 | |
| 135 | **Windows-версия Steam** — там же, в разделе «Магазины». Ставится кнопкой: |
| 136 | скачивается официальный установщик Valve, создаётся отдельный префикс, |
| 137 | Steam устанавливается тихо. Уже установлен и заведён в библиотеке как |
| 138 | «Steam-Windows» — можно просто запустить. |
| 139 | |
| 140 | Это для старых игр, капризного DRM и лончеров без поддержки Proton. |
| 141 | Нативный Steam при этом остаётся: игры с античитами EAC и BattlEye работают |
| 142 | только через него. |
| 143 | |
| 144 | Вход в аккаунт Epic — отдельно: |
| 145 | |
| 146 | ```bash |
| 147 | chl epic login # напечатает адрес |
| 148 | # войти в браузере, скопировать authorizationCode |
| 149 | chl epic login <код> |
| 150 | chl epic list # библиотека Epic |
| 151 | ``` |
| 152 | |
| 153 | То же самое можно сделать не выходя из интерфейса: в разделе «Магазины» |
| 154 | кнопка «Открыть страницу входа» и поле, куда вставить код. Вставлять можно |
| 155 | что угодно — само значение, строку `"authorizationCode": "..."`, весь JSON |
| 156 | или адрес из строки браузера: код найдётся сам. |
| 157 | |
| 158 | **Пароль Epic я не вижу и не запрашиваю.** Ты входишь на сайте Epic в своём |
| 159 | браузере, лаунчер получает только одноразовый код, который ты отдаёшь сам. |
| 160 | Токен ложится в связку ключей системы, не в файл. |
| 161 | |
| 162 | **Игры Epic** ставятся кнопкой «Установить» через собственную копию |
| 163 | `legendary`; перед установкой лаунчер сверяет сессию legendary с входом |
| 164 | Chimera и показывает её состояние в разделе Epic. В карточке игры и в |
| 165 | `chl epic download` доступны параметры: каталог, число потоков, сетевой |
| 166 | таймаут, пропуск DLC, отключение delta-манифестов, repair/force и |
| 167 | предпочитаемый CDN. Обязательные аргументы Epic из `installed.json` |
| 168 | сохраняются в настройках игры: например, VAMPIR получает |
| 169 | `--executedbyepiclauncher=true`, и `chl run VAMPIR --dry-run` должен показать |
| 170 | его как `аргументы из конфига`. Установленные Heroic или legendary игры по-прежнему |
| 171 | подхватываются — `chl epic installed --import`, вход для этого не нужен. |
| 172 | |
| 173 | ### 5. Диагностика |
| 174 | |
| 175 | Раздел «Диагностика» или `chl doctor`. 26 проверок: Vulkan, видеокарты, |
| 176 | ntsync, локаль, лимиты, 32-битные библиотеки (включая GStreamer), инструменты, |
| 177 | файловая система, снимки префиксов, данные лаунчера. |
| 178 | |
| 179 | **Ничего не меняет** — только смотрит и объясняет, что делать. |
| 180 | |
| 181 | ### 6. Сборки Wine |
| 182 | |
| 183 | Раздел «Сборки Wine»: установлено, доступно по каналам, установка кнопкой. |
| 184 | Каналы названы по-человечески и с пояснением, чем отличаются. |
| 185 | |
| 186 | **Сборку видно, сколько она занимает, и её можно удалить** — занятую не |
| 187 | дадут, и напишут, кто её держит. **Про вышедшие обновления лаунчер |
| 188 | говорит сам:** рядом с установленной сборкой написано, что вышло новее, и |
| 189 | стоит кнопка «Поставить новее». Новая ставится рядом, а не вместо: старая |
| 190 | может быть единственной, на которой работает конкретная игра, поэтому |
| 191 | выбор сборки у игр не трогается. |
| 192 | |
| 193 | GE-Proton проверен вживую: сборка устроена иначе обычной (`files/bin/wine` |
| 194 | вместо `bin/wine`), лаунчер это распознаёт, префикс создаётся, запуск |
| 195 | проходит, ntsync поднимается. Установлены две сборки: `GE-Proton10-34` и |
| 196 | `wine-11.16-staging-amd64` — третья, `wine-11.15-staging-amd64`, была |
| 197 | удалена ночью при проверке удаления. |
| 198 | |
| 199 | **Префикс помнит, какой сборкой он собран** (файл `.chl-wine` внутри него). |
| 200 | Если в настройках игры сборка не задана, запуск возьмёт именно её, а не |
| 201 | случайную из установленных. Порядок: настройка игры, метка префикса, |
| 202 | единственная установленная. |
| 203 | |
| 204 | ### 7. Снимки префикса |
| 205 | |
| 206 | На странице любой игры не из Steam — раздел «Снимки префикса». Это замена |
| 207 | опасного бэкапа StartWine. |
| 208 | |
| 209 | ```bash |
| 210 | chl snapshot create pfx_default --label "перед экспериментом" |
| 211 | chl snapshot list pfx_default |
| 212 | chl snapshot restore <имя> pfx_default |
| 213 | ``` |
| 214 | |
| 215 | **Что проверить:** снимок 943-мегабайтного префикса делается за 0,1 секунды |
| 216 | и добавляет к занятому месту ноль байт — данные общие с префиксом. Откат |
| 217 | занимает четверть секунды. |
| 218 | |
| 219 | **Снимок делается сам** в двух случаях: перед сменой сборки Wine и перед |
| 220 | патчем реестра, который появился или изменился с прошлого запуска. Смени |
| 221 | сборку на странице игры и запусти — увидишь строку «делаю снимок префикса, |
| 222 | чтобы можно было вернуться». Повторный запуск без изменений снимка не |
| 223 | делает: снимать одно и то же при каждом старте значит засорять диск. |
| 224 | |
| 225 | ### 8. Клавиатура и геймпад |
| 226 | |
| 227 | Пройди по интерфейсу Tab и стрелками, не трогая мышь. У выбранной плитки и |
| 228 | у строк должна быть заметная обводка цветом палитры. |
| 229 | |
| 230 | Это не мелочь для Steam Deck: там интерфейс проходят геймпадом, а Steam |
| 231 | Input отдаёт его как клавиатуру и мышь. Не видно, где фокус, — значит |
| 232 | ходить по библиотеке нельзя вообще. Обводки не было совсем: собственный фон |
| 233 | плитки перекрывал штатную обводку libadwaita. |
| 234 | |
| 235 | ### 9. Внешний вид |
| 236 | |
| 237 | Шесть палитр с образцами цвета, выключаемый живой фон, регулировка яркости. |
| 238 | |
| 239 | **Про расход:** живой фон стоит около 8% одного ядра, без него — 0,3%. |
| 240 | Замерено. Первая версия съедала целое ядро, это было исправлено ночью |
| 241 | (рисование в уменьшенном холсте, 12 кадров в секунду вместо 30, таймер |
| 242 | вместо тиков композитора). Пока идёт игра, окно свёрнуто и фон не рисуется. |
| 243 | Всё применяется сразу: переключил палитру — фон под интерфейсом сменился |
| 244 | на этом же кадре. Выбирать цвет, который покажется только после |
| 245 | перезапуска, значит выбирать вслепую. |
| 246 | |
| 247 | ### 10. Нативные профили запуска |
| 248 | |
| 249 | Shell-профиль можно добавить как игру: `chl add /путь/test.sh --name "DayZ TEST"`. |
| 250 | Его shebang проверяется перед запуском; `chl run "DayZ TEST" --dry-run` |
| 251 | не исполняет скрипт. Настройки Wine к нативному скрипту не применяются. |
| 252 | |
| 253 | ### 11. «О программе» и «Обновления» |
| 254 | |
| 255 | Два раздела в группе «О лаунчере», внизу боковой панели. |
| 256 | |
| 257 | **«О программе»** — читается, а не проверяется кнопками. Что там должно |
| 258 | быть: первым разделом StartWine (не в списке библиотек внизу, а первым — так |
| 259 | и задумано), с рабочими ссылками на их git, Telegram и сообщество |
| 260 | ВКонтакте; версия и лицензия под названием; список того, на чём лаунчер |
| 261 | стоит, с лицензией у каждого пункта; ссылка на `PRIVACY.md` вместо копии |
| 262 | его списка. Тот же текст показывает `chl about` — если они разошлись, это |
| 263 | баг, а не оформление. |
| 264 | |
| 265 | **«Обновления»** — что проверить: |
| 266 | |
| 267 | - «Установлено»: версия и **каталог установки** — он должен совпадать с тем, |
| 268 | откуда лаунчер реально запущен (`which chimera-launcher`), а не с |
| 269 | `~/.local/bin` вслепую; |
| 270 | - строка с предупреждением «Установка обновлений недоступна в этой сборке» |
| 271 | **должна быть**, пока `keys/wine-manifest.pub` пуст. Это не поломка: без |
| 272 | вшитого ключа проверить подпись нечем, и обновление намеренно не ставится; |
| 273 | - «Проверить сейчас» вне LAN/VPN обязан сказать «до сервера обновлений не |
| 274 | дошли» и ничего больше — не ругаться и не подвешивать окно; |
| 275 | - «Что нового в этой сборке» — пять последних записей `DEVLOG.md`, |
| 276 | раскрывающихся; то же самое печатает `chl changelog`; |
| 277 | - переключатель «Проверять при запуске» — та же настройка, что в |
| 278 | «Настройках лончера» → «Обновление лаунчера». Переключил здесь — проверь, |
| 279 | что там тоже переключилось (файл один, `global.toml`). |
| 280 | |
| 281 | **Чего в этом разделе пока не увидеть на живой машине:** самого обновления. |
| 282 | Механизм готов и проверен, но раздачи по адресу по умолчанию ещё нет и |
| 283 | настоящего ключа владельца тоже — см. «Чего ещё нет» ниже. Проверять подмену |
| 284 | и откат сейчас можно только на выброшенном дереве: `chl update --status |
| 285 | --root <каталог>`, `--recover --root`, `--rollback --root`. **Не на своём |
| 286 | `~/.local/bin`.** |
| 287 | |
| 288 | ## Полный список команд |
| 289 | |
| 290 | ```bash |
| 291 | chl doctor [--all] диагностика |
| 292 | chl list [--import] библиотека |
| 293 | chl add <exe> [--name] [--prefix] |
| 294 | chl scan <dir> [--add] [--yes] [--depth N] |
| 295 | chl fix-paths [--apply] [--depth N] |
| 296 | chl dedupe [--apply] |
| 297 | chl rename-by-folder [--apply] |
| 298 | chl forget <игра> |
| 299 | chl run <игра> [--dry-run] [--exe путь] -- аргументы |
| 300 | chl env <игра> [--notes] окружение и расхождения с bash |
| 301 | chl settings [--tier simple] [--grep текст] |
| 302 | chl wine list | installed | install <сборка> | remove <сборка> |
| 303 | chl steam list | import | shortcuts | windows |
| 304 | chl epic login [код] | whoami | list | download | installed | logout |
| 305 | chl legacy info | list | show | verify | convert |
| 306 | chl snapshot create | list | restore | remove |
| 307 | chl dirs |
| 308 | chl about [--links] о программе, StartWine, лицензии |
| 309 | chl changelog [--game игра] [--limit N] |
| 310 | chl update --check | --notes | --apply | --status | --rollback | --recover |
| 311 | chl update --skip <версия> больше не сообщать про эту версию |
| 312 | chl update-manifest --version … --binaries … --base-url … (команда владельца) |
| 313 | ``` |
| 314 | |
| 315 | Интерфейс: `chimera-launcher [--page <раздел>] [--game <игра>] [--scan <каталог>] |
| 316 | [--fix-paths] [--rename-by-folder]`. |
| 317 | Разделы: `library`, `stats`, `media`, `epic`, `gog`, `steam`, `browser`, |
| 318 | `settings`, `wine`, `appearance`, `gamepad`, `launcher`, `backups`, `doctor`, |
| 319 | `updates`, `about`. |
| 320 | |
| 321 | ## Чего ещё нет — честно |
| 322 | |
| 323 | **Раздачи обновлений лаунчера.** Механизм самообновления написан и проверен |
| 324 | целиком (подпись, sha256, подмена по `rename`, откат, восстановление после |
| 325 | обрыва — см. ADR-012), но по адресу по умолчанию |
| 326 | `chimera-compat.chimera.local/release/chl-release.json` файла ещё нет, и |
| 327 | настоящего подписывающего ключа владельца тоже нет. Поэтому `chl update |
| 328 | --check` честно отвечает «до сервера не дошли», а установка отказывается |
| 329 | работать вслух. Два шага, которых не хватает: `chl wine manifest keygen` от |
| 330 | владельца (публичный ключ в `keys/wine-manifest.pub`, секретный — вне git) и |
| 331 | выложенный на хост `chl-release.json` + `.sig` рядом. |
| 332 | |
| 333 | **Скачивание игр Epic.** Установка ведёт собственная копия `legendary` — тот |
| 334 | же проверенный путь, что у Heroic. Своего чанкового загрузчика у лаунчера |
| 335 | нет, и не будет без возможности проверить его на живом аккаунте. Отмена |
| 336 | установки, отдельные команды `legendary update/verify` и хранение внутреннего |
| 337 | `app_name` Epic в формате библиотеки Chimera пока не обёрнуты. |
| 338 | |
| 339 | Игры Epic, уже скачанные Heroic или legendary, лаунчер находит, добавляет в |
| 340 | библиотеку и запускает — `chl epic installed --import` или кнопка в разделе |
| 341 | «Магазины». Вход в аккаунт для этого не нужен. Разбор `installed.json` |
| 342 | проверен в том числе на частично битом файле: одна плохая запись не должна |
| 343 | прячет остальные. |
| 344 | |
| 345 | **Одна настройка из 67 ничего не делает, и это видно на экране.** Она |
| 346 | показана неактивной, с прямо написанной причиной: |
| 347 | |
| 348 | - `controller` — не влияет ни на что и в самом StartWine: `sw_runlib` не |
| 349 | читает эту переменную ни разу. |
| 350 | |
| 351 | (`dgvoodoo2` и `disable_prefix_update` раньше были в этом списке — оба |
| 352 | портированы: `Prefix::apply_dgvoodoo2`/`set_update_disabled` в `chl-wine`, |
| 353 | вызываются из `chl run` в `chl-cli/src/main.rs`.) |
| 354 | |
| 355 | `chl env <игра> --notes` печатает тот же список. |
| 356 | |
| 357 | **Побайтовое сравнение с bash-версией не сделано.** Это критерий готовности |
| 358 | фазы 0, и для него нужны игры разных типов: DX11, DX12, OpenGL, 32-битная и |
| 359 | одна с внешним лончером. |
| 360 | |
| 361 | **Изоляции через bubblewrap нет.** `bwrap` в системе есть, обвязки нет. |
| 362 | |
| 363 | **Установка библиотек в префикс снимка не вызывает.** Смена сборки Wine и |
| 364 | патч реестра — вызывают. |
| 365 | |
| 366 | ## Два сознательных расхождения с StartWine |
| 367 | |
| 368 | Оба печатаются в `chl env <игра> --notes`: |
| 369 | |
| 370 | 1. **`fps_limit` работает независимо от оверлеев.** В StartWine своей |
| 371 | реализации нет: значение попадает либо в конфиг MangoHud, либо в |
| 372 | `DXVK_FRAME_RATE` внутри блока служебного оверлея DXVK. Выключи оба — и |
| 373 | настройка уровня «простой» молча перестаёт работать. |
| 374 | 2. **`vkbasalt` получает свой файл конфигурации на каждую игру.** StartWine |
| 375 | правит `sed`-ом один общий файл, поэтому игры перезаписывают настройки |
| 376 | друг друга. |
| 377 | |
| 378 | ## Что писать в отчёте |
| 379 | |
| 380 | Полезнее всего, в порядке ценности: |
| 381 | |
| 382 | 1. **Непонятно, что делает настройка** — описание плохое, это баг. |
| 383 | 2. **Игра не запускается**, а сообщение не объясняет почему. |
| 384 | 3. **Разница с StartWine** в поведении одной и той же игры. |
| 385 | 4. **Некрасиво или неудобно** — конкретно: что именно и на каком экране. |
| 386 | |
| 387 | ## Если что-то пошло не так |
| 388 | |
| 389 | Всё обратимо: |
| 390 | |
| 391 | ```bash |
| 392 | rm -rf ~/.config/chimera-launcher # конфиги игр, палитра |
| 393 | rm -rf ~/.local/share/chimera-launcher # библиотека |
| 394 | rm -rf ~/.cache/chimera-launcher # кэш, скачанные архивы, сборка |
| 395 | bash packaging/uninstall.sh # сама программа |
| 396 | ``` |
| 397 | |
| 398 | Префикс и сборки Wine лежат в `~/Games/StartWine/data/` — там же, где их |
| 399 | держит StartWine. |
| 400 | |
| 401 | Ярлыки в Steam: если что-то не так, рядом с `shortcuts.vdf` лежит |
| 402 | `shortcuts.vdf.chl-backup` — верни его и перезапусти Steam. |
| 403 |