134 строк · 12 КиБ
docs/PLAN-0.2.md
| 1 | # План 0.2 |
| 2 | |
| 3 | Семнадцать задач из OpenProject (проект Chimera Launcher, id 9, версия «0.2», |
| 4 | id 5), разбитых на пять направлений. Каждое направление ведёт своя сессия в |
| 5 | своём worktree. Выпуск один, общий, после всех пяти — не по частям. |
| 6 | |
| 7 | ## Общие правила для каждой сессии |
| 8 | |
| 9 | - Отвечать владельцу по-русски. Сначала прочитать `/home/fanchji/Yandex.Disk/HomeLab/project-chimera/CLAUDE.md` |
| 10 | и этот файл. |
| 11 | - **Свой worktree** от `main`: `git -C /home/fanchji/Projects/chimera-launcher worktree add |
| 12 | /home/fanchji/Projects/chimera-launcher-worktrees/<имя> -b 0.2/<имя> main`. |
| 13 | Свой `CARGO_TARGET_DIR=/home/fanchji/.cache/chimera-launcher-dev/target-<имя>`. |
| 14 | - **`cargo fmt` не запускать**: `rustfmt.toml` нет, стиль ручной, fmt переписывает |
| 15 | 70 файлов. Проверка — `cargo clippy --workspace --all-targets` (0 предупреждений) |
| 16 | и `cargo test --workspace` (все зелёные). Цепочкой `&&`, чтобы не закоммитить |
| 17 | упавшее. |
| 18 | - **Ничего не публиковать**: `packaging/publish-release.sh`, `deploy-site.sh`, |
| 19 | `push-mirror.sh` не запускать. Версию не поднимать — это сделает сборка выпуска. |
| 20 | - В коммитах, комментариях и документах — что и почему, без «владелец |
| 21 | попросил». Тексты интерфейса — коротко, без «не X, а Y», без канцелярита. |
| 22 | - **Проверять вживую, а не только тестами.** Как снимать окно, не трогая |
| 23 | экран владельца: |
| 24 | - `CHL_SCREENSHOT_DELAY=4000 CHL_WINDOW_WIDTH=1100 CHL_WINDOW_HEIGHT=720 |
| 25 | <бинарь> --page <id> [--game "<имя>"] --screenshot /абсолютный/путь.png` |
| 26 | (режим снимка — NON_UNIQUE, не уходит в запущенный у владельца лаунчер; |
| 27 | обычный запуск без `--screenshot` уходит в его окно — так не делать); |
| 28 | - настройки для снимков — копия в `XDG_CONFIG_HOME` без `credentials/` |
| 29 | (для системного шрифта ещё `GDK_DEBUG=no-portals` и `gtk-4.0/settings.ini` |
| 30 | без `gtk-xft-dpi`); `CHL_TAB`, `CHL_FAKE_DEPS`, `CHL_FAKE_ANTICHEAT`, |
| 31 | `CHL_FAKE_UPDATE`; |
| 32 | - **клики**: синтетические клики KWin в окна на экране владельца не |
| 33 | пропускает. Для проверки нажатий — вложенный `kwin_wayland --virtual |
| 34 | --xwayland --width 1400 --height 900`, внутри приложение с |
| 35 | `GDK_BACKEND=x11` и `DISPLAY` вложенного Xwayland, там `xdotool` работает; |
| 36 | снимать `import -window <id>` (по X-идентификатору) или `--screenshot`. |
| 37 | Весь экран не снимать никогда, `spectacle -a` не использовать (ловит |
| 38 | чужое активное окно). |
| 39 | - **Чужие процессы не трогать.** У владельца бывает запущена игра через |
| 40 | установленный лаунчер (WoW, gamescope). Перед любым `kill` сверить время |
| 41 | старта и бинарь; своё — только то, что запустили сами. |
| 42 | - Игры для проверки запусков — только свои тестовые exe или игры, про которые |
| 43 | владелец сказал «можно»; установки владельца (`~/.local/share/chimera-launcher/app`) |
| 44 | не менять — для самообновления и установки ставить в `--prefix` во временный |
| 45 | каталог с отдельными HOME/XDG. |
| 46 | - **OpenProject**: доступ через мастер (прямой kubectl не работает): |
| 47 | `nohup ssh chefanoff-doctor-master "sudo /opt/deckhouse/bin/kubectl --kubeconfig=/etc/kubernetes/admin.conf -n openproject port-forward svc/openproject 8131:8080" &` |
| 48 | и `ssh -f -N -o ExitOnForwardFailure=yes -L 8130:127.0.0.1:8131 chefanoff-doctor-master`; |
| 49 | ждать строки «Forwarding from» с `sleep 1` (частые подключения роняют |
| 50 | port-forward); API `http://127.0.0.1:8130/api/v3`, Basic `apikey` + |
| 51 | `12-keys/openproject-api-token.txt`, заголовки `Host: openproject.project-chimera.ru`, |
| 52 | `X-Forwarded-Proto: https`. Версия задачи — `_links.targetVersions` (поле |
| 53 | `version` API молча игнорирует). Закрывать: локальный ssh по PID из |
| 54 | `ps -eo pid,cmd` (не `pgrep -f` в той же команде — убьёт саму оболочку), |
| 55 | удалённый kubectl — `sudo kill` на мастере, сверив `lstart` (часы мастера в UTC). |
| 56 | - По каждой задаче: комментарий в задаче (что сделано, коммит, как проверено, |
| 57 | что не проверено), статус Closed (id 12), когда проверено вживую. |
| 58 | - Итог направления — запись в `DEVLOG.md` сверху. |
| 59 | - **Слияние в main**: `git rebase main` → clippy + test → `git -C <worktree main> |
| 60 | merge --ff-only 0.2/<имя>` (worktree с `main` — `/home/fanchji/Projects/chimera-launcher-worktrees/merge-main`). |
| 61 | Если main ушёл вперёд — снова rebase. Перед слиянием написать координатору. |
| 62 | - **Координатор** — сессия «Chimera-Launcher: обзор аналогов, интерфейс и |
| 63 | сжатие» (найти через `ListAgents`, писать `SendMessage`). Ему — отчёт после |
| 64 | каждой закрытой задачи одной строкой и итог направления. Если нужно тронуть |
| 65 | файл из чужого направления — сначала спросить координатора. |
| 66 | |
| 67 | ## Направления |
| 68 | |
| 69 | ### A. Библиотека и обложки — `0.2/library` |
| 70 | - **#391** — фильтры «магазин» и «наличие» ничего не отбирают (выбран Epic + |
| 71 | «Установленные», в сетке всё). Проверить, доходит ли выбор ToggleGroup |
| 72 | (`store_filter`, `filters_row`, `StatusFilter`) до `Shelf` и пересобирается ли |
| 73 | модель. Тест в общем gtk::init-тесте (`window.rs::интерфейс_собирается`). |
| 74 | - **#392** — название игры и обложки: нормализация названия, постер только 2:3, |
| 75 | без баннеров в карточке, «Подобрать обложку заново» с выбором вариантов, |
| 76 | «Своя картинка», `chl covers check|fix` по всей библиотеке. |
| 77 | - Файлы: `chl-gui/src/library.rs`, `lazy_covers.rs`, `crates/chl-covers`, |
| 78 | команды `chl covers` в `chl-cli`, страница игры — только кнопки обложки |
| 79 | (группа «Картинки»). |
| 80 | |
| 81 | ### B. Жизнь процесса игры — `0.2/process` |
| 82 | - **#393** — ручное «Завершить», в том числе зависшей и «потерянной» игры, |
| 83 | вместе с её Wine. Общий префикс: не `wineserver -k`; по запуску (scope / |
| 84 | номер запуска из 0.1.53: `chl ps`, `chl kill`, «Запущено сейчас»). Сначала |
| 85 | прочитать, что уже сделано в 0.1.53, и доделать недостающее. |
| 86 | - **#394** — несколько игр и программ одновременно не влияют друг на друга: |
| 87 | статусы, время в игре, автобэкап, обёртки, установка в занятый префикс. |
| 88 | Матрица проверки в задаче. |
| 89 | - **#378** — после выхода из игры окно висит ~10 с. |
| 90 | - **#385** — две установки лаунчера: обёртка Steam указывала на старую. |
| 91 | - **#248** — `chl stop` вежливо через `wine taskkill` до SIGTERM (часть #393). |
| 92 | - Файлы: `crates/chl-runtime`, `chl-wine/src/launch.rs`, `chl-steam` (обёртка), |
| 93 | `chl-gui/src/game_page.rs` — только кнопки запуска/завершения и статус. |
| 94 | |
| 95 | ### C. HDR и vkBasalt — `0.2/hdr` |
| 96 | - **#375** (в работе) — зависание игр с HDR, «HDR сам», vkBasalt в комплекте: |
| 97 | прочитать задачу и DEVLOG, доделать. |
| 98 | - **#379** — HDR для нативных Linux-игр (Baldur's Gate 3). |
| 99 | - **#380** — FakeHDR не компенсирует пересвет SDR-игр под HDR. |
| 100 | - **#381**, **#382** — vkBasalt: ложное «слоя нет» в журнале обёртки Steam; |
| 101 | требование libstdc++ от GCC 13 — показать в диагностике. |
| 102 | - Файлы: `chl-wine` (окружение HDR/gamescope), `chl-doctor`, `packaging/bundle/vkbasalt`. |
| 103 | `chl-wine/src/launch.rs` — общий с B: правки там согласовывать через координатора. |
| 104 | |
| 105 | ### D. Интерфейс — `0.2/ui` |
| 106 | - **#395** — «Внешний вид» не применяется вживую. Проверять именно нажатиями |
| 107 | во вложенном kwin, не снимком с заранее записанным файлом. |
| 108 | - **#396** — убрать нерабочие настройки (`NO_EFFECT`, `NOT_PORTED`) из |
| 109 | интерфейса и поиска, значение в конфиге сохранять. |
| 110 | - **#397** — «О программе»: сверху Chimera Launcher, StartWine — в разделе |
| 111 | благодарностей со ссылками. |
| 112 | - **#383** — значки Big Picture в 4K мельче расчётных. |
| 113 | - Файлы: `appearance_page.rs`, `theme.rs`, `background.rs`, `settings_page.rs`, |
| 114 | `chl-core/src/settings.rs` (только видимость), `about_page.rs`, |
| 115 | `chl-core/src/about.rs`, `big_picture.rs`. |
| 116 | |
| 117 | ### E. Экскурсия и `chl list` — `0.2/tour` |
| 118 | - **#398** — экскурсия для нового пользователя: подсветка разделов и кнопок, |
| 119 | подписи, «Далее/Назад/Пропустить», клавиатура и геймпад, автоматически один |
| 120 | раз после установки, повтор из «О программе», «Настроек лаунчера» и |
| 121 | `chimera-launcher --tour`. |
| 122 | - **#384** — `chl list --json`: машиночитаемый список игр. |
| 123 | - Файлы: новый модуль `chl-gui/src/tour.rs`; в `window.rs` — одна точка |
| 124 | подключения (оверлей поверх окна); кнопка в «О программе» и «Настройках |
| 125 | лаунчера» — согласовать с D через координатора; `chl-cli` — команда `list`. |
| 126 | |
| 127 | ## Выпуск |
| 128 | |
| 129 | Когда все пять направлений в main: координатор прогоняет workspace |
| 130 | clippy/test, test-distros (Arch, Debian 13, Fedora 43), самообновление |
| 131 | 0.1.53 → 0.2 на отдельной установке с локальной лентой, матрицу снимков |
| 132 | `tools/ui-matrix`, собирает `.run`. Публикация (лента, сайт, зеркало) — только |
| 133 | после слова владельца «выкладываем». |
| 134 |