菜单栏图标状态

作者：steipete · 更新日期：2025-12-06 · 范围：macOS 应用（apps/macos）

• 空闲： 正常图标动画（眨眼、偶尔摇晃）。
• 暂停： 状态项使用 appearsDisabled；无动效。
• 语音触发（大耳朵）： 语音唤醒检测器在识别到唤醒词时调用 AppState.triggerVoiceEars(ttl: nil)，在捕获话语期间保持 earBoostActive=true。耳朵放大（1.9x），加上圆形耳洞以提高可读性，静默 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 保持短（<10s），如果任务挂起图标能快速回到基线。