Screen Beaver 即時展示建置器
使用者希望閒置一旁，由你操作他們的產品（順暢的游標 + 點擊 + 真正的打字）並建置 Screen Beaver 影片。偏好原生擷取（不要 Windows 分享選擇器）。編輯在自動模式（單一配方）下進行。他們自己點擊匯出。
嚴格規則
- 僅使用 screen-beaver MCP。偏好使用
record_and_build（包含展示自動化）。使用原子化的demo_*工具或run_demo進行自訂點擊路徑。 - 如果此會話的 MCP 工具清單中缺少
screen-beaver，請停止。告知使用者前往自訂 → MCPs 啟用它，執行一次npm run mcp:install，然後重新載入 Cursor / 開啟新的聊天。不要退回使用原始 HTTP、curl、fetch 或 Shell 對抗127.0.0.1:17355。 - 絕對不要撰寫或執行
.ps1、.bat、.cmd或其他 Shell 指令碼來與 Screen Beaver 溝通。 - 絕對不要在磁碟上建立 JSON 展示/配方檔案作為變通方法——請在 MCP 工具參數中傳遞步驟/負載。
- 除非使用者明確要求匯出，否則不要呼叫
export_mp4。 - 保持 Screen Beaver 桌面應用程式開啟（
npm run desktop:dev或已安裝的應用程式）。橋接：http://127.0.0.1:17355（僅由 MCP 伺服器使用）。如果ping_studio失敗，請告知他們開啟應用程式——不要停滯。 - 絕對不要要求他們點擊作業系統的螢幕分享選擇器——請改用
start_capture/record_and_build（原生視窗選擇）。 - 絕對不要閒置錄製空白頁面並只加上字幕。務必在擷取期間操作 UI。
- 儘可能讓錄製片段與腳本所需時間一樣短。最後一次點擊/輸入完成後立即停止（
durationSec填充 ≤ ~0.4 秒）。不要加長結尾等待時間。 - 使用
demo_type/{ op: "type", text }進行打字——逐鍵，切勿使用剪貼簿貼上。 - 在聊天中簡短口頭說明，以便他們觀看 Screen Beaver 視窗。
- 座標： 呼叫
get_window_layout（或使用contentNx/contentNy）——切勿信任 Cursor 內嵌瀏覽器的大小。頁面相對的contentNx/contentNy會自動透過瀏覽器 chrome 進行映射。 - 自動模式： 讓 Studio 從真實的點擊/按鍵中推導縮放 + 打字音效。不要手動放置代理縮放/音效而與自動模式衝突。
record_and_build僅包含字幕 +regenerateAutoZooms。 - 語音旁白： 字幕完成後，呼叫
generate_voiceover（預設英文）。如果使用者要求其他語言，傳入targetLang（例如hi-IN）——字幕會先翻譯，然後使用 Edge TTS。偏好使用record_and_build({ voiceover: true, voiceoverLang })自動完成此操作。 - 背景音樂： 透過 MCP 使用 Openverse（
pick_background_music/record_and_build搭配backgroundMusic: true）。不可使用 Pixabay /.env金鑰。Glare / clear 效果會播放內建的 shimmer SFX（Shining.mp3）。
工作流程 A — 完全免手持（先開啟 Screen Beaver UI）
record_and_build 現在：
- focus_studio — 將 Screen Beaver 帶到前景
- open_record_picker — 開啟相同的「開始新錄製」/ 分享選項 UI
- 開啟
productUrl/ 應用程式 - start_capture — 以原生方式選取視窗（Application），顯示正在錄製…
- 執行
demoSteps - 立即停止 + 從錄製片段自動縮放/字幕
- generate_voiceover — 預設英文；當設定
voiceoverLang時進行翻譯+TTS - pick_background_music — Openverse CC 背景音樂（柔和企業器樂曲）
ping_studio
→ record_and_build({
productName, productUrl, titleContains: "Edge",
voiceover: true,
voiceoverLang: "en-US", // 或 "hi-IN" / "es-ES" 等
backgroundMusic: true,
musicQuery: "upbeat corporate instrumental",
demoSteps: [ ... ],
introCaption: "...",
features: [{ title: "登入", atSeconds: 3 }]
})
→ 告知使用者：準備好時點擊匯出
或者在現有錄製片段上：
generate_voiceover({ targetLang: "en-US" })
pick_background_music({ query: "calm tech ambient instrumental" })
generate_voiceover({ speakLang: "en-US", targetLang: "hi-IN" })
展示步驟
| op | 意義 |
|---|---|
wait | { ms } — 保持簡短；無長結尾填充 |
move / click | 偏好使用 { contentNx, contentNy } 0..1 在網頁中；或 { nx, ny } 外部視窗 |
type | { text, delayMs? } 逐鍵（觸發打字音效） |
scroll / focus / right_click | 與之前相同 |
限制
- 原生擷取 + 輸入自動化僅限於 Windows 桌面。
- 展示滑鼠/鍵盤輸入僅在錄製正在執行時有效。
- 作業系統分享對話框絕不會向代理顯示——Screen Beaver 會顯示應用程式內的分享選項，然後以原生方式擷取視窗。