菜单栏图标状态¶
范围: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