菜单栏图标状态

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

• 空闲状态： 正常的图标动画（眨眼、偶尔摇摆）。
• 暂停状态： 状态项使用 appearsDisabled；没有动作。
• 语音触发（大耳朵）： 当检测到唤醒词时，语音唤醒检测器会调用 AppState.triggerVoiceEars(ttl: nil)，在捕获语音期间保持 earBoostActive=true。耳朵会放大（1.9 倍），出现圆形耳孔以提高可读性，然后在 1 秒静音后通过 stopVoiceEars() 恢复。仅在应用内语音管道中触发。
• 工作中（Agent 运行）： AppState.isWorking=true 会驱动”尾巴/腿部快速移动”微动画：在工作进行时，腿部摇摆更快并有轻微偏移。目前在 WebChat Agent 运行时切换；当你接入其他长时间任务时，也可以添加相同的切换。

接入点

• 语音唤醒： runtime/tester 在触发时调用 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 秒），这样如果任务挂起，图标可以快速恢复到基线状态。