跳转至

菜单栏图标状态

范围:macOS 应用(apps/macos)。渲染:CritterIconRenderer.makeIcon(...)。动画/状态接线:CritterStatusLabel + CritterStatusLabel+Behavior.swift。

Dock 图标

在 Mac 应用的 Dashboard 中,通过 Settings → This Mac → Dock icon 选择 Dock 图标:

  • Original(默认):纸片磁贴上的原始 Molty 剪影。
  • Heritage:README 中的传统龙虾,举着爪子。
  • Clawmark:粗犷、雕塑感的龙虾钳。
  • Origami:折叠、多面体的 Molty。
  • Pincer:单钳剪影,手腕圆润流畅。
  • Open C:圆形钳子,带有两个相对的钳尖。

每种设计都有浅色和深色美术资源。 在 macOS 26 及更高版本中,Original 使用原生图标样式,包括 System Settings → Appearance → Icon & widget style 中的设置。若要自动切换, 请在那里选择 Dark → Auto;否则,即使应用窗口为深色,默认图标样式也可以保持浅色。 在旧版 macOS 上,Original 在应用运行期间会跟随浅色/深色外观。

其他设计在 OpenClaw 运行期间会跟随 macOS 浅色/深色外观。

选择会为每个 OpenClaw 配置文件单独保存,并立即生效。 自定义设计会更改正在运行的应用的 Dock 图标;退出后,Finder 和 Dock 磁贴使用 捆绑的 Original 图标。菜单栏小生物及其动画是独立的。

Original 的源文件是 apps/macos/Icon.icon;其他矢量设计位于 apps/macos/AppIconDesigns。编辑后,使用 bash scripts/generate-mac-app-icons.sh 重新生成成对资源,并使用 bash scripts/generate-mac-app-icons.sh --check 进行验证。生成器负责自定义深色 背景和单色前景颜色,Apple 的资源编译器提供 macOS 蒙版和填充。 打包还会编译主 Icon Composer 文档以用于原生样式。

状态

状态 触发条件 视觉效果
空闲 默认 正常眨眼/摆动动画;睁开的眼睛保持光泽高光
暂停 isPaused=true 触角下垂(“下班”),眼睛睁开;无动作
睡眠 Gateway 断开/未配置 触角下垂,眼睛闭合成 ⌣ ⌣ 眼睑;无动作
庆祝 消息已发送(sendCelebrationTick) 眼睛闪烁出开心的 ∩ ∩ 弧线约 0.9 秒,并伴随腿部踢动
语音唤醒(大耳朵) 听到唤醒词 触角笔直竖起并变高(earScale=1.9);静音后落下
工作中 isWorking=true 或活动 IconState 更快的腿部摆动(legWiggle 最高 1.0)并伴随小的水平偏移;叠加到空闲摆动上

当会话有活动任务或工具时,工具活动徽章(SF Symbol 圆盘,例如 exec 使用 chevron.left.slash.chevron.right)可以渲染在同一个角色图标上方。该徽章来自 IconState/ActivityKind;完整状态模型见 菜单栏。

语音唤醒耳朵

  • 触发:语音捕获和覆盖层所有者在捕获或覆盖层展示开始时设置 AppState.earBoostActive。
  • 停止:这些所有者在捕获完成或覆盖层关闭时清除它。
  • 完成前的静音窗口:通常为 2.0s;如果只听到触发词且没有后续语音,则为 5.0s(VoiceWakeRuntime.silenceWindow / triggerOnlySilenceWindow)。
  • 增强期间,空闲眨眼/摆动/腿部/耳朵计时器会暂停(earBoostActive 在 CritterStatusLabel+Behavior 中门控动画任务)。

形状和尺寸

  • 画布:18x18pt 模板图像,渲染到 36x36px 位图后备存储(2x),使图标在 Retina 上保持清晰。
  • 耳朵缩放默认值为 1.0;语音增强设置 earScale=1.9,不改变整体框架。
  • antennaDroop(0-1)将触角向下折叠,用于暂停和睡眠姿势。
  • 腿部小跑使用 legWiggle 最高 1.0,并伴随小的水平抖动。

行为说明

  • 应用管理的活动、捕获和覆盖层生命周期驱动耳朵和工作状态。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw