ShotGlass は何をしますか？
ShotGlassのMCPツールを通じて録画を行います。インストールされているサーバーの現在のスキーマに従ってツール名とパラメータを使用してください。
最初に
新しいデモを録画するには、2回の呼び出しを行います：
recording_prepare({app:"Notes", allowSystemDisplayPrompt:true})— リクエストされたアプリに置き換えてください。返されたスクリーンショット、参照、およびsnapshotIdを読み取ります。compose({snapshotId, beats})— 一連の操作をまとめて送信します。ShotGlassが録画し、ウィンドウを復元し、エディタでプロジェクトを開きます。
返された状態からビートを構築します：{ref:"<返されたref>"}、{type:"text"}、{key:"cmd+s"}、または {point:{x,y},action:"click"}。プレースホルダーは実際の返された値に置き換えてください。スクリーンショットの座標は screenshot.origin + 画像座標 です。ダイアログ操作には安定したキーボードナビゲーションを使用し、デモタスクでファイルを保存する場合は expectedFiles を含めてください。
リクエストに応じた提供
- デモを録画する： スタイルや出力オプションは設定しないでください。元のフレーミングと編集可能なカーソルを保持し、エディタを開きます。
- 録画してレンダリングする： 同じ
compose呼び出しでoutput:{mode:"video"}を設定します。返されたdelivery.videoPathを報告してください。 - 自動スタイリングやズームを適用する： リクエストがあった場合のみ
naturalStyle:trueを設定します。 - 既存の録画を編集する： エディタツールで目的のプロジェクトを確認し、リクエストされた編集を適用します。レンダリングは要求された場合のみ行います。
バックグラウンド操作には参照を優先してください。座標操作には実際の入力が必要な場合があります。allowRealInput:true は既存のユーザー承認がある場合のみ設定し、それ以外はShotGlassに承認をリクエストさせてください。1つのShotGlassインスタンスを再利用し、ホストアクションループや別のレコーダーを使わずに、計画した操作をまとめて送信してください。
ブロックされた場合
ツールがない場合は、セットアップを参照してください。アプリとMCPサーバーは、録画対象のMac上で実行されている必要があります。
権限、アラート、またはキャンセルによって録画が中断された場合は、返されたプロジェクトを保持し、特定のブロッカーを報告してください。ユーザーデータを変更するアラートを盲目的に再試行したり却下したりしないでください。2回の呼び出しパスは、準備され計画可能なデモに適用されるものであり、失敗したテイクが完了したふりをするための要件ではありません。