Solução de problemas
Corrija problemas comuns do Casper — sync, workspace, imagens quebradas e divergência com o assistente.
A maioria dos problemas vem da pasta que o Casper e seu assistente usam, ou de um slide kit desatualizado. Comece aqui antes de reinstalar o app.
Casper e meu assistente mostram arquivos diferentes
Sintoma: Você briefou o assistente mas nada novo aparece no Casper (ou o contrário).
Correção:
- Confirme que as duas ferramentas apontam para o mesmo caminho exato — não uma cópia, não subpasta, não pasta com conflito de sync na nuvem.
- No Casper, confira o tooltip do workspace na barra lateral (caminho da pasta carregada).
- No assistente, abra essa mesma raiz — você deve ver
slides/no nível superior.
Se os caminhos diferem, use Trocar workspace… no Casper e reabra a pasta correta no assistente.
Falha no sync do slide kit ou comandos sumiram
Sintoma: /create-slide não funciona, Comandos vazio, ou Casper mostra “slide kit não
instalado” / “desatualizado”.
Também tente: no Cursor/Codex, /casper-help — confirma que o kit carregou e mostra
qual comando slash combina com seu objetivo.
Correção:
- Abra a pasta de workspace correta.
- Na barra lateral do Casper, rode Sincronizar kit quando solicitado (ou após trocar workspace).
- Aguarde o sync terminar — seus carrosséis em
slides/não são apagados. Comandos slash removidos do app são podados do kit gerenciado no sync.
O sync só atualiza skills e workflows do assistente em pastas ocultas do kit (por exemplo
.agent/). Suas zonas próprias ficam intactas — veja
O que o sync altera.
Se o sync falhar sempre, verifique permissões de disco na pasta e se não está abrindo volume somente leitura.
Um deck aparece mas parece “órfão” ou avisa sobre o catálogo
Sintoma: Existe pasta em slides/ mas o Casper mostra aviso de que o deck não está em project.json.
O que significa: project.json é o catálogo do workspace (títulos, pastas, ordem). Seu
assistente normalmente mantém ao criar decks. Pasta no disco sem entrada no catálogo ainda abre,
mas metadados podem estar incompletos.
Correção: Peça ao assistente para registrar o deck no catálogo, ou rode /create-slide para
decks novos manter o catálogo consistente. Não precisa editar project.json à mão.
Imagens quebradas ou ausentes na prévia
Sintoma: Placeholder ou ícone de imagem quebrada numa tela antes de exportar.
Correção:
- Abra Assets — confirme que o arquivo existe em
assets/ou na pasta local do deck. - Verifique o caminho que o assistente usou (
@assets/...vsslides/<id>/assets/...). - Briefe de novo com o caminho correto ou envie o arquivo em Assets e peça ao assistente para referenciar.
Veja Assets.
Estágios de produção resetaram ou parecem errados
Sintoma: Colunas kanban vazias ou estágios diferentes do esperado.
O que significa: Estágios ficam em slides/.production-board.json — separado dos arquivos
de tela do carrossel e de project.json.
Correção: Arraste cards entre colunas em Produção. Se trocou de workspace, abra o workspace que possui aquela pasta de projeto.
Exportação não baixou
Sintoma: Escolheu PNG/JPG/PDF mas nenhum arquivo apareceu.
Correção:
- Permita o diálogo de download/salvar (macOS/Windows podem bloquear o primeiro save).
- Em decks com várias telas, o Casper baixa um ZIP — confira Downloads por
<deck-id>.zip. - Tente exportar de novo depois que a prévia carregar todas as telas.
Veja Exportar para redes.
Abri a pasta errada
Sintoma: Grade Slides vazia, decks ausentes ou só conteúdo de exemplo.
Correção: Use Trocar workspace… e escolha a pasta onde seu diretório slides/ mora. Se
for novo, crie ou escolha uma pasta de projeto dedicada primeiro — veja Sua pasta.
App desktop — Trocar workspace ou Abrir no IDE
No macOS/Windows, a barra de menu ou bandeja pode oferecer:
- Trocar workspace… — igual a Trocar workspace… na barra lateral.
- Abrir no IDE — abre a pasta ativa no Cursor (ou padrão do sistema) para briefar o assistente no mesmo caminho.
Ainda travado?
- Releia Primeiros passos — instalar → abrir pasta → briefar → revisar → exportar.
- Confira FAQ para limites do produto (sem app no navegador, sem autopost).
- Para dúvidas de engine/CLI, veja o rodapé do site — trabalho diário de carrossel não exige terminal.