菜单栏图标状态

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

• 空闲： 正常图标动画（眨眼，偶尔摆动）。
• 暂停： 状态项使用 appearsDisabled；无运动。
• 语音触发（大耳朵）： 语音唤醒检测器在听到唤醒词时调用 AppState.triggerVoiceEars(ttl: nil)，在捕获话语时保持 earBoostActive=true。耳朵放大（1.9x），为了可读性添加圆形耳孔，然后在 1 秒沉默后通过 stopVoiceEars() 下降。仅从应用内语音管道触发。
• 工作中（智能体运行）： AppState.isWorking=true 驱动"尾巴/腿快速移动"微动作：工作时腿摆动更快并轻微偏移。目前围绕 WebChat 智能体运行切换；当你将它们连接时，在其他长时间任务周围添加相同的切换。

连接点

• 语音唤醒：运行时/测试器在触发时调用 AppState.triggerVoiceEars(ttl: nil)，在 1 秒沉默后调用 stopVoiceEars() 以匹配捕获窗口。
• 智能体活动：在工作范围周围设置 AppStateStore.shared.setWorking(true/false)（已在 WebChat 智能体调用中完成）。保持范围简短并在 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/代理切换耳朵/工作；保持它内部于应用的自己的信号以避免意外摆动。
• 保持 TTL 短（<10s），以便如果作业挂起，图标快速返回基线。