macOS 配套应用
菜单栏图标
菜单栏图标状态
范围：macOS 应用（apps/macos）。渲染：CritterIconRenderer.makeIcon(...)。动画/状态连接：CritterStatusLabel + CritterStatusLabel+Behavior.swift。
状态
| 状态 | 触发条件 | 视觉效果 |
|---|---|---|
| 空闲 | 默认 | 正常的眨眼/摆动动画；睁眼时保留光泽亮点 |
| 已暂停 | isPaused=true |
触角下垂（“下班”），眼睛睁开；无动作 |
| 睡眠中 | Gateway 网关断开连接/未配置 | 触角下垂，眼睛闭合成 ⌣ ⌣ 形眼睑；无动作 |
| 庆祝 | 消息已发送（sendCelebrationTick） |
眼睛闪现开心的 ∩ ∩ 弧线约 0.9s，同时踢腿 |
| 语音唤醒（大耳朵） | 听到唤醒词 | 触角挺直并变得更高（earScale=1.9）；静默后恢复 |
| 工作中 | isWorking=true 或存在活动的 IconState |
腿部摆动更快（legWiggle 最高为 1.0），并伴随轻微水平偏移；叠加在空闲摆动效果上 |
当会话存在活动作业或工具时，工具活动徽标（SF Symbol 圆形徽章，例如用于 exec 的 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，并伴随轻微的水平抖动。
行为说明
- 没有用于控制耳朵或工作状态的外部 CLI/代理开关；两者均由应用信号（
AppState.setWorking、AppState.triggerVoiceEars）在内部驱动，以避免意外反复切换。 - 任何新增 TTL 都应保持较短（远低于 10s），以便作业挂起时图标能快速恢复到基准状态。
相关内容
Was this useful?
