選單列圖示狀態¶
作者：steipete · 更新：2025-12-06 · 範圍：macOS 應用程式（apps/macos）
- 閒置： 一般圖示動畫（眨眼、偶爾擺動）。
- 暫停： 狀態項目使用
appearsDisabled；無任何動作。 - 語音觸發（大耳朵）： 語音喚醒偵測器在聽到喚醒詞時呼叫
AppState.triggerVoiceEars(ttl: nil)，並在擷取語句期間維持earBoostActive=true。耳朵等比例放大（1.9x），為了可讀性出現圓形耳洞，接著在 1 秒無聲後透過stopVoiceEars()回落。僅由應用程式內的語音管線觸發。 耳朵縮放放大（1.9x），為了可讀性加入圓形耳洞，然後在 1 秒靜默後透過stopVoiceEars()放下。 僅由應用程式內的語音管線觸發。 - 工作中（代理程式執行）：
AppState.isWorking=true觸發「尾巴／腿部疾走」的微動作：腿部擺動加快，並在工作進行中產生輕微位移。目前在 WebChat 代理程式執行期間切換；當你串接其他長時間任務時，請在其周圍加入相同的切換。 目前是在 WebChat 代理執行前後切換；在你接線時，請在其他長時間任務周圍加入相同的切換。
接線點
- 語音喚醒：在觸發時由 runtime/tester 呼叫
AppState.triggerVoiceEars(ttl: nil)，並在 1 秒無聲後呼叫stopVoiceEars()，以符合擷取視窗。 - 代理程式活動：在工作區段前後設定
AppStateStore.shared.setWorking(true/false)（WebChat 代理程式呼叫中已完成）。請保持區段短，並在defer區塊中重設，以避免動畫卡住。 Keep spans short and reset indeferblocks to avoid stuck animations.
形狀與尺寸
- 基礎圖示繪製於
CritterIconRenderer.makeIcon(blink:legWiggle:earWiggle:earScale:earHoles:)。 - 耳朵縮放預設為
1.0；語音增強設定為earScale=1.9，並切換earHoles=true，且不改變整體外框（18×18 pt 的樣板影像，渲染到 36×36 px 的 Retina 背板儲存）。 - Scurry 使用腿部擺動至約 ~1.0，並帶有小幅水平抖動；它會疊加在任何既有的閒置擺動之上。
行為注意事項
- 沒有外部 CLI／代理切換可控制耳朵／工作狀態；請維持在應用程式自身的訊號內部，以避免意外頻繁切換。
- 保持 TTL 短（<10s），以便在工作卡住時圖示能快速回到基線。