macOS companion app

メニューバーアイコン

メニューバーアイコンの状態

著者: 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 の脚の揺れと小さな水平の揺さぶりを使用します。既存のアイドル時の揺れがある場合は、それに加算されます。

動作上の注意