macOS companion app
選單列圖示
選單列圖示狀態
範圍：macOS 應用程式（apps/macos）。算繪：CritterIconRenderer.makeIcon(...)。動畫／狀態連接：CritterStatusLabel + CritterStatusLabel+Behavior.swift。
狀態
| 狀態 | 觸發條件 | 視覺效果 |
|---|---|---|
| 閒置 | 預設 | 一般的眨眼／擺動動畫；睜眼時保留光澤亮點 |
| 暫停 | isPaused=true |
觸角下垂（“休息中”）且眼睛睜開；不動 |
| 睡眠 | 閘道中斷連線／未設定 | 觸角下垂，眼睛閉成 ⌣ ⌣ 眼瞼；不動 |
| 慶祝 | 訊息已傳送（sendCelebrationTick） |
眼睛閃現開心的 ∩ ∩ 弧形約 0.9 秒，並踢一下腿 |
| 語音喚醒（大耳朵） | 聽到喚醒詞 | 觸角豎直並變得更高（earScale=1.9）；靜默後恢復 |
| 工作中 | isWorking=true 或作用中的 IconState |
腿部更快速擺動（legWiggle 最高為 1.0），並有小幅水平位移；疊加於閒置擺動 |
當工作階段有作用中的工作或工具時，工具活動徽章（SF Symbol 圓形徽章，例如執行時使用 chevron.left.slash.chevron.right）可顯示在同一個小動物圖示上方。該徽章來自 IconState／ActivityKind；完整的狀態模型請參閱選單列。
語音喚醒耳朵
- 觸發：
AppStateStore.shared.triggerVoiceEars(ttl: nil)，由語音喚醒擷取管線（VoiceWakeRuntime）以及語音喚醒偵錯／測試工具（VoiceWakeTester、VoiceWakeOverlayController）呼叫。 - 停止：
stopVoiceEars()，在擷取完成時呼叫。 - 完成前的靜默時間窗：一般為
2.0s；若只聽到觸發詞，之後沒有其他語音，則為5.0s（VoiceWakeRuntime.silenceWindow／triggerOnlySilenceWindow）。 - 增強期間，閒置的眨眼／擺動／腿部／耳朵計時器會暫停（
earBoostActive會控制CritterStatusLabel+Behavior中的動畫工作）。
形狀與尺寸
- 畫布：18x18pt 的範本影像，算繪至 36x36px 的點陣圖後備儲存區（2x），使圖示在 Retina 顯示器上保持清晰。
- 耳朵縮放比例預設為
1.0；語音增強會設為earScale=1.9，但不變更整體框架。 antennaDroop（0-1）會讓暫停與睡眠姿勢中的觸角向下折。- 腿部快跑動畫使用最高為
1.0的legWiggle，並伴隨小幅水平晃動。
行為附註
- 沒有可控制耳朵或工作狀態的外部命令列介面／代理切換；兩者都由應用程式訊號（
AppState.setWorking、AppState.triggerVoiceEars）在內部驅動，以避免意外反覆切換。 - 任何新的 TTL 都應保持短暫（遠低於 10 秒），如此即使工作停滯，圖示也能快速恢復基準狀態。
相關內容
Was this useful?
