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；如果只聽到觸發詞，且之後沒有其他語音（VoiceWakeRuntime.silenceWindow/triggerOnlySilenceWindow），則為5.0s。 - 增強期間，閒置眨眼／擺動／腿部／耳朵計時器會暫停（
earBoostActive會控制CritterStatusLabel+Behavior中的動畫工作）。
形狀與大小
- 畫布：18x18pt 範本影像，繪製至 36x36px 點陣圖後備儲存區（2x），讓圖示在 Retina 顯示器上保持清晰。
- 耳朵縮放比例預設為
1.0；語音增強會設定earScale=1.9，但不會變更整體框架。 antennaDroop（0-1）會將觸角向下折疊，形成暫停與睡眠姿勢。- 腿部疾走使用
legWiggle，最高至1.0，並伴隨小幅水平抖動。
行為注意事項
- 沒有可控制耳朵或工作狀態的外部命令列介面／代理切換；兩者均由應用程式訊號（
AppState.setWorking、AppState.triggerVoiceEars）在內部驅動，以避免意外反覆切換。 - 任何新的 TTL 都應保持短暫（遠低於 10 秒），讓圖示在作業卡住時也能快速回復基準狀態。
相關內容
Was this useful?
