macOS companion app

메뉴 막대 아이콘

메뉴 막대 아이콘 상태

작성자: steipete · 업데이트: 2025-12-06 · 범위: macOS 앱(apps/macos)

유휴 상태: 일반 아이콘 애니메이션(깜박임, 간헐적인 흔들림).
일시 중지: 상태 항목은 appearsDisabled를 사용하며, 움직임이 없습니다.
음성 트리거(큰 귀): 깨우기 단어가 들리면 음성 깨우기 감지기가 AppState.triggerVoiceEars(ttl: nil)를 호출하여 발화를 캡처하는 동안 earBoostActive=true를 유지합니다. 귀가 커지고(1.9x), 가독성을 위해 원형 귀 구멍이 생긴 다음, 1초 동안 침묵이 이어지면 stopVoiceEars()를 통해 내려갑니다. 앱 내부 음성 파이프라인에서만 실행됩니다.
작업 중(에이전트 실행 중): AppState.isWorking=true는 "꼬리/다리 종종걸음" 마이크로 모션을 구동합니다. 작업이 진행 중일 때 다리 흔들림이 빨라지고 약간의 오프셋이 적용됩니다. 현재 WebChat 에이전트 실행 전후에 토글됩니다. 다른 긴 작업을 연결할 때도 동일한 토글을 추가하세요.

연결 지점

음성 깨우기: 런타임/테스터는 캡처 창과 맞추기 위해 트리거 시 AppState.triggerVoiceEars(ttl: nil)를 호출하고, 1초 동안 침묵이 이어진 뒤 stopVoiceEars()를 호출합니다.
에이전트 활동: 작업 구간 전후에 AppStateStore.shared.setWorking(true/false)를 설정합니다(WebChat 에이전트 호출에서는 이미 완료됨). 애니메이션이 멈춘 상태로 고정되지 않도록 구간을 짧게 유지하고 defer 블록에서 재설정하세요.

모양 및 크기

기본 아이콘은 CritterIconRenderer.makeIcon(blink:legWiggle:earWiggle:earScale:earHoles:)에서 그려집니다.
귀 배율 기본값은 1.0입니다. 음성 부스트는 전체 프레임을 변경하지 않고 earScale=1.9를 설정하고 earHoles=true를 토글합니다(18×18 pt 템플릿 이미지를 36×36 px Retina 백킹 스토어에 렌더링).
종종걸음은 작은 수평 흔들림과 함께 다리 흔들림을 최대 약 1.0까지 사용합니다. 기존 유휴 흔들림이 있으면 여기에 더해집니다.

동작 참고 사항