LiPet ユーザー＆機能ガイド

シングルクリック：姿勢に応じたコンテキスト反応

クリックされたとき、無関係なアクションへ突然切り替わることはありません。まず 2〜3 フレームの事前確認（目や耳を向ける）を行い、現在の姿勢に応じた自然な反応を返します：

• 立ち/歩行中： 足を止め、首をかしげて見つめたり、ゆっくり瞬きしたり、前足を上げます。
• 睡眠中： 耳を動かし、片目を開けて周囲を確認。邪魔がなければ再び眠りに戻ります。
• 毛づくろい中： 安全な切れ目で毛づくろいを止め、こちらを見上げます。
• 歩行中： 滑らかに足を止め、カーソルの方を向きます。

連続タップと不機嫌メーター

適度なタッチには心地よい反応を返しますが、3秒以内に連続してつ突くと touchSaturation（タッチ飽和）が蓄積します：

• 1回目： 好奇心に満ちた通常の反応。
• 約1.5秒以内の2回目： 同じ反応シーケンスの後半を再生。
• 約3秒以内の3回目以上： 飽和閾値に達し、前足でカーソルを払いのけたり、尻尾を振って背を向けます。
• クールダウン： 約6秒間放っておくと飽和度がゼロに戻り、通常の状態に回復します。

ダブルクリックとジェスチャー判定ウィンドウ

ダブルクリック時に意図しないシングルクリック反応が誤発火するのを防ぐため、内部で約 250ms の判定ウィンドウを設けています。ダブルクリックの割り当てがある場合、最初のクリックは待機状態となり、250ms 以内に2回目のクリックを検出するとシングルクリックをキャンセルしてペットカードやアシスタントを開きます。

長押しと物理ドラッグ

約 500ms 押し続けると長押しスキルが発動します。4〜6 ピクセル以上カーソルを移動させると、即座にネイティブドラッグへ移行します：

• 首元をつままれた反応： つままれてぶら下がる姿勢（被拎起）になり、影が浮き上がります。
• マルチディスプレイ対応： 複数のモニターやウィンドウ間をスムーズに移動可能。
• 着地と帰巣記憶： 離すと柔らかく着地（落地）し、周囲を確認。20〜60秒のクールダウン後、お気に入りの居場所へ歩いて戻るかを自律判断します。

4つの分割レイアウト

ペットセンターで以下の4つのレイアウトから選択できます：

• whole — 全身を1つの領域（all）として扱う。
• rows2 — 上下2分割：top（耳・頭・背中上部）と bottom（お腹・足・尻尾）。
• cols2 — 左右2分割：left（顔・前足）と right（背中・尻尾）。
• grid3 — 3×3 の9マス精密グリッド（r1c1 〜 r3c3）。

アルファテストによるピクセル透過

タッチ判定はペットの表示されている不透明ピクセルのみで行われます。周囲の透明領域は完全にクリック透過され、作業中のウィンドウを邪魔しません。

独立したジェスチャー割り当て

各ゾーンごとに tap（クリック）、double-tap（ダブルクリック）、long-press（長押し）を個別に割り当て可能。頭タップで天気、お腹ダブルクリックで AI 残高確認、背中長押しで CPU モニターなど。

ペットセンターによる同期管理

タッチマッピングはペットごとの設定として保存され、リビジョン管理によって他の Mac とも安全に同期されます。

5段階の頻度ウェイト調整

LiPet の頻度は固定タイマーではなく、自律セレクター内の相対的な重み付けです：

• 1 — 非常にまれ：特別なレアアクション。
• 10 — まれ：たまに行う伸びや遊び。
• 50 — 普通（デフォルト）：日常の歩行や毛づくろい。
• 100 — よく行う：好奇心旺盛な探索。
• 200 — 頻繁：活発なデスクトップ散歩。

自発的出現の許可スイッチ

各行動には [自発的出現を許可] スイッチがあります。オフにすると勝手に始まることはなく、特定のアクションからの連鎖や外部イベントによってのみ実行されます。

スプライトフレーム描画とオンデマンドエンジン

LiPet は軽量なスプライトフレーム（Sprite Frames）でアニメーションを描画し、描画フレームレートは素材自体のフレームレートを上限として動作します。行動エンジンは固定ポーリングではなく必要に応じたオンデマンド判定を行い、行動に合わせて判定間隔を動的に調整します。画面ロック時やスリープ時はエンジンが完全停止し、バックグラウンドのリソースを消費しません。

外部環境・イベント連携

現実世界のシグナルとペットを接続：

• 天気連動： 外が雨なら毛をブルブルと振るい、寒い日には丸まって震えます。
• macOS おやすみモード/集中モード： 集中モードに入ると自動的に静止・睡眠状態になります。
• 画面共有/フルスクリーン： 画面端に静かに控えて邪魔をしません。

宣言型クラウドデータパケット

バイナリ実行ファイルや複雑なスクリプトではなく、Manifest、UI 定義、コマンドをまとめた軽量データパケットとして配布。公式スキルはクラウドから即時に配信されます。

透明性の高い権限モデル

スキルのインストール時に、アクセスする API ドメインや通知権限が明確に提示されます。特権操作は厳格なホワイトリストで保護されています。

3層の配信パイプライン

スキル結果は適切なレイヤーで提示されます：

• L1 ペット吹き出し： 重要な通知を1行で要約。
• L2 タイムライン： 過去の履歴や残高の推移を静かに記録。
• L0 ペットアクション： ポップアップを出さず、ペットの身振りで通知。

AI 残高 Gauge パネル

OpenAI、Anthropic Claude、Google Gemini の API クォータ残高を直感的な円形ゲージで可視化。タップひとつですぐに確認できます。

メニューバー常駐と Dock アイコンの個別設定

ワークスタイルに合わせて表示場所を柔軟に選択可能：

• メニューバーアイコン： macOS のメニューバーに小さなアイコンを表示し、素早くメニューや設定へアクセス。
• Dock アイコン： macOS の Dock にアイコンを表示し、標準的なウィンドウ管理や切り替えに対応。

Dock アイコンのペット追従

Dock 表示時、アイコンが現在選ばれているペットの毛色や状態をリアルタイムに反映します。

誤操作を防ぐリカバリー保証

Dock アイコンとメニューバーアイコンの両方を同時にオフにすることはできません。常に設定画面に戻れる導線が確保されます。