ShotGlass 是做什麼的？
透過 ShotGlass 的連接 MCP 工具進行拍攝。使用已安裝伺服器的當前架構（schema）來取得工具名稱與參數。
從這裡開始
對於新的示範，請使用兩個呼叫：
recording_prepare({app:"Notes", allowSystemDisplayPrompt:true})— 替換為要求的應用程式。讀取回傳的螢幕截圖、參考資料（refs）與snapshotId。compose({snapshotId, beats})— 一次提交整個序列。ShotGlass 會拍攝影片、還原視窗，並在編輯器中開啟專案。
根據回傳的狀態建立 beats：{ref:"<回傳的 ref>"}、{type:"text"}、{key:"cmd+s"} 或 {point:{x,y},action:"click"}。將佔位符替換為實際回傳的值。螢幕截圖的點座標為 screenshot.origin + 圖片座標。對對話框使用穩定的鍵盤導航，並在示範任務儲存檔案時包含 expectedFiles。
傳遞所需的內容
- 拍攝示範： 不設定樣式與輸出選項。保留原始構圖與可編輯游標，然後開啟編輯器。
- 拍攝並渲染： 在同一個
compose呼叫中設定output:{mode:"video"}。回報回傳的delivery.videoPath。 - 套用自動樣式或縮放： 僅在要求時設定
naturalStyle:true。 - 編輯現有錄製內容： 使用編輯器工具檢查目標專案，然後套用要求的編輯。僅在要求時渲染。
背景動作偏好使用參考資料（refs）。座標動作可能需要真實輸入。僅在已有使用者授權時設定 allowRealInput:true，否則讓 ShotGlass 請求核准。重複使用單一 ShotGlass 實例，並一起提交規劃好的動作，而非使用主機動作迴圈或其他錄製工具。
如果遇到阻礙
如果缺少工具，請參閱設定。應用程式與 MCP 伺服器必須在要拍攝的 Mac 上執行。
如果權限、提示框或取消操作中斷拍攝，請保留回傳的專案並回報具體阻礙。請勿盲目重試或關閉會更改使用者資料的提示框。兩個呼叫的途徑適用於已準備好、可規劃的示範，而非要求假裝失敗的拍攝已完成。