菜单栏图标

菜单栏图标状态

作者：steipete · 更新时间：2025-12-06 · 范围：macOS 应用 (apps/macos)

• 空闲： 正常的图标动画（闪烁，偶尔摆动）。
• 已暂停： 状态项使用 appearsDisabled；无动作。
• 语音触发（大耳朵）： 当听到唤醒词时，语音唤醒检测器调用 AppState.triggerVoiceEars(ttl: nil)，在捕获语音期间保持 earBoostActive=true。耳朵放大（1.9 倍），为了可读性变成圆形耳孔，然后在静音 1 秒后通过 stopVoiceEars() 恢复。仅由应用内语音管道触发。
• 工作中（代理运行中）： AppState.isWorking=true 驱动“尾巴/腿部疾跑”微动作：在工作进行时腿部摆动更快并轻微偏移。目前围绕 WebChat 代理运行进行切换；在连接其他长任务时添加相同的切换。

连接点

• 语音唤醒：runtime/tester 在触发时调用 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），以便在作业挂起时图标快速恢复到基线。