AspansQulyp/CLAUDE.md
deni.reyton 54c484300f
Some checks failed
CI / windows (push) Waiting to run
CI / linux (push) Has been cancelled
Установка: ярлык в «Пуске», .desktop для Linux, иконка в exe
- scripts/install-windows.ps1: exe в %LOCALAPPDATA%\Programs\Qulyp + ярлык (-Desktop, -Uninstall)
- scripts/install-linux.sh: ~/.local/bin + .desktop + SVG-иконка (--uninstall)
- build.rs вшивает иконку и описание в exe через winresource
- Растр иконки вынесен в src/icon_pixels.rs (общий для окна и build.rs)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 15:45:39 +05:00

3.0 KiB
Raw Permalink Blame History

Qulyp — памятка для ИИ-ассистента

Менеджер паролей на Rust + egui (eframe 0.36, рендер glow). Windows и Linux. Один зашифрованный файл .qulyp, работает офлайн, синхронизация через облачную папку.

Заметки проекта (notes/) — читать в начале сессии

Файл Что внутри Лимит строк
notes/STATUS.md Где проект сейчас, что работает 40
notes/PLAN.md Планы: Сейчас / Дальше / Потом 60
notes/DEBT.md Хвосты: баги, техдолг, недоделки 60
notes/LOG.md Журнал сессий, новые сверху 80
notes/DECISIONS.md Ключевые решения и почему 80
notes/DATA.md Формат файла и схема данных («БД») 80

Лимиты проверяет cargo test --test notes (заголовок <!-- limit: N --> в каждом файле). notes/archive/ — старое, не читать без необходимости.

Правила ведения заметок

  • В конце каждой рабочей сессии: 1–4 строки в LOG.md (дата, что сделано), обновить STATUS.md.
  • Закрытый хвост — удалить из DEBT.md (не зачёркивать). Новый — добавить одной строкой.
  • Пишем сжато: одна мысль — одна строка, без пересказа кода и git-истории.
  • Упёрлись в лимит LOG.md → старые записи перенести в notes/archive/LOG-<год>.md.
  • В других файлах при лимите — сократить формулировки, а не архивировать.

Код

  • src/crypto.rs — формат файла, Argon2id + XChaCha20-Poly1305
  • src/vault.rs — модель данных и слияние версий (синхронизация)
  • src/storage.rs — сессия: атомарная запись, .bak, автослияние внешних изменений
  • src/app.rs — экраны и UI; src/widgets.rs, src/theme.rs — виджеты и стиль
  • src/devshots.rs — dev-сценарий со скриншотами (feature dev-shots)
  • build.rs — вшивает иконку в exe; scripts/ — установка для Windows и Linux

Команды

  • cargo test — все тесты; cargo run — запуск; cargo build --release — релиз
  • cargo check --target x86_64-unknown-linux-gnu — проверка сборки под Linux
  • Скриншоты UI: см. шапку src/devshots.rs. Не эмулировать системные нажатия клавиш/мыши для проверки GUI — они могут уйти в чужое окно.