Espaço de trabalho de vídeos curtos
Esta skill pertence ao plugin short-video-studio instalado de forma independente. Não instale uma cópia global nem modifique o repositório fonte do iPolloWork.
Conversa e espaço de trabalho
O usuário conversa na conversa esquerda existente. O espaço de trabalho à direita é uma tela criativa, não um segundo chat. Abra o aplicativo de espaço de trabalho studio do plugin através da entrada de plugin existente do Work. Se já estiver aberto, descubra suas ferramentas usando ipollowork_workspace_app_list_tools e chame-as com ipollowork_workspace_app_call_tool. Não adivinhe uma URL de navegador ou inicie outro servidor editor.
- Chame
project_read. O projeto possuinodes,edges,script,shots,roles,assets,tracks,jobs,exportse umarevisionatual. - Proponha uma história coerente e atualize o mesmo documento com
project_update. Preserve trabalho não relacionado e a revisão atual. Se um conflito de revisão for retornado, releia e reconcilie; não sobrescreva cegamente. - Nós têm
id,kind(text,image,video,audio,script,storyboard),title,prompt,x,y,assetIdopcional esettings. IDs começam com uma letra e contêm apenas letras ASCII, números,_ou-. Arestas são{id, from, to}; elas organizam a tela, mas não são referências de modelo em si. - Shots são
{id, title, prompt, narration, duration, assetId?}em ordem de reprodução. Duração é em segundos. Papéis são{id, name, description, assetId?}. Consistência de personagem é um fluxo de trabalho de prompt/referência, não uma garantia.
Geração real
Chame capabilities antes de escolher um modelo. Use apenas modelos disponíveis/configurados no Work e apenas as opções de parâmetro retornadas. O plugin não se conecta ao LibTV nem armazena outra chave de API.
settings de nó de imagem: modelo, tamanho, qualidade; referenceId opcional para edição de imagem, maskDataUrl para uma máscara PNG transparente fornecida explicitamente. settings de nó de vídeo: modelo, operação, resolução, duração (string), proporção; referenceId para o primeiro quadro, lastFrameId para o último quadro, ou referenceIds para referências multimodais. Modos de primeiro quadro, edição e extensão usam proporção adaptive; edição usa duração -1. style e camera são intenção de prompt, não controles determinísticos nativos.
Nós de áudio sintetizam fala através do canal CosyVoice configurado do Work, usando seu prompt como texto de narração e settings.voice opcional. O serviço mede a duração do MP3 salvo; coloque-o em uma faixa de áudio separada sem truncar a fala. Este não é um modelo de geração musical.
Chame generate apenas quando o usuário pedir para gerar. Pode cobrar do provedor configurado. Passe um requestId UUID novo para uma nova geração pretendida; reutilize o mesmo ID de requisição após um resultado de transporte incerto. Consulte generation_status; nunca reenvie automaticamente uma tarefa incerta. Modelos não suportados, geração musical, serviços proprietários LibTV e autorizações indisponíveis devem ser explicados, não simulados.
Importe mídia local selecionada pelo usuário via import_asset com um path relativo ao espaço de trabalho. Os ativos se tornam cópias de propriedade do projeto. Forneça metadata.durationSeconds para mídia cuja duração não esteja disponível pela inspeção do Work. Não invente uma duração nem use URLs expiráveis remotas em faixas finais. Ativos, jobs e exports gerados/importados são mantidos pelo serviço; project_update não pode fabricá-los.
Entrega editável multitrack
Atribua ativos de imagem/vídeo a shots, depois arrange_shots. Isso substitui as faixas de corte bruto; então pergunte antes de descartar edições manuais existentes de faixas. O som original se torna uma faixa de áudio separada, não mixada no vídeo. Adicione música/voz/SFX como faixas de áudio separadas; legendas permanecem como texto editável.
Faixas contêm {id, label, kind, clips}. Início/duração de clipe usam startFrame/durationFrames inteiros no fps racional do projeto. Clipes de mídia usam source: assets/<nome do arquivo registrado>, sourceDurationSeconds, sourceStartSeconds, playbackRate, volume. Sobreposição na mesma faixa e excedentes de origem são rejeitados. Nunca entregue um MP4 achatado como o projeto editável.
Chame handoff. Retorne o absolutePath resultante ou path relativo ao espaço de trabalho como um link de arquivo local clicável na conversa esquerda e diga ao usuário para abri-lo no Video Studio do Work. O host atual não possui uma API de plugin genérica que mude diretamente para o editor nativo; não afirme que mudou automaticamente. Uma vez entregue, o HTML nativo e os ativos são a fonte de verdade de edição. Nunca os sobrescreva a partir de um documento de tela mais antigo. Entregas alteradas criam um novo arquivo de engenharia; entregas repetidas e inalteradas reutilizam o existente.
Projetos residem em short-video/<project-id>/ do espaço de trabalho escolhido; entregas nativas em video/<id>/. Esses arquivos criados pelo usuário sobrevivem à desinstalação do plugin. O pacote, a skill e os dados temporários de upload são removidos pelo ciclo de vida do plugin do host.