ScreenBeaver/ScreenBeaver

Construtor de demonstração ao vivo do Screen Beaver

O usuário quer ficar ocioso enquanto você dirige o produto deles (cursor suave + cliques + digitação real) e constrói um vídeo do Screen Beaver. Prefira captura nativa (sem seletor de compartilhamento do Windows). As edições são aplicadas no modo automático (uma receita). Eles clicam em Exportar por conta própria.

Regras rígidas

1. Use apenas o MCP screen-beaver. Prefira record_and_build (inclui automação de demonstração). Use ferramentas atômicas demo_* ou run_demo para caminhos de clique personalizados.
2. Se screen-beaver estiver ausente da lista de ferramentas MCP desta sessão, pare. Diga ao usuário para ativá-lo em Customize → MCPs, executar npm run mcp:install uma vez e depois recarregar o Cursor / iniciar um novo chat. Não recorra a HTTP bruto, curl, fetch ou Shell contra 127.0.0.1:17355.
3. Nunca escreva ou execute scripts .ps1, .bat, .cmd ou outros scripts de shell para se comunicar com o Screen Beaver.
4. Nunca crie arquivos JSON de demonstração/receita no disco como alternativa — passe etapas/payloads nos argumentos da ferramenta MCP.
5. Não chame export_mp4 a menos que o usuário diga explicitamente para exportar.
6. Mantenha o Screen Beaver desktop aberto (npm run desktop:dev ou o aplicativo instalado). Ponte: http://127.0.0.1:17355 (usada apenas pelo servidor MCP). Se ping_studio falhar, diga a eles para abrir o aplicativo — não trave.
7. Nunca peça para clicarem no seletor de compartilhamento de tela do sistema — use start_capture / record_and_build (seleção nativa de janela).
8. Nunca grave uma página em branco sem fazer nada e apenas adicione legendas. Sempre dirija a UI durante a captura.
9. Mantenha as gravações tão curtas quanto o script precisar. Pare assim que o último clique/digitação terminar (durationSec de acréscimo ≤ ~0,4s). Não adicione longas esperas no final.
10. Use demo_type / { op: "type", text } para digitação — tecla por tecla, nunca cole da área de transferência.
11. Narre brevemente no chat para que eles observem a janela do Screen Beaver.
12. Coordenadas: chame get_window_layout (ou use contentNx/contentNy) — nunca confie no tamanho do navegador embutido do Cursor. contentNx/contentNy relativos à página mapeiam automaticamente através do chrome do navegador.
13. Modo automático: deixe o estúdio derivar zooms + efeitos sonoros de digitação a partir de cliques/teclas reais. Não coloque manualmente zooms/sons que conflitem com o Auto. Use apenas legendas do record_and_build + regenerateAutoZooms.
14. Narração: após as legendas, chame generate_voiceover (inglês padrão). Se o usuário pedir outro idioma, passe targetLang (ex.: hi-IN) — as legendas são traduzidas primeiro, depois o Edge TTS. Prefira record_and_build({ voiceover: true, voiceoverLang }) que faz isso automaticamente.
15. Música de fundo: use Openverse via MCP (pick_background_music / record_and_build com backgroundMusic: true). Sem Pixabay / chaves .env. Efeitos de brilho/toque usam o SFX shimmer incluído (Shining.mp3).

Fluxo de trabalho A — total autônomo (abre a UI do Screen Beaver primeiro)

record_and_build agora:

1. focus_studio — traz o Screen Beaver para frente
2. open_record_picker — abre a mesma interface "Iniciar uma nova gravação" / opções de compartilhamento
3. Abre productUrl / aplicativo
4. start_capture — seleciona a janela nativamente (Aplicativo), mostra Gravando…
5. Executa demoSteps
6. Para imediatamente + zooms/legendas automáticos a partir da gravação
7. generate_voiceover — Inglês por padrão; traduz+TTS quando voiceoverLang está definido
8. pick_background_music — faixa Openverse CC (instrumental corporativo suave)

ping_studio
  → record_and_build({
      productName, productUrl, titleContains: "Edge",
      voiceover: true,
      voiceoverLang: "en-US",   // ou "hi-IN" / "es-ES" etc.
      backgroundMusic: true,
      musicQuery: "upbeat corporate instrumental",
      demoSteps: [ ... ],
      introCaption: "...",
      features: [{ title: "Fazer login", atSeconds: 3 }]
    })
  → Diga ao usuário: clique em Exportar quando estiver pronto

Ou em uma gravação existente: generate_voiceover({ targetLang: "en-US" }) pick_background_music({ query: "calm tech ambient instrumental" }) generate_voiceover({ speakLang: "en-US", targetLang: "hi-IN" })

Etapas de demonstração

op	significado
wait	{ ms } — mantenha curto; sem acréscimos longos no final
move / click	prefira { contentNx, contentNy } 0..1 na página web; ou { nx, ny } na janela externa
type	{ text, delayMs? } tecla por tecla (emite SFX de digitação)
scroll / focus / right_click	como antes

Limites

• Captura nativa + automação de entrada são apenas para Windows desktop.
• Entrada de mouse/teclado da demonstração funciona apenas enquanto a captura estiver em execução.
• A caixa de diálogo de Compartilhar do sistema nunca é mostrada aos agentes — o Screen Beaver exibe as opções de compartilhamento no aplicativo e depois captura a janela nativamente.