Guía Oficial de Usuario

LiPet Guía de Funciones y Uso

Una guía honesta escrita por desarrolladores. Aprende cómo funcionan los ciclos autónomos, cómo asignar gestos a zonas del cuerpo, cómo ajustar la frecuencia de acciones y cómo instalar habilidades en la nube sin actualizar la app.

En Desarrollo Activo: LiPet se encuentra en desarrollo activo. Las arquitecturas y modelos táctiles descritos representan nuestras especificaciones verificadas, pero los controles visuales pueden ajustarse antes del lanzamiento 1.0.

1. Interactuar con tu Mascota

LiPet no es un GIF en bucle. Cada toque, arrastre o doble clic está gobernado por un motor de arbitraje gestual.

Toque Único: Respuestas Contextuales Según la Postura

Al hacer clic, la mascota no salta aleatoriamente a otra animación. Primero reproduce 2–3 fotogramas de reconocimiento para orientar sus ojos y orejas hacia el cursor, y luego responde según su postura actual:

  • De pie / Caminando: Se detiene suavemente, ladea la cabeza con curiosidad o levanta una pata.
  • Durmiendo: Mueve las orejas, abre un ojo y se despereza antes de volver a dormir.
  • Aseo: Pausa el lamido de patas y te mira con atención.
  • Explorando: Frena el paso con fluidez y se gira hacia el cursor.

Toques Consecutivos y Medidor de Saturación

Un toque suave genera curiosidad. Sin embargo, toques repetidos en menos de 3 segundos incrementan el contador touchSaturation:

  • 1er toque: Reacción amistosa y orientación de orejas.
  • 2º toque (en ~1.5s): Continuación de la secuencia de respuesta.
  • 3er toque (en ~3s): Se alcanza el límite — el gato aparta el cursor con la pata o se da la vuelta.
  • Enfriamiento: Tras 6 segundos de calma, la saturación vuelve a cero.

Doble Clic y Ventana de Arbitraje de Gestos

Para evitar que un doble clic dispare respuestas no deseadas de un solo toque, LiPet usa una ventana de arbitraje de ~250ms. El primer toque entra en estado de espera; si ocurre un segundo clic dentro del intervalo, se cancela el toque simple y se abre limpiamente el panel de la mascota.

Pulsación Larga y Física de Arrastre

Mantener presionado durante ~500ms activa las acciones de pulsación larga. Al mover más de 4–6 píxeles, el control pasa al arrastre nativo:

  • Levantado: El gato adopta la postura colgante sostenido por el cuello (被拎起) y su sombra se separa.
  • Multi-Monitor: Muévelo libremente entre diferentes pantallas y ventanas.
  • Aterrizaje Suave: Al soltarlo, aterriza suavemente (落地) y tras un breve descanso decide si caminar hacia su rincón favorito.

2. Mapeo Táctil Corporal

Convierte a tu gato en un centro de comandos táctil dividiendo su cuerpo en zonas interactivas.

Cuatro Diseños de Partición

En el Centro de Mascotas puedes elegir entre 4 particiones corporales:

  • whole — Cuerpo completo como una sola zona (all).
  • rows2 — División horizontal: top (cabeza y lomo) y bottom (vientre y patas).
  • cols2 — División vertical: left (frontal) y right (trasero y cola).
  • grid3 — Cuadrícula 3×3 de 9 zonas de precisión (r1c1 a r3c3).

Máscara de Píxeles con Test Alfa

Las zonas táctiles solo responden en los píxeles visibles no transparentes. El espacio transparente deja pasar los clics a tus ventanas y editores de macOS.

Asignación Independiente de Gestos

Cada zona puede vincularse a tap (clic), double-tap (doble clic) y long-press (pulsación larga) para ejecutar habilidades personalizadas.

Sincronización en el Centro de Mascotas

El mapeo táctil se guarda por mascota y se sincroniza mediante control de versiones en la nube.

3. Orquestación del Comportamiento

Ajusta la frecuencia con la que tu mascota pasea, descansa y responde a eventos del sistema.

Ponderación de Frecuencia en Cinco Niveles

Las frecuencias en LiPet representan pesos relativos en el selector de comportamiento autónomo:

  • 1 — Muy Raro: Acciones inusuales y sorpresas.
  • 10 — Raro: Estiramientos ocasionales y saltos.
  • 50 — A veces (Predeterminado): Cadencia equilibrada de paseo y aseo.
  • 100 — Frecuente: Mayor curiosidad y exploración.
  • 200 — Muy Frecuente: Rutinas activas continuas.

Interruptor de Aparición Espontánea

Cada acción cuenta con un interruptor para permitir o prohibir que ocurra por iniciativa propia, limitándola a eventos externos si se desea.

Animaciones por Cuadros y Motor Bajo Demanda

LiPet utiliza animaciones de fotogramas por sprites ligeras, limitando la tasa de renderizado a la frecuencia nativa de cada recurso. El motor de comportamiento toma decisiones bajo demanda en lugar de sondeos continuos, ajustando los intervalos según la acción. Al bloquear la pantalla o suspender el equipo, el motor se detiene por completo sin consumo en segundo plano.

Vinculación de Eventos Externos

Conecta a tu mascota con el clima real (sacudirse con lluvia, tiritar con frío) y el modo Concentración de macOS.

4. Sistema de Habilidades y Plugins

Paquetes de datos declarativos entregados desde la nube sin necesidad de actualizar el binario de la aplicación.

Paquetes Declarativos en la Nube

Las habilidades se empaquetan como datos estructurados (manifiestos, definiciones de UI y comandos API) que se descargan e instalan al instante.

Modelo de Permisos Transparente

Confirmación clara de permisos al instalar (dominios de red, notificaciones). Las operaciones privilegiadas están aisladas en un entorno seguro.

Canales de Entrega de Resultados

Las respuestas se muestran en burbujas breves (L1), en el historial silencioso (L2) o mediante animaciones corporales de la mascota (L0).

Paneles de Cuotas de IA

Monitorea tus saldos de API en OpenAI, Anthropic y Google Gemini mediante anillos medidores visuales.

5. Presencia en Barra de Menús y Dock

Personaliza la visibilidad de LiPet en tu escritorio, Dock y barra de menús de macOS.

Controles de la Barra de Menús y del Dock

Elige cómo interactuar con LiPet en el sistema:

  • Icono en Barra de Menús: Muestra un discreto icono en la barra superior para acceder rápido a los ajustes.
  • Icono en el Dock: Mantiene la presencia en el Dock de macOS para la gestión habitual de ventanas.

El Icono del Dock Sigue a tu Mascota

Con el icono del Dock activo, la apariencia del icono se sincroniza en tiempo real con el aspecto y estado de tu mascota.

Garantía de Recuperación Segura

El sistema impide desactivar simultáneamente el Dock y la barra de menús, asegurando que siempre tengas acceso a la configuración.

LiPet · En Desarrollo Activo