docs: update plan

2026-08-25 16:17:16 +05:00
parent 376f7dd1d3
commit 47ffd16462
1 changed files with 117 additions and 0 deletions
@@ -0,0 +1,117 @@
 # План: удобная разработка bropicker с ИИ-агентом (Slint)
 > Статус: принят к исполнению. Дата: 2026-08-25.
 >
 > Предыстория: эксперимент dioxus-native/Blitz закрыт (прозрачность окна на Windows
 > нереализуема без форка blitz-shell/winit на этапе создания HWND). Ветка-архив:
 > `dioxus-archive`. Работаем на Slint, основная ветка `main`.
 ## Принцип «агент видит картинку»
 Цикл работы агента над дизайном:
 ```txt
 правка ui/*.slint → сборка+запуск в фоне → скриншот окна → сравнение с ref-PNG → правка
 ```
 Агент читает PNG напрямую (инструмент чтения файлов поддерживает картинки),
 поэтому визуальная сверка с макетами происходит без участия человека.
 Инструменты визуализации:
 - **PS-скрипт скриншота окна** (основной): ноль зависимостей, любая версия slint,
  снимает реальный композитинг — важно для прозрачности поверх стола.
  Минус: окно должно быть видимым
 - **`slint-snapshot`** (опционально, позже): headless, детерминированный,
  пиксель-диф из коробки. Минусы: требует ровно `slint =1.17.1` (апгрейд с 1.16.1)
  и возню со шрифтами/embed ресурсов
 HTML-макеты → PNG: **headless Edge** (`--headless --screenshot`), он предустановлен на Windows.
 ---
 ## Этап A — порядок в репозитории
 - [ ] Удалена `example/` — копия примера Slint с копирайтом SixtyFPS и битыми path-deps
 - [ ] Zip `browser-logos` удалён (не был в git; перезаливаемо с github alrrr/browser-logos);
      LICENSE логотипов сохранён в `logos/LICENSE-browser-logos.txt`;
      в `logos/` уже лежат отобранные PNG (chrome, firefox, opera, yandex, brave)
 - [ ] `.gitignore`: `tools/out/`, `*.log`, `coldstart.txt`
 Коммит: `chore: repo hygiene`
 ## Этап B — утилиты в `tools/`
 Все скрипты — PowerShell, без сторонних зависимостей.
 - [ ] `tools/render-refs.ps1` — рендерит `refs/dark.html` и `refs/light.html` через
      headless Edge в `tools/out/ref-dark.png` / `ref-light.png` (окно 488×800,
      `--hide-scrollbars`). Находит msedge.exe в стандартных путях
 - [ ] `tools/shot.ps1 [-Title bropicker] [-Out tools/out/app.png]` — скриншот окна
      приложения: FindWindowW + GetWindowRect (Win32 через Add-Type) +
      System.Drawing CopyFromScreen
 - [ ] `tools/run-and-shot.ps1` — полный цикл агента: `cargo build` →
      `Start-Process target\debug\bropicker.exe` → пауза ~1.5 c → shot.ps1 →
      `Stop-Process`. Решает проблему «GUI-процесс блокирует терминал агента»
 - [ ] Опционально: `slint-lsp` / VS Code extension — ей для редактора, агент не зависит
 Коммит: `feat(tools): visual dev loop for ai agents`
 Проверка цикла: `render-refs` → `run-and-shot` → оба PNG существуют, агент их прочитал.
 ## Этап C — возвращение к no-frame окну (цель дизайна)
 Текущее: окно с заголовком (специально, чтобы двигать мышью). Целевое: frameless +
 прозрачность + драг за хедер, как в макете.
 - [ ] `no-frame: true` + `background: transparent` в MainWindow
 - [ ] Прозрачность проверить первой же парой скриншотов (углы карточки vs ref-dark.png)
 - [ ] Драг: TouchArea в хедере → callback `request-drag` → в Rust через
      `i-slint-backend-winit`: `window.with_winit_window(|w| w.drag_window())`
      (код частично был в старом src/main.rs, восстановить из истории при необходимости)
 - [ ] Центрирование окна при старте — вернуть `src/winit.rs` (он в истории main до коммита 464f4f0)
 - [ ] Esc — закрыть: `FocusScope { key-event }` или `window.close()`
 - [ ] README привести в соответствие: стек Slint, скриншоты из `tools/out/`
 Коммит: `feat(ui): frameless transparent window with drag`
 ## Этап D — список браузеров (MVP-ядро)
 - [ ] Раскомментировать/восстановить ListView + BrowserItem в main.slint (было закомментировано)
 - [ ] Логотипы: PNG из `logos/` вместо emoji (поле icon → путь к png)
 - [ ] Мок-данные 4 браузеров в VecModel (уже были в старом src/main.rs)
 - [ ] Выбор кликом + подсветка selected; hover-стили
 - [ ] Кнопка «Открыть» → callback → Rust: `std::process::Command(path).args(flags).arg(url)`
 - [ ] URL из argv: `std::env::args().nth(1)`
 - [ ] Закрытие окна после запуска
 Коммит: `feat: browser list mvp`
 ## Этап E — конфиг и настройки
 - [ ] `config.toml` рядом с exe / `%APPDATA%\bropicker` (крейс `toml`), serde-структура BrowserConfig
 - [ ] Страница настроек: TabWidget + LineEdit/SpinBox/ComboBox/CheckBox std-widgets;
      вход по кнопке cog из футера (колбэк settings-clicked уже есть)
 - [ ] Автодетект установленных браузеров (реестр Windows) как fallback при отсутствии конфига
 - [ ] Чтение флагов из .lnk ярлыков (крейс `lnk`) — по желанию
 Коммит: `feat: config + settings page`
 ## Этап F — релиз
 - [ ] `[profile.release]`: lto, codegen-units=1, strip
 - [ ] Замер cold start: Instant в начале main → печать в первом колбэке; цель <100 ms;
      результат записать сюда: `___ ms`
 - [ ] Иконка exe (.ico через build.rs winres)
 - [ ] Выбрать лицензию проекта: GPLv3 (опенсорс) или Royalty-free Slint (закрытый десктоп,
      атрибуция AboutSlint) — зафиксировать в README и LICENSE
 - [ ] Скриншоты в README из tools/out
 ## Заметки для агента
 - GUI-приложение запускать только через `tools/run-and-shot.ps1`, никогда не блокирующе
 - После каждого изменения UI: скриншот + сравнение с `tools/out/ref-{dark,light}.png`
 - Тёмная/светлая тема переключается кнопкой sun/moon (Theme.toggle уже работает);
  для скриншота светлой темы кликать нельзя — добавить env-флаг `BP_THEME=light`,
  который в main() выставит `Theme.is-dark = false` перед показом
 - Cargo.toml правится только через cargo CLI; манифесты руками — только человеком