​

메뉴 막대 아이콘 상태

• 유휴(Idle): 일반 아이콘 애니메이션 (깜박임, 간헐적인 흔들림).
• 일시 중지(Paused): 상태 항목이 appearsDisabled 을 사용하며, 움직임 없음.
• 음성 트리거(큰 귀): 음성 깨우기 감지기가 깨우기 단어가 들리면 AppState.triggerVoiceEars(ttl: nil) 를 호출하고, 발화가 캡처되는 동안 earBoostActive=true 을 유지합니다. 귀는 1.9 배로 확대되고, 가독성을 위해 원형 귀 구멍이 생기며, 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 까지 사용하며 작은 수평 지글을 포함합니다. 이는 기존의 유휴 흔들림에 가산됩니다.

• 귀/작업 상태에 대한 외부 CLI/브로커 토글은 없습니다. 우발적인 깜박임을 피하기 위해 앱 자체 신호로만 내부적으로 유지하십시오.
• 작업이 멈출 경우 아이콘이 빠르게 기준 상태로 돌아오도록 TTL 을 짧게 유지하십시오 (<10 초).