菜单栏图标状态
作者： steipete · 更新时间： 2025-12-06 · 范围： macOS 应用（apps/macos）
图标状态
- 空闲（Idle）：正常图标动画（眨眼、偶尔摇摆）。
- 暂停（Paused）：状态项使用
appearsDisabled；无动画。 - 语音触发（大耳朵）：语音唤醒检测器在听到唤醒词时调用
AppState.triggerVoiceEars(ttl: nil)，在捕获语音期间保持earBoostActive=true。耳朵放大（1.9 倍），获得圆形耳洞以提高可读性，然后在 1 秒静默后通过stopVoiceEars()恢复。仅从应用内语音管道触发。 - 工作中（Agent 运行中）：
AppState.isWorking=true驱动"尾巴/腿部快速移动"微动画：工作进行中时腿部摆动更快且有轻微偏移。目前在 WebChat agent 运行时切换；在连接其他长时间任务时添加相同的切换。
连接点
- 语音唤醒：运行时/测试器在触发时调用
AppState.triggerVoiceEars(ttl: nil)，在 1 秒静默后调用stopVoiceEars()以匹配捕获窗口。 - Agent 活动：在工作时段前后设置
AppStateStore.shared.setWorking(true/false)（已在 WebChat agent 调用中完成）。保持时段短暂，并在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/broker 切换耳朵/工作状态；保持它在应用自身信号内部，以避免意外的状态翻转。
- 保持 TTL 短（<10 秒），以便在任务挂起时图标快速恢复到基线。