LiPet 사용자 및 기능 가이드

단일 클릭: 현재 자세에 따른 상황별 터치 반응

클릭 시 무작위 동작으로 튀지 않고, 먼저 2~3프레임의 시선 확인 동작을 거친 뒤 현재 자세에 맞는 자연스러운 반응을 실행합니다:

• 서 있거나 걸을 때: 걸음을 멈추고 고개를 갸우뚱거리거나, 천천히 눈을 깜빡이거나 앞발을 듭니다.
• 잘 때: 귀를 쫑긋거리며 한쪽 눈을 뜨고 확인한 뒤 방해가 없으면 다시 잠에 듭니다.
• 털을 다듬을 때: 그루밍을 멈추고 고개를 들어 마주봅니다.
• 탐색 중일 때: 부드럽게 멈춰 서서 커서 방향을 바라봅니다.

연속 터치와 귀찮음 게이지

적당한 쓰다듬기는 애정을 유발하지만, 3초 내에 반복해서 찌르면 touchSaturation(터치 포화도)가 쌓입니다:

• 1번째 터치: 호기심 어린 반응 및 시선 집중.
• 약 1.5초 내 2번째: 반응 시퀀스의 후반부 진행.
• 약 3초 내 3번째 이상: 포화 한계 도달 — 발로 커서를 쳐내거나 꼬리를 흔들며 등을 돌립니다.
• 쿨다운: 약 6초 동안 건드리지 않으면 포화도가 0으로 초기화됩니다.

더블클릭 및 제스처 중재 윈도우

더블클릭 시 원치 않는 단일 클릭 반응이 오발발하는 것을 방지하기 위해 약 250ms의 제스처 중재 윈도우가 동작합니다. 더블클릭이 바인딩된 부위는 첫 클릭 후 대기 상태로 전환되며, 250ms 내 두 번째 클릭이 감지되면 단일 클릭을 취소하고 펫 카드나 어시스턴트 패널을 바로 엽니다.

길게 누르기 및 물리 드래그

마우스 버튼을 약 500ms 동안 누르고 있으면 길게 누르기 스킬이 실행됩니다. 커서를 4~6픽셀 이상 움직이면 즉시 네이티브 드래그로 전환됩니다:

• 목덜미 잡힘 반응: 공중에 매달린 자세(被拎起)로 전환되며 그림자가 바닥에서 분리됩니다.
• 멀티 디스플레이 이동: 여러 모니터와 창 사이를 자유롭게 이동할 수 있습니다.
• 착지 완충 및 귀소 기억: 마우스를 놓으면 부드럽게 착지(落地)하고, 20~60초 후 원래 좋아하던 자리로 돌아갈지 자율적으로 결정합니다.

4가지 신체 분할 레이아웃

펫 센터에서 4가지 신체 분할 방식 중 하나를 선택할 수 있습니다:

• whole — 몸 전체를 단일 영역(all)으로 사용.
• rows2 — 상하 분할: top(머리, 귀, 등)과 bottom(배, 발, 꼬리).
• cols2 — 좌우 분할: left(얼굴, 가슴)과 right(등, 꼬리).
• grid3 — 3×3 9분할 정밀 그리드(r1c1 ~ r3c3).

알파 테스트 픽셀 마스킹

터치 인식은 불투명한 픽셀에서만 발생합니다. 주변의 투명 영역은 macOS 창과 코드 에디터로 온전히 통과되어 작업에 방해되지 않습니다.

독립적인 제스처 바인딩

각 영역마다 tap(클릭), double-tap(더블클릭), long-press(길게 누르기)를 독립적으로 바인딩할 수 있습니다. (예: 머리 탭=날씨 확인, 배 더블탭=AI 잔여 크레딧 확인, 등 롱프레스=CPU 모니터).

펫 센터 동기화 저장

터치 매핑은 펫별 데이터로 저장되며 리비전 잠금을 통해 여러 Mac 간에 안전하게 동기화됩니다.

5단계 빈도 가중치 조절

LiPet의 빈도는 고정된 타이머가 아니라 자율 행동 선택기의 상대적 가중치입니다:

• 1 — 매우 드묾: 특별한 희귀 액션.
• 10 — 드묾: 가끔 하는 기지개나 놀이.
• 50 — 가끔 (기본값): 일상적인 걷기와 그루밍.
• 100 — 자주: 활발한 탐색과 주변 관찰.
• 200 — 매우 자주: 활동적인 화면 산책.

자발적 실행 허용 스위치

각 행동마다 [자발적 실행 허용] 스위치가 있어, 꺼두면 스스로 시작되지 않고 특정 연계 동작이나 외부 이벤트로만 실행됩니다.

스프라이트 프레임 애니메이션 및 온디맨드 엔진

LiPet은 경량 스프라이트 프레임(Sprite Frames)으로 애니메이션을 렌더링하며, 렌더링 프레임레이트는 소재 자체의 고유 프레임레이트를 초과하지 않습니다. 행동 엔진은 고정된 폴링 대신 행동 상태에 맞춰 판정 간격을 동적으로 스케줄링합니다. 화면 잠금 또는 시스템 절전 진입 시 엔진이 완전히 정지하여 백그라운드 자원을 소모하지 않습니다.

외부 환경 및 이벤트 연동

비가 오면 털을 털고, 추운 날에는 웅크려 떨며, macOS 집중 모드 진입 시 조용히 잠을 잡니다.

선언적 클라우드 데이터 패킷

실행 파일이나 복잡한 스크립트 대신 선언적 데이터 번들 형태로 배포되어 클라우드에서 즉각 전달됩니다.

투명한 권한 모델과 화이트리스트

설치 시 네트워크 도메인, 알림 권한 등이 명확히 표시되며 권한 있는 작업은 안전하게 격리됩니다.

다계층 전달 파이프라인

중요 알림은 L1 펫 말풍선(1줄 요약), 상세 내역은 L2 타임라인, 물리적 반응은 L0 펫 동작으로 전달됩니다.

AI 크레딧 Gauge 패널

OpenAI, Anthropic Claude, Google Gemini API 사용량과 잔여 토큰을 원형 게이지로 직관적으로 확인하세요.

메뉴 바 트레이 및 Dock 표시 제어

사용 환경에 맞게 LiPet의 상주 위치를 설정할 수 있습니다:

• 메뉴 바 트레이 아이콘: macOS 상단 메뉴 바에 깔끔한 아이콘을 표시하여 빠른 메뉴 및 설정 접근을 지원합니다.
• Dock 아이콘: macOS Dock에 앱 아이콘을 표시하여 일반적인 창 관리 및 앱 전환을 지원합니다.

Dock 아이콘 펫 외형 동기화

Dock 표시 시 아이콘이 현재 선택된 펫의 외형과 감정 상태를 실시간으로 반영합니다.

설정 창 분실 방지 안전장치

Dock 아이콘과 메뉴 바 아이콘을 동시에 끌 수 없도록 강제하여 언제든 설정에 접근할 수 있도록 보장합니다.