> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 메뉴 막대 아이콘

# 메뉴 막대 아이콘 상태

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

* **유휴(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 초).