本页内容
本页内容
macOS 配套应用程序
菜单栏图标
菜单栏图标状态
范围:macOS 应用程序 (apps/macos)。渲染图:CritterIconRenderer.makeIcon(...)。 Animation/state接线:CritterStatusLabel + CritterStatusLabel+Behavior.swift。
Dock 图标
在 Mac 应用程序的仪表板内,在 设置 → 本机 → Dock 图标 中选择 Dock 图标:
- Original(默认):纸块上的原始 Molty 轮廓。
- Heritage:带有凸起爪子的传统 README 龙虾。
- Clawmark:大胆的雕刻龙虾钳。
- Origami:折叠的多面 Molty。
- Pincer:单爪轮廓,手腕圆润流畅。
- Open C:带有两个相对钳尖的圆形爪。
每个设计都有浅色和深色的艺术品。原版使用原生图标样式,包括系统设置→外观→图标和小部件样式中的设置。对于自动切换,选择Dark → Auto;即使应用程序窗口是黑色的,默认图标样式也可以保持浅色。
OpenClaw 运行时,其他设计遵循 macOS light/dark 外观。
为每个 OpenClaw 配置文件单独保存选择并立即应用。自定义设计会更改正在运行的应用程序的 Dock 图标;退出后的 Finder 和 Dock 磁贴使用捆绑的原始图标。菜单栏小动物及其动画是独立的。
原始来源为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 文档以实现本机样式。
状态
| 状态 | 扳机 | 视觉 |
|---|---|---|
| 闲置的 | 默认值 | 普通blink/wiggle动画;睁开眼睛保持光泽 |
| 暂停 | isPaused=true |
触角下垂(“下班了”),眼睛睁开;无动作 |
| 睡眠 | 网关 disconnected/unconfigured | 触角下垂,眼睛闭上 ⌣ ⌣ 眼睑;没有动作 |
| 庆祝 | 消息已发送(sendCelebrationTick) |
眼睛闪烁着快乐的 ∩ ∩ 弧线 ~0.9s 加上踢腿 |
| 语音唤醒(大耳朵) | 听到唤醒词 | 触角竖起并变得更高(earScale=1.9);在静默后恢复 |
| 工作中 | isWorking=true 或活动中的 IconState |
更快的腿部扭动(legWiggle 最高到 1.0)并带有轻微的水平偏移;会叠加到空闲扭动之上 |
当会话具有活动作业或工具时,工具活动徽章(SF 符号圆盘、e.g. chevron.left.slash.chevron.right 用于执行)可以呈现在同一小动物图标的顶部。该徽章来自 IconState/ActivityKind;完整状态模型请参见菜单栏。
语音唤耳
- Trigger:语音捕获和叠加所有者在捕获或叠加呈现开始时设置
AppState.earBoostActive。 - Stop:那些所有者在捕获完成或覆盖关闭时清除它。
- 完成前的静默窗口:通常为
2.0s,如果只听到了唤醒词且后续没有语音,则为5.0s(VoiceWakeRuntime.silenceWindow/triggerOnlySilenceWindow)。 - 在提升时,空闲的 blink/wiggle/leg/ear 定时器被暂停(
earBoostActive门控CritterStatusLabel+Behavior中的动画任务)。
形状和尺寸
- 画布:18x18pt 模板图像,渲染到 36x36px 位图后备存储(2x),以便图标在 Retina 屏幕上保持清晰。
- Ear刻度默认为
1.0;语音增强设置earScale=1.9,不改变整体框架。 antennaDroop(0-1)会在暂停和睡眠姿势下将天线向下折叠。- Leg scurry 使用
legWiggle至1.0,具有小的水平抖动。
行为说明
- App 拥有的活动、捕获和覆盖生命周期驱动耳朵和工作状态。