0xsline/openchatcut

Verificação

Use o nível de verificação mais baixo que comprove o resultado solicitado:

Nível	Evidência necessária
L0	Verificações estáticas como o script de verificação focado, npx tsc --noEmit, testes e build.
L1	Uma execução real do agente contra o editor em localhost:5199, seguida de evidência estrutural e renderizada.
L2	O aplicativo desktop empacotado completando o cenário do usuário, incluindo revisão visual humana quando a automação for insuficiente.

Alterações no comportamento em tempo de execução exigem L0 + L1. Alterações apenas de lançamento e desktop também exigem L2 quando o aplicativo empacotado é o comportamento sob teste.

Prefira dois sinais:

1. read_project para estrutura: ativos, faixas, itens, posicionamento de quadro, duração da linha do tempo.
2. Um caminho de captura visual para evidência renderizada em quadros exatos.

Use view_timeline_frames para prova da linha do tempo composta. Isso verifica a linha do tempo editada do OpenChatCut: cortes, camadas, legendas, efeitos, marcadores, placeholders, recortes, transições e layout.

Para inspeção de quadros-fonte brutos, escolha o caminho mais barato com base em onde os bytes residem:

• O agente nesta build não tem acesso ao sistema de arquivos local; todos os bytes-fonte vivem no repositório de mídia do projeto (/media/uploads/). Use view_asset_frames com o id do ativo do projeto — o servidor usa um caminho rápido de contato-sheet ffmpeg automaticamente, então já é a rota mais barata para quadros-fonte.
• view_timeline_frames renderiza a linha do tempo composta (a verificação da verdade do editor); view_asset_frames amostra quadros-fonte brutos. Escolha pelo que você está verificando.
• Não há uma ferramenta separada get_contact_sheet nesta build — o contato-sheet é o que view_asset_frames / view_timeline_frames já retornam.

Use artefatos de quadro-fonte locais/remotos apenas para compreensão da fonte, seleção de momento e decisões de corte aproximado, não como saída editada ou prova de linha do tempo.

Para mídia apenas local ou em upload, a prova de linha do tempo composta pode ficar bloqueada até que o ativo tenha bytes disponíveis para o renderizador. A inspeção de quadro-fonte via view_asset_frames ainda funciona enquanto os bytes do ativo estiverem em disco (/media/uploads/).

Se ambos os caminhos de prova visual estiverem bloqueados, peça ao usuário para inspecionar o editor OpenChatCut diretamente e anote o bloqueador explicitamente.

Verificações úteis:

• Após importação: read_project({ "view": "assets", "assetId": "<prefix>" })
• Após mover/cortar: read_project({ "view": "timeline" })
• Após sobreposição visual ou MG em qualquer mídia da linha do tempo: view_timeline_frames({ "frames": [30, 45, 75] }), em seguida examine os quadros retornados.
• Para seleção de fonte ou momento visual solicitada pelo usuário: amostre stills com view_asset_frames e inspecione-os. Use isso apenas para escolher arquivos fonte, momentos e cortes aproximados. Construa a edição visível como itens da linha do tempo do OpenChatCut. Não trate a inspeção de fonte bruta como verificação de linha do tempo ou como permissão para produzir o vídeo editado em outro lugar.
• Para inspeção de quadro-fonte: chame view_asset_frames({"assetId":"...","sourceTimesMs":[...]}) após read_project({"view":"assets"}) confirmar o id/tipo do ativo. Prefira isso a pedir ao usuário para reanexar o arquivo.
• Para verificação visual apenas local: faça upload/registre mídia legível na nuvem antes de confiar em prova visual do conector.
• Para validação sem fonte: confirme que o manifesto da ferramenta expôs os parâmetros que você usou, em seguida registre a prova visível no log de rastreamento.

Ao falar sobre segundos, verifique o fps a partir de read_project ou use ferramentas do adaptador que resolvem fps internamente.

Ao relatar a localização de um item na linha do tempo, use apenas a estrutura mais recente de read_project para alias da faixa, id do item, início, duração e id do ativo. Não reporte faixas planejadas/padrão ou intenção de chamada de ferramenta como posicionamento verificado.

Não trate uma resposta JSON de linha de comando sozinha como suficiente quando o usuário pergunta se o editor reflete o resultado. Use a URL do editor ou prova visual quando prático.

Verificação de transcrição do agente real

Após cada execução de agente L1, inspecione o registro completo do chat antes de relatar sucesso:

1. Leia a resposta final do assistente e cada linha de ferramenta criada pela execução.
2. Expanda linhas com falha ou aviso e registre o erro exato.
3. Verifique turnos abortados, repetições, propostas obsoletas, trabalhos incompletos e resultados de ferramentas que a resposta final descreve incorretamente como bem-sucedidos.
4. Compare o resultado mais recente de read_project com a linha do tempo visível.
5. Para edições visuais, inspecione os quadros da linha do tempo retornados em vez de confiar no resumo do assistente.

Uma execução com uma linha do tempo de aparência correta, mas um erro de ferramenta não relatado, não é uma aprovação limpa. Corrija a causa ou relate o erro restante explicitamente.

Se a verificação falhar, classifique a lacuna antes de mudar de ferramenta:

• a descrição ou esquema da ferramenta era insuficiente
• as instruções da skill estavam faltando uma etapa
• read_project não expôs estado suficiente
• a autorização do editor não foi concluída
• o pipeline de mídia/transcrição falhou
• a renderização em nuvem/observação do editor foi bloqueada