Project Chimera
Меню

Исходники

134 строк · 12 КиБ

docs/PLAN-0.2.md

1# План 0.2
2
3Семнадцать задач из OpenProject (проект Chimera Launcher, id 9, версия «0.2»,
4id 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
130clippy/test, test-distros (Arch, Debian 13, Fedora 43), самообновление
1310.1.53 → 0.2 на отдельной установке с локальной лентой, матрицу снимков
132`tools/ui-matrix`, собирает `.run`. Публикация (лента, сайт, зеркало) — только
133после слова владельца «выкладываем».
134