跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
選單列圖示狀態

作者：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 背ing store）。
  • 快跑會使用最高約 1.0 的腿部晃動，並帶有小幅水平抖動；它會疊加到任何現有的閒置晃動上。
行為備註
  • 耳朵／工作中狀態沒有外部 CLI/broker 切換；請將其保留為應用程式自身訊號的內部行為，以避免意外反覆切換。
  • 保持 TTL 簡短（<10 秒），這樣如果工作停滯，圖示也能快速回到基準狀態。

​
相關