An honest, developer-written guide to your 3D screen companion. Learn how autonomous behavior loops work, how to map gestures across body zones, how to orchestrate action frequencies, and how to install cloud skills without updating the app binary.
LiPet is not a looping animated GIF. Every poke, drag, or double-click is governed by an autonomous gesture arbitration engine.
When clicked, the pet does not randomly jump to an unrelated animation. It first plays an immediate 2–3 frame acknowledgment so it visibly notices your cursor, then branches into a natural reaction based on its current posture:
A gentle tap earns affection. However, rapid repeated pokes within 3 seconds increment the internal touchSaturation counter:
To prevent double-clicks from triggering unwanted single-click touch reactions, LiPet runs a ~250ms gesture arbitration window. When double-click bindings or the companion assistant entry are configured on a body zone, the first tap holds candidate state. If a second click occurs within ~250ms and ~6 physical pixels, the single-click reaction is cleanly cancelled, opening the Pet Card / Companion Panel directly.
Holding your primary mouse button down for ~500ms without moving triggers any bound long-press skill action. If you move past 4–6 physical pixels, control immediately transfers to native dragging:
被拎起) and its ground shadow detaches.落地), checks its new surroundings, and rests during a 20–60s cooldown before deciding whether to walk back to its favorite home corner.Turn your desktop cat into an interactive command hub by mapping body zones to custom gestures and skills.
The Pet Center allows you to divide your pet’s visible body into one of four data layouts:
whole — Entire body treated as a single trigger zone (all).rows2 — Split horizontally into top (ears, head, upper back) and bottom (belly, paws, tail).cols2 — Split vertically into left (front face & chest) and right (hindquarters & tail).grid3 — A 3×3 matrix of 9 precision zones (r1c1 through r3c3) for multi-skill power users.Touch zones are computed strictly across the pet’s non-transparent visible pixels. Transparent window areas allow full click-through to underlying macOS apps, editors, and browser windows without accidental hits.
Each body zone supports independent bindings for tap, double-tap, and long-press. For example, assign tapping the head to fetch local weather, double-tapping the belly to inspect AI quota balances, and long-pressing the back to bring up the system resource gauge.
Touch mappings are per-pet user data stored alongside the behavior table. Synced via revision locks, ensuring your customized layout persists across updates and multiple Mac workstations.
Fine-tune how often your pet walks, naps, grooms, and reacts to your desktop environment.
Frequencies in LiPet are relative weights in the autonomous behavior selector, not rigid interval timers:
1 — Very Rare (极罕见): Special rare actions.10 — Rare (罕见): Occasional stretches and playful pounces.50 — Sometimes (中 / 默认): Balanced default cadence for grooming and walking.100 — Often (经常): High-frequency curiosity and looking around.200 — Frequent (频繁): Active exploratory routines.Every behavior action features an independent [Allow Spontaneous] switch. When disabled, the action will never start on its own; it will only trigger as a follow-up chain from another action or through an external event.
LiPet renders animations using lightweight sprite frames, capping rendering frame rates at each asset’s native frame rate. The behavior engine schedules decisions dynamically on demand rather than running fixed polling loops. When your screen is locked or the Mac enters sleep, the engine stops completely with zero background resource usage.
Connect your desktop pet to external system signals and live events:
Expand your pet’s capabilities with cloud-delivered skill data packets that install in seconds without app updates.
Unlike traditional apps that require binary downloads or complex code sandboxes, LiPet skills are distributed as declarative data packets containing UI manifests, API endpoints, and command definitions. Official skills are delivered instantly from the cloud.
When installing a skill from the collection browser, you are presented with a clear permission breakdown (such as network API domains, notification permissions, and background refresh cadence). Privileged operations are strictly whitelisted and isolated.
Skill outputs route cleanly through dedicated presentation surfaces:
Monitor your OpenAI, Anthropic Claude, and Google Gemini API balances through built-in gauge cards. Check quota rings and remaining credits with a single tap on your cat’s paws.
Configure how LiPet displays across your Mac desktop, Dock, and menu bar.
Customize LiPet’s visibility across macOS system surfaces:
When the Dock icon is enabled, dynamic avatar synchronization updates the icon in real time to match your pet’s appearance, color variations, and mood.
The presence system enforces a safety invariant: you cannot disable both the Dock icon and the Menu Bar tray icon at the same time. At least one recovery surface always remains accessible so you never lose access to preferences.