OpenClaw 🦞

菜单栏图标

菜单栏图标状态

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

  • 空闲： 正常图标动画（眨眼、偶尔摆动）。
  • 暂停： 状态项使用 appearsDisabled；无动作。
  • 语音触发（大耳朵）： 当听到唤醒词时，语音唤醒检测器调用 AppState.triggerVoiceEars(ttl: nil)，在捕获话语期间保持 earBoostActive=true。耳朵放大（1.9 倍），获得圆形耳孔以提高可读性，然后在 1 秒静音后通过 stopVoiceEars() 放下。仅从应用内语音管道触发。
  • 工作中（agent 运行）： AppState.isWorking=true 驱动"尾巴/腿部 scurry"微动作：工作进行中时腿部摆动更快并略有偏移。目前围绕 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 x 18 pt 模板图像渲染到 36 x 36 px Retina 后备存储）。
  • Scurry 使用腿部摆动至约 1.0，带有小幅水平抖动；它添加到任何现有的空闲摆动之上。

行为说明

  • 没有用于耳朵/工作的外部 CLI/broker 切换；将其保持在应用自己的信号内部以避免意外波动。
  • 保持 TTL 较短（<10s），以便如果作业挂起，图标能快速返回基线。