Офіційний посібник користувача

LiPet Посібник з функцій та використання

Чесний посібник, написаний розробниками. Дізнайтеся, як працює автономний рушій поведінки, як мапувати жести на зони тіла, налаштовувати частоту дій та встановлювати хмарні навички без оновлення застосунку.

У процесі активної розробки: LiPet активно розвивається. Описані архітектури та сенсорні моделі відповідають затвердженим специфікаціям, але деталі інтерфейсу можуть бути вдосконалені до виходу версії 1.0.

1. Взаємодія з улюбленцем

LiPet — це не зациклена GIF-анімація. Кожен клік, перетягування та подвійний клік керуються автономним рушієм арбітражу жестів.

Одиночний клік: контекстні реакції відповідно до пози

При кліку кіт не стрибає раптово у випадкову анімацію. Спочатку відтворюються 2–3 кадри привернення уваги (погляд і вуха спрямовуються до курсора), після чого запускається відповідна гілка реакції:

  • Стоїть / гуляє: плавно зупиняється, з цікавістю нахиляє голову, повільно кліпає або піднімає лапку.
  • Спить: ворушить вушками, розплющує одне око, потягується і знову засинає, якщо немає подальших дотиків.
  • Вмивається: призупиняє вмивання лапкою і дивиться на вас.
  • Досліджує: плавно сповільнює хід і повертається до курсора.

Повторні дотики та поріг насичення (роздратування)

Лагідний дотик викликає прихильність. Але швидкі повторні кліки протягом 3 секунд збільшують лічильник touchSaturation:

  • 1-й дотик: дружня реакція та фокусування уваги.
  • 2-й дотик (~1.5с): продовження поточної послідовності реакції.
  • 3-й дотик (~3с): досягнення порогу — кіт відштовхує курсор лапкою або відвертається.
  • Відновлення: після 6 секунд спокою лічильник скидається до нуля.

Подвійний клік та вікно арбітражу жестів

Щоб подвійний клік не викликав небажаних реакцій одиночного дотику, LiPet використовує вікно арбітражу тривалістю ~250 мс. Перший клік переходить у режим очікування; якщо протягом 250 мс надходить другий клік, одиночна реакція скасовується, і відкривається картка улюбленця.

Тривале натискання та фізика перетягування

Утримання кнопки миші ~500 мс активує дію тривалого натискання. Зсув курсора понад 4–6 пікселів миттєво перемикає улюбленця в режим перетягування:

  • Піднятий за загривок: кіт приймає позу підвішеного стану (被拎起), а його тінь відривається від поверхні.
  • Кілька дисплеїв: вільно переміщуйте улюбленця між різними моніторами та вікнами.
  • М’яке приземлення: після відпускання кіт м’яко приземляється (落地) та після паузи вирішує, чи повертатися у свій затишний куточок.

2. Сенсорне мапування тіла

Перетворіть кота на інтерактивний центр команд, розділивши його тіло на окремі зони дотику.

Чотири схеми поділу

У Центрі улюбленця можна обрати одну з 4 схем поділу:

  • whole — усе тіло як єдина зона (all).
  • rows2 — поділ по горизонталі: top (голова, вуха, спина) та bottom (живіт, лапи, хвіст).
  • cols2 — поділ по вертикалі: left (передня частина) та right (задня частина та хвіст).
  • grid3 — сітка 3×3 з 9 зон високої точності (r1c1r3c3).

Альфа-маскування прозорих пікселів

Зони дотику реагують лише на непрозорі пікселі. Прозорий простір навколо кота пропускає всі кліки безпосередньо у вікна ваших програм macOS.

Незалежне призначення жестів

Для кожної зони можна окремо налаштувати tap (клік), double-tap (подвійний клік) та long-press (тривале натискання).

Синхронізація в Центрі улюбленця

Мапування зберігається для кожного улюбленця окремо та надійно синхронізується між пристроями.

3. Оркестрація поведінки

Налаштовуйте частоту прогулянок, сну та реакцій на події навколишнього середовища.

П’ять рівнів вагових коефіцієнтів частоти

Частота в LiPet — це відносні ваги у селекторі автономної поведінки:

  • 1 — Дуже рідко: особливі рідкісні анімації.
  • 10 — Рідко: випадкові потягування та стрибки.
  • 50 — Іноді (За замовчуванням): збалансований темп вмивання та ходьби.
  • 100 — Часто: активне дослідження та озирання.
  • 200 — Дуже часто: постійні прогулянки екраном.

Перемикач спонтанної появи

Кожна дія має перемикач, який дозволяє або забороняє її самостійний запуск без зовнішнього тригера.

Покадрова анімація спрайтів та рушій на вимогу

LiPet використовує легку покадрову анімацію спрайтів, обмежуючи частоту рендерингу частотою кадрів самих графічних ресурсів. Рушій поведінки приймає рішення за потребою замість постійного опитування, динамічно плануючи інтервали. Під час блокування екрана або сну системи рушій повністю зупиняється без споживання фонових ресурсів.

Реакція на зовнішні події

Кіт реагує на дощ за вікном (обтрушує шерсть), мороз (тремтить і згортається клубочком) та режим Фокусування macOS.

4. Система навичок та плагінів

Декларативні пакети даних, що завантажуються з хмари без оновлення самої програми.

Декларативні хмарні пакети даних

Навички розповсюджуються як легкі структуровані пакети (маніфести, інтерфейси та команди), доступні з хмари за лічені секунди.

Прозора модель дозволів

Детальний огляд дозволів (мережеві домени, сповіщення) під час встановлення.

Багаторівневі канали відображення

Результати відображаються у лаконічній бульбашці (L1), тихій хронології (L2) або через фізичні рухи кота (L0).

Панелі квот AI

Зручний моніторинг залишку балансу та токенів OpenAI, Anthropic Claude та Google Gemini через наочні кругові шкали.

5. Налаштування панелі меню та Dock

Керуйте тим, як LiPet відображається на робочому столі, в Dock та панелі меню macOS.

Керування панеллю меню та Dock

Обирайте зручний формат відображення LiPet у системі:

  • Іконка в рядку меню: лаконічна іконка у верхній панелі macOS для швидкого доступу до меню та налаштувань.
  • Іконка в Dock: відображення в Dock macOS для звичного керування вікнами та перемикання програм.

Іконка Dock повторює вигляд улюбленця

При увімкненому Dock іконка у реальному часі відображає забарвлення та стан вашого кота.

Гарантований захист від втрати вікна

Система забороняє одночасно вимикати іконку в Dock та в рядку меню, гарантуючи постійний доступ до налаштувань.

LiPet · У процесі активної розробки