macOS companion app
メニューバーアイコン
メニューバーアイコンの状態
対象範囲：macOS アプリ（apps/macos）。レンダリング：CritterIconRenderer.makeIcon(...)。アニメーション／状態の連携：CritterStatusLabel + CritterStatusLabel+Behavior.swift。
状態
| 状態 | トリガー | 表示 |
|---|---|---|
| アイドル | デフォルト | 通常のまばたき／揺れアニメーション。目を開いている間は光沢のある輝きを維持 |
| 一時停止 | isPaused=true |
目を開けたまま触角が垂れる（「勤務時間外」）。動きなし |
| スリープ | Gateway が切断済み／未設定 | 触角が垂れ、目が閉じて ⌣ ⌣ のまぶたになる。動きなし |
| お祝い | メッセージ送信時（sendCelebrationTick） |
約 0.9s の間、目が楽しげな ∩ ∩ の弧に変わり、脚を蹴り上げる |
| 音声ウェイク（大きな耳） | ウェイクワードを検出 | 触角がまっすぐ上向きになり、より高く伸びる（earScale=1.9）。無音になると元に戻る |
| 作業中 | isWorking=true または有効な IconState |
脚の揺れが高速化（legWiggle は最大 1.0）し、小さな水平オフセットが加わる。アイドル時の揺れに加算 |
セッションにアクティブなジョブまたはツールがある場合、ツールアクティビティバッジ（SF Symbol の円形バッジ。たとえば exec では chevron.left.slash.chevron.right）を同じクリッターアイコンの上に表示できます。このバッジは IconState／ActivityKind から取得されます。完全な状態モデルについては、メニューバーを参照してください。
音声ウェイク時の耳
- トリガー：
AppStateStore.shared.triggerVoiceEars(ttl: nil)。音声ウェイクのキャプチャパイプライン（VoiceWakeRuntime）および音声ウェイクのデバッグ／テストツール（VoiceWakeTester、VoiceWakeOverlayController）から呼び出されます。 - 停止：
stopVoiceEars()。キャプチャの確定時に呼び出されます。 - 確定前の無音時間：通常は
2.0s。トリガーワードだけが検出され、その後に発話が続かなかった場合は5.0s（VoiceWakeRuntime.silenceWindow／triggerOnlySilenceWindow）。 - 強調表示中は、アイドル時のまばたき／揺れ／脚／耳のタイマーが一時停止します（
CritterStatusLabel+BehaviorではearBoostActiveがアニメーションタスクを制御します）。
形状とサイズ
- キャンバス：18x18pt のテンプレート画像。Retina でアイコンを鮮明に保つため、36x36px のビットマップバッキングストア（2x）にレンダリングされます。
- 耳のスケールはデフォルトで
1.0。音声ブーストでは全体のフレームを変更せずにearScale=1.9に設定します。 antennaDroop（0-1）は、一時停止およびスリープ時のポーズで触角を下向きに折り曲げます。- 脚の素早い動きには、最大
1.0のlegWiggleと小さな水平揺れを使用します。
動作上の注意
- 耳や作業中状態を切り替える外部 CLI／ブローカーのトグルはありません。意図しない頻繁な切り替わりを避けるため、どちらもアプリ内部のシグナル（
AppState.setWorking、AppState.triggerVoiceEars）によって駆動されます。 - ジョブが停止した場合でもアイコンがすぐに基準状態へ戻るよう、新しい TTL は短く（10s を十分に下回る値に）設定してください。
関連項目
Was this useful?
